develooper Front page | perl.perl5.porters | Postings from February 2013

Don't patch perlopentut: rewrite it completely

Thread Previous | Thread Next
Karen Etheridge
February 17, 2013 02:40
Don't patch perlopentut: rewrite it completely
Message ID:

> Nearly every one of those is non-simple. That is not a tutorial, and it is not
> just about open.  It is more like "FMTEYEWTK About open() and I/O in Perl". If
> the goal is to create a document that teaches people how to use open() for the
> simple cases, then there is no hope for perlopentut.  It cannot be turned into
> that, because that is not what it is.  You have to start over.


> Because perlopentut is more ETC than TUT, I suggest that the original 
> perlopentut be renamed to perlopenetc --and something else be written 
> from scratch to take its place.

Why not simply 'perlopen'?  There's ample precedence for 'perlfootut',
'perlfoo' documents.

perldoc -f open should be much shorter and simply summarize the various
arguments, and reference the other two, longer, documents.

Karen Etheridge

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