[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 11:39:15 +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.