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
pgpsyM49Ap9z4.pgp
Description: PGP signature