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

Don't patch perlopentut: rewrite it completely

Thread Previous | Thread Next
From:
Karen Etheridge
Date:
February 17, 2013 02:40
Subject:
Don't patch perlopentut: rewrite it completely
Message ID:
20130217015604.GA17951@tequila.etheridge.ca

> 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.

+1

> 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
ether@cpan.org

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