On Wednesday 22 March 2006 09:04, Paul Traina wrote:
> Shorewall is another example,
> the documentation is in the configuration files.  The average shorewall
> configuration file has 0 lines of active commands in it (grin) but has
> at least 150 lines of comments.

It is more correct to say that "The Shorewall configuration files contain 
documentation" -- your wording suggests that *the only* Shorewall 
documentation is in the config files which couldn't be further from the 
truth. The 3.0.5 bz2-compressed archive containing the complete Shorewall 
documentation in HTML format is 3.3MB. 

I would love to remove the documentation from the configuration files since it 
is a PITA to maintain but when I've suggested that idea in the past, the 
moans and cries have been absolutely pitiful to hear :-)

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ [EMAIL PROTECTED]
PGP Public Key   \ https://lists.shorewall.net/teastep.pgp.key

Attachment: pgpsyM49Ap9z4.pgp
Description: PGP signature

Reply via email to