develooper Front page | perl.perl5.porters | Postings from December 2004

Re: perlpodtut

Thread Previous | Thread Next
From:
Michael G Schwern
Date:
December 25, 2004 12:17
Subject:
Re: perlpodtut
Message ID:
20041225201732.GA5837@windhund.schwern.org
On Fri, Dec 24, 2004 at 01:23:59PM -0800, Russ Allbery wrote:
> > Most importantly, I think it's worth to note that the ordering of
> > sections doesn't matter as long as NAME's the first. I think discussing
> > this can be a waste of time.
> 
> This is probably true; I don't think you need to go into an extended
> discussion of it.  But it would be nice for the order in Perl's own
> documentation to match the recommended order in pod2man, one way or the
> other.

If I had to make a choice I'd say pod2man should change to reflect current 
practise.  But I don't think the ordering of those last few sections is 
terribly important.


-- 
Michael G Schwern     schwern@pobox.com     http://www.pobox.com/~schwern/
You're smoother than a tunnel of shining sorrow.

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