httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rodent of Unusual Size <Ken.C...@Golux.Com>
Subject Re: Docs in Perl utils
Date Sun, 10 Feb 2002 21:02:18 GMT
Rich Bowen wrote:
> Just out of curiosity, why would people resist having
> the utilities reasonably documented?

It's not a matter of resisting the documentation, but of
having to wade through a lot of not-meant-for-human-eyes
documentation before getting to the code.  The POD formatting
makes it just enough more difficult to read than regular
comments that I think it would be irritating for people
who want to see The Code.  So put the POD someplace in
the file, but where it won't be in the way.
#ken	P-)}

Ken Coar, Sanagendamgagwedweinini  http://Golux.Com/coar/
Author, developer, opinionist      http://Apache-Server.Com/

"Millennium hand and shrimp!"

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message