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

Re: [RFC] Document DirHandle as obsolete?

Thread Previous
From:
Sawyer X
Date:
September 9, 2016 20:01
Subject:
Re: [RFC] Document DirHandle as obsolete?
Message ID:
62518c04-36a1-3602-44af-94e896cd9037@gmail.com


On 09/07/2016 10:22 PM, Aristotle Pagaltzis wrote:
> As per attached patch. This one goes back a long time.

1. You're giving an example saying to read the docs.
2. You're giving the explanation, then an alternative synopsis.

I would rather have the alternative synopsis first with a line of
comment above, such as "# This is the recommended way now". Then
underneath have the explanation, and then the old synopsis.

Otherwise, +1.

Thread Previous


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