Re: Hurd server manual (first chunk)

[Tom Hart]

Marcus,

Marcus Brinkmann wrote:
> Hi,
>
> I started to document the Hurd server interfaces in the style of a reference
> manual.  The Hurd server interfaces are currently only documented in the
> .defs files, which is a bit short on detail.  I wanted a place where I could
> put all the lengthy explanations and rationale and protocols, and so I made
> one.
>
> This should probably be part of the big Hurd book some day, or the big Hurd
> book will be split into different parts anyway.  Certainly not the time to
> decide, a reference manual with all the Hurd server interfaces is definitely
> self-contained enough to not need to worry about the grand plan too much when
> writing it.
>
> ...

If I could make a suggestion... would you consider putting the text of 
the GPL at the end of the document, and including a reference to that 
section in the Copying section of the introduction. This is what Matt 
Grant and I did for the User's Guide that we're working on, since:
1. It makes it easier to browse the manual as a PDF/PS or 1-page HTML file
2. Most people reading the manual will already know the gist of the GPL, 
so putting it at the end will not lessen the promotion of Free Software

In my experience, doing this makes a manual easier to read.

--
    _______________________________________________
   /                                               |
  /  Tom Hart                                      |
 |   hartte13@BrandonU.ca                          |
  \  "rmTFM - Build consistent interfaces."        |
   \_______________________________________________|