From owner-freebsd-doc@FreeBSD.ORG Wed Sep 17 17:00:20 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DC88D16A4B3; Wed, 17 Sep 2003 17:00:20 -0700 (PDT) Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7AB9443F85; Wed, 17 Sep 2003 17:00:18 -0700 (PDT) (envelope-from vincent@sumuk.de) Received: from Moses.earth.sol (Moses.earth.sol [192.168.1.1]) by Kain.sumuk.de (8.12.8p1/8.12.8) with ESMTP id h8I00HHm030868; Thu, 18 Sep 2003 02:00:17 +0200 (CEST) (envelope-from vincent@sumuk.de) Received: from Moses.earth.sol (localhost.earth.sol [127.0.0.1]) by Moses.earth.sol (8.12.5/8.12.5) with ESMTP id h8I00GPg045301; Thu, 18 Sep 2003 02:00:16 +0200 (CEST) (envelope-from vincent@Moses.earth.sol) Received: (from vincent@localhost) by Moses.earth.sol (8.12.5/8.12.5/Submit) id h8I00ETe045300; Thu, 18 Sep 2003 02:00:14 +0200 (CEST) Date: Thu, 18 Sep 2003 02:00:14 +0200 From: Martin Heinen To: Ceri Davies , doc@FreeBSD.org Message-ID: <20030918020013.A44901@sumuk.de> References: <200309120920.h8C9KGZ8091585@freefall.freebsd.org> <20030912093107.GH635@unixpages.org> <20030912093846.GK76802@submonkey.net> <20030912103331.GA388@FreeBSD.org> <20030912111813.GA75659@submonkey.net> <20030912141126.GC1068@daemon.li> <20030917220923.GA7765@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20030917220923.GA7765@submonkey.net>; from ceri@freebsd.org on Wed, Sep 17, 2003 at 11:09:24PM +0100 Subject: Re: docs/56729: [patch] artciles/pr-guidelines: explain meaning of MFC X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 18 Sep 2003 00:00:21 -0000 On Wed, Sep 17, 2003 at 11:09:24PM +0100, Ceri Davies wrote: > I have started out with only including FreeBSD specific terms in the > freebsd-glossary.sgml. There's no reason why we couldn't then have another > file containing generic computing terms (but personally, I'm not sure that > is necessary), although the build would need to be tweaked a bit. > > I've also included a change to the handbook build that will allow you to > build in the glossary by running "make GLOSSARY=yes", but which is off by > default. > > Note that there are not many entries at the moment; once this is committed > then people can feel free to add stuff to it - I've chosen the current entries > to illustrate the docbook way of GlossSeeAlso, GlossSee, etc, elements. > > Any thoughts? Cool. > Index: doc/en_US.ISO8859-1/books/handbook/book.sgml > =================================================================== > RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/book.sgml,v > retrieving revision 1.141 > diff -u -r1.141 book.sgml > --- doc/en_US.ISO8859-1/books/handbook/book.sgml 5 Sep 2003 21:30:20 -0000 1.141 > +++ doc/en_US.ISO8859-1/books/handbook/book.sgml 17 Sep 2003 21:28:01 -0000 > @@ -54,6 +54,7 @@ > > > > + > > %pgpkeys; > ]> > @@ -236,6 +237,7 @@ > > > > + > &chap.colophon; > Most books put the index after the glossary. Also, we could move the index out of the appendices and end up with something like the following: > > > > > &chap.colophon; > -- Marxpitn