Red Hat Bugzilla – Bug 58381
Several man pages missing
Last modified: 2014-03-16 22:25:03 EDT
Description of Problem:
Man pages for files like static-routes and other sysconfig files are missing.
All configuration files should be explained somewhere in a normal place.
Man pages are the normal place and this is one of the reasons "Linux" and RHL in
particular are ridiculed. (Mostly by the proud BSD people =)
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. man -k static-routes
2. man networks
static-routes: nothing appropriate
No manual entry for networks
Informative manuals for vital configuration files.
Having gui tools that no-one uses is not an excuse. =)
I can figure these out by reading the scripts but I view this as a flaw anyway.
These files are documented in the initscripts doc directory, there are no man pages.
confirming this as *still missing in RH 8.0*
Created attachment 96263 [details]
Man pages for files in /etc/sysconfig
Sorry about not responding earlier to the mail...
One thing that could be useful here is to generate docs as xml and
then genreate man pages from that. Not sure how much extra work that
would be, but it would then allow autogeneration of both manpages and
the sysconfig.txt meta document.
*** This bug has been marked as a duplicate of 14076 ***
*** This bug has been marked as a duplicate of 147076 ***