On 2001.02.02 14:29:40 +0400 guran wrote:
> Prana wrote:
>
> I am sorry if I have walked on someone's toes that was not my intention.
> When teaching, I knew that I used my personality to try to bring
> knowledge and that the pupils did not have to like my style, that's
> life.
>
> What I felt about my daughters questions that I found correct was, the
> lack of a consistent way of presenting all that documentation. What she
> was nagging about and quite frankly laughed at was four different styles
> html, man, info and text style in /usr/share/doc.
You are confusing format and access method here...
maybe a bit of simplification :
man pages are the traditional unix documentation style, it uses troff as
format
info pages are the GNU documentation style, it uses info format (not sure
about this one)
files in /usr/share/doc is package-based distribution style, either in text
or html format
You could as well add HOWTO to this list, under a variety of format, and
KDE and Gnome application specific documentations.
Windows, for its part have also several kinds of doc:
DOS help (try command /?)
Readme.txt everywhere on the system (in wondows dir, in applictation dirs,
etc)
Windows applications help, in windows help system format.
What appears as uniformity here is rather poverty, as lots of things are
either undocumented, hard to find (spred everywhere on the disk), or under
into proprietary format.
If you want the same under linux, just forget everything but KDE/Gnome help
system.
--
Any system which depends upon human reliability is unreliable
-- SNAFU Equations (JB's Scholastic Laws) n°2
