Front page | perl.perl5.porters |
Postings from May 2021
Re: Docs: perluniintro
Thread Previous
From:
James E Keenan
Date:
May 31, 2021 13:47
Subject:
Re: Docs: perluniintro
Message ID:
e8cc4972-b8e3-cfd4-1412-4c68ad3609cf@pobox.com
On 5/31/21 8:56 AM, Felipe Gasper wrote:
> Hi all,
>
> I read over this doc the other day and would like to propose updating it in three significant ways:
>
> 1) MISINFORMATION: It misinforms (?!?) re outputting, saying that Perl outputs the internal raw bytes. This is *not* the case in any configuration I’ve found; upgraded strings are output as downgraded as long as the string content is all 0-255.
>
> 2) HISTORY: It’s got a lot of historical stuff re Perl 5.6 and 5.8. I’d like to redact all of this in favour of a parenthetical that just refers to older versions of the document for folks interested in such old perls.
>
> 3) NOMENCLATURE: I’d like to standardize on the terms “downgraded” and “upgraded” more generally as less confusion-prone ways to indicate the PV’s internal UTF8-ness.
>
[snip]
I would suggest that you approach this as a *series* of patches or pull
requests. I recommend starting with a patch for your item #2, HISTORY,
as it will be easier for readers who (like me) have never fully grokked
unicode, bytes-vs-characters, etc.
Thank you very much.
Jim Keenan
Thread Previous