On 6/7/11 6:55 AM, Simon Matter wrote: >> There has been some dissatisfaction expressed with my decision to merge >> manpage documentation into the configuration files by default. So I'm >> releasing 4.4.20.1 that switches the default to not include >> documentation. If you do want the documentation, supply the -a >> (annotate) option to the installer. > > Hi Tom, > > I'd be interested to hear what kind of "dissatisfaction" was expressed to > you? I have welcomed the change because it eliminates most man page > lookups for me. That said, I'm using some kind of diff/patch magic to keep > the configs on my systems up2date. I can understand that otherwise the > docs in the configs would become out of date.
First, it is a departure from my long-standing practice of not changing the default behavior. Second, the issue of the documentation becoming out of date is a real concern. I have plans to eliminate that problem by optionally allowing the existing files to be merged with the latest manpages during upgrade. See Mr Dash Four's post on the development list where he demonstrated a limited such a facility for shorewall.conf. The other issue is just the shear size of the files and the fact that the documentation just gets in the way of experienced users (I, for one, find it a nuisance). So it is still there for those that want it and I plan to improve it. But for now, it will remain optional. I'm beginning to thing about Shorewall 5.0 a bit; that might be a reasonable time to change the default, once all of the machinery is in place to keep the documentation current. -Tom -- Tom Eastep \ When I die, I want to go like my Grandfather who Shoreline, \ died peacefully in his sleep. Not screaming like Washington, USA \ all of the passengers in his car http://shorewall.net \________________________________________________
signature.asc
Description: OpenPGP digital signature
------------------------------------------------------------------------------ EditLive Enterprise is the world's most technically advanced content authoring tool. Experience the power of Track Changes, Inline Image Editing and ensure content is compliant with Accessibility Checking. http://p.sf.net/sfu/ephox-dev2dev
_______________________________________________ Shorewall-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/shorewall-users
