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: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message