develooper 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


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About