develooper Front page | perl.perl5.porters | Postings from September 2018

[perl #133509] IPC::Open2 and IPC::Open3 documentation updates

Thread Previous
Dan Book
September 10, 2018 22:13
[perl #133509] IPC::Open2 and IPC::Open3 documentation updates
Message ID:
# New Ticket Created by  Dan Book 
# Please include the string:  [perl #133509]
# in the subject line of all future correspondence about this issue. 
# <URL: >

[Perl] IPC::Open2 and IPC::Open3 docs contain some out of date practices
and confusing terminology, which makes them more difficult for newcomers to
make use of. Attached will be a patch to update it in several ways:

* Remove direct usage of bareword filehandles and use lexical filehandles
for the first example in each synopsis.
* Add examples using STDIN and STDOUT filehandles, and examples using
already open filehandles, with explicit examples of where these handles
come from.
* Declare variables with 'my' where appropriate and condense declarations
* Add comments in synopsis describing the purpose of each example.
* Consistency of referencing synopsis variables from the description.
* Replace ambiguous phrase 'null string' with 'empty string or undefined'
which is also more correct here.
* Add links to referenced CPAN modules and manpages.
* Better describe the reason for using gensym in IPC::Open3 and how to use


Thread Previous Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About