Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 58381

Summary: Several man pages missing
Product: [Retired] Red Hat Linux Reporter: Harri Haataja <harri.haataja>
Component: initscriptsAssignee: Bill Nottingham <notting>
Status: CLOSED DUPLICATE QA Contact: Ben Levenson <benl>
Severity: medium Docs Contact:
Priority: low    
Version: 7.2CC: rvokal, teg
Target Milestone: ---Keywords: FutureFeature
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2005-09-29 19:32:17 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Man pages for files in /etc/sysconfig none

Description Harri Haataja 2002-01-15 15:20:12 UTC 
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):
All?

How Reproducible:
100% =)

Steps to Reproduce:
1. man -k static-routes
2. man networks
3. 

Actual Results:
static-routes: nothing appropriate
No manual entry for networks


Expected Results:
Informative manuals for vital configuration files.

Additional Information:
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.
Comment 1 Trond Eivind Glomsrxd 2002-01-15 17:05:06 UTC 
These files are documented in the initscripts doc directory, there are no man pages.
Comment 2 Scott R. Godin 2003-05-01 21:22:01 UTC 
confirming this as *still missing in RH 8.0*
Comment 3 F. William Lynch 2003-12-01 20:02:35 UTC 
Created attachment 96263 [details]
Man pages for files in /etc/sysconfig
Comment 4 Bill Nottingham 2003-12-01 20:05:33 UTC 
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.
Comment 5 Bill Nottingham 2005-09-29 19:32:17 UTC 

*** This bug has been marked as a duplicate of 14076 ***
Comment 6 Bill Nottingham 2005-09-29 19:32:35 UTC 

*** This bug has been marked as a duplicate of 147076 ***