develooper Front page | perl.perl5.porters | Postings from March 2019

[perl #133934] perlipc modernization

Thread Previous | Thread Next
From:
Dan Book
Date:
March 15, 2019 02:39
Subject:
[perl #133934] perlipc modernization
Message ID:
rt-4.0.24-15833-1552617564-1692.133934-75-0@perl.org
# New Ticket Created by  Dan Book 
# Please include the string:  [perl #133934]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org/Ticket/Display.html?id=133934 >


Currently I am very unlikely to direct anyone to the otherwise very useful
perlipc for documentation, as it almost entirely uses bareword filehandles
and the two-argument form of open. Two patches will be attached.

The first corrects this by replacing bareword filehandles with lexicals,
and using three-arg open where possible, and slightly reorganizes the
explanation of forking and Unix platforms (forking is a property of using
three-arg pipe open which works fine back to 5.6, not the list form which
requires 5.8). Also the explanation of lexical filehandles is removed since
they are used all over perldocs now and there's nothing special about them
here.

The second patch is a more general cleanup of consistency, as currently the
examples are very inconsistent in strict safety and variable declaration.
The patch makes all the examples strict safe, the "full script" examples
consistently use strict and warnings, removes unnecessary forward
declaration of variables (this practice leads to bugs), links to the core
modules IPC::Open2/3 and Socket as they're mentioned, removed -w from
shebangs (replaced by use warnings, due to the problems described by
warnings.pm), and includes a waitpid line at the end of the IPC::Open2
example since it's required for proper usage of the module. Also one
cleanup of a sentence fragment that's apparently been there since 1997! (
https://perl5.git.perl.org/perl.git/commitdiff/7b05b7e32c22894360c5332cd30232bdea49f5a8
)

I hope that at least the first patch can be applied, if the second is not
agreeable.

-Dan

(Perl)


Thread Previous | Thread Next


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