From owner-freebsd-doc  Thu Aug 31 18:17:42 1995
Return-Path: doc-owner
Received: (from majordom@localhost)
          by freefall.FreeBSD.org (8.6.11/8.6.6) id SAA04373
          for doc-outgoing; Thu, 31 Aug 1995 18:17:42 -0700
Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34])
          by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id SAA04366
          for <doc@freebsd.org>; Thu, 31 Aug 1995 18:17:40 -0700
Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id UAA20644; Thu, 31 Aug 1995 20:16:55 -0500
Date: Thu, 31 Aug 1995 20:16:49 -0500 (EST)
From: John Fieber <jfieber@indiana.edu>
To: Deborah Bennett <deborah@gallifrey.microunity.com>
cc: doc@freebsd.org
Subject: Re: The FreeBSD Handbook, Chapter 5 (Reconfiguring the Kernel)
In-Reply-To: <9509010033.AA00635@gallifrey>
Message-ID: <Pine.BSF.3.91.950831200946.20618A-100000@fieber-john.campusview.indiana.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: doc-owner@freebsd.org
Precedence: bulk

On Thu, 31 Aug 1995, Deborah Bennett wrote:
> I would like to contribute at least a start to this chapter.
> I am about to review the procedure (which I have done before)
> and write some scripts anyway, and I'm pretty good at documenting
> this kind of stuff, and I've done it before (internal how-to documents
> at Sun when I was there).

Whee!  I'll sign you up!  We have had a couple starts on this document, 
but no followthrough to date.  

> Do you have any sort of template format or suggested format, or should
> I just start writing text files? I can do html or straight text.
> TeXinfo is beyond me. But I would like to help.

The format of choice is SGML using the linuxdoc DTD (well, "of choice" 
may not be appropriate, but that is another story...).

If you are not at all familiar with SGML or linuxdoc, you can:

A: Grab some files from /usr/src/share/doc/handbook and use them as an 
   example.

B: Write the document using plain ascii.

C: Write the document using LaTeX.


(the reason for option C is that the linuxdoc DTD is basically latex with 
<tags> instead of \controlsequences.)

-john

== jfieber@indiana.edu ===========================================
== http://fieber-john.campusview.indiana.edu/~jfieber ============