Bug 58376 - Few general (and maybe stupid...) remarks on the documentations present on RedHat Linux
Summary: Few general (and maybe stupid...) remarks on the documentations present on Re...
Alias: None
Product: Red Hat Linux
Classification: Retired
Component: distribution
Version: 7.2
Hardware: i386
OS: Linux
Target Milestone: ---
Assignee: Tammy Fox
QA Contact: Brock Organ
Depends On:
TreeView+ depends on / blocked
Reported: 2002-01-15 14:33 UTC by Need Real Name
Modified: 2007-04-18 16:39 UTC (History)
0 users

Clone Of:
Last Closed: 2002-01-16 16:56:46 UTC

Attachments (Terms of Use)

Description Need Real Name 2002-01-15 14:33:37 UTC
Why not only one format for the HOWTOs? (now ithere are 2 formats: docbook and

 Why should it be either .html, or .docbook or .sgml? for the doc on RH Linux?
 There are many converting  tools so why not furnish all the doc in only one
 format, the richest one and then add a README file explaining how to produce
 other formats (.ps, .pdf, .txt, .html...) from that format.

 linuxdoc allows to specify the format and the size of any "ready to print"
 generated document from a .sgml. They look really good and are easy to read.
 docbook2ps produces documents that are not so "good looking" and it is
 impossible to easily specify the size of the paper (or I have not found the
 Isn't it possible to federate everything, to have one format (.sgml or
 and one very good looking template for everything, to obtain coherent
 documentations (in term of appearance)? That would make things so much
 easier.... So much professional...

 In the same idea, info, html and man pages....
 I like man pages, I don't like info pages.
 man is easy to type and use on a console. info and .html requires too many CTRL
 But this is MY opinion. I know some people have others. I simply go to the
 simplicity, I am lazy and to type man is fast and simple....

 They are many tools able to produce any of these format from a META file (.xml,
 .sgml whatever) but not so many people know who they are, what they are
 to do and how to use them cleverly (and I am one of these people...).
 Couldn't it be possible to have the 3 formats present in every RedHat packages
 and placed where they are supposed to be easily found? That would make
 everybody happy and would put some coherence (I hate to say "Jesus X, where is
 the doc and in which format.!!!!")


Comment 1 Tammy Fox 2002-02-11 15:58:34 UTC
The HOWTOs on the Red Hat Linux Documentation CD are from the Linux Documentation
Project (LDP), a community organization. We just mirror the latest content in
case users want additional documentation. The LDP is in charge of deciding
which formats they accept, and they accept multiple formats. I can't change

We are working to make the man pages and info pages easier to access.

Note You need to log in before you can comment on or make changes to this bug.