bug-hurd
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: The Hurd Reference Manual - overhaul


From: Alfred M. Szmidt
Subject: Re: The Hurd Reference Manual - overhaul
Date: Sun, 26 Sep 2004 03:12:41 +0200

   GNU manuals have always been intended to serve as both good
   introductions that can be read straight through, and as reference
   manuals.  You don't have to give a manual a meaningless structure
   to make it easy to find things by name.  Good indexes and good
   menus can do that.

Well, the other reason that I didn't tell you is that the current
format is a pita to update and work with.  And just that has
discouragred me several times to even bother with updating the manual
(it is very outdated!).

In short, the current structure sucks for anything usable, and
anything one can work without pulling your hair out.

For the introduction part one can add a nice chapter specially written
as a introduction, which has references to other parts of the manual.


Cheers.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]