This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Rework PerlIO documentation
authorDan Book <grinnz@grinnz.com>
Wed, 11 Mar 2020 00:31:27 +0000 (20:31 -0400)
committerNicolas R <nicolas@atoomic.org>
Thu, 12 Mar 2020 23:39:56 +0000 (17:39 -0600)
commit57fb4502d8032d9a870b52b241e19dc65af57776
tree8f3b02acd649c4fc40b440ee04daf4448c5b60b1
parent6311900a664b5de7fc4b60c1935639bb1d0af7a8
Rework PerlIO documentation

- Add Layers section in the description, giving details of how layers work and encompassing the list of built-in layers
- Add various information relevant to modern usage of each layer
- Consistently refer to layers with a leading colon
- Redo :utf8 and :bytes layer descriptions
- Remove references to using the :utf8 layer for UTF-8 translation
- Add :scalar layer
- Move description of default layers that was oddly in "Querying" section to the end of "Defaults" section
- Correct default layers to specify that PERLIO=:stdio will always result in default layers of :stdio
- Update all examples to be strict-safe and check for open/binmode failure
- Capitalize references to Perl consistently
lib/PerlIO.pm