On Mon, Aug 23, 2010 at 05:37:29PM -0400, David Campbell wrote:
Excerpts from Dave Reisner's message of 2010-08-23 14:59:11 -0400:
*ROUTES (array)*:: A list of routes to be created. For each item in this list, the 'network' service expects to find a variable of the same name to exist providing a string of parameters to be passed to the 'route' command in order to create the route. Routes can prevented from being created by prefixing with a '!' symbol.
For a variable to be found it must exist, so "to exist" is redundant. Fixed on my copy.
The last sentence should read, "Routes can be...", not "Routes can prevented...", or better yet, "Prevent a route from being created by prefixing it with a bang (!).".
Also fixed, and I like your rewording.
I like this manpage, although, I am not so sure it is wise to have a manpage for rc.conf. rc.conf is well commented, and if there is a manpage, the two will have to be kept in sync with each other. Having the code with the documentation also makes understanding the documentation easier. I suggest either adding to the comments in rc.conf if they are not sufficient, or leaving out of the manpage information that can already be found in rc.conf.
My concern is that /etc/rc.conf is mutable, while a man page is not. AIF uses this commenting as guidance, but it (as well as rc.conf itself) could just as easily say "refer to the man page". d