Re: Docs: perluniintro

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

• Docs: perluniintro by Felipe Gasper
• Re: Docs: perluniintro by Yuki Kimoto
• Re: Docs: perluniintro by Dan Book
• Re: Docs: perluniintro by James E Keenan