[Top][All Lists]

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

Re: Hurd server manual (first chunk)

From: Tom Hart
Subject: Re: Hurd server manual (first chunk)
Date: Mon, 18 Nov 2002 14:32:12 -0600
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.0.0) Gecko/20020623 Debian/1.0.0-0.woody.1


Marcus Brinkmann wrote:

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

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."        |

reply via email to

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