This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
IPC::Open2 and IPC::Open3 documentation updates
authorDan Book <grinnz@grinnz.com>
Wed, 18 Dec 2019 21:35:01 +0000 (16:35 -0500)
committerKarl Williamson <khw@cpan.org>
Fri, 13 Mar 2020 17:06:08 +0000 (11:06 -0600)
commitef395fac90bd16d1d2813616a67dec27ea659678
tree942f637bd99dc2e70a326a82c6efdc3a4e73d015
parent043ae7481cd3d05b453e0830b34573b7eef2aade
IPC::Open2 and IPC::Open3 documentation updates

* 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 inline.
* 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 it.
ext/IPC-Open3/lib/IPC/Open2.pm
ext/IPC-Open3/lib/IPC/Open3.pm
t/porting/known_pod_issues.dat