From owner-freebsd-doc@FreeBSD.ORG Fri Sep 12 04:18:18 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 55FA816A4BF; Fri, 12 Sep 2003 04:18:18 -0700 (PDT) Received: from shaft.techsupport.co.uk (shaft.techsupport.co.uk [212.250.77.214]) by mx1.FreeBSD.org (Postfix) with ESMTP id 56C0743FEC; Fri, 12 Sep 2003 04:18:17 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from pc3-cdif2-5-cust222.cdif.cable.ntl.com ([81.101.152.222] helo=shrike.submonkey.net ident=mailnull) by shaft.techsupport.co.uk with esmtp (TLSv1:DHE-RSA-AES256-SHA:256) (Exim 4.22) id 19xlwN-0000b1-Nu; Fri, 12 Sep 2003 12:18:15 +0100 Received: from setantae by shrike.submonkey.net with local (Exim 4.22) id 19xlwL-000JhD-Ex; Fri, 12 Sep 2003 12:18:13 +0100 Date: Fri, 12 Sep 2003 12:18:13 +0100 From: Ceri Davies To: "Simon L. Nielsen" Message-ID: <20030912111813.GA75659@submonkey.net> Mail-Followup-To: Ceri Davies , "Simon L. Nielsen" , Christian Brueffer , freebsd-doc@freebsd.org References: <200309120920.h8C9KGZ8091585@freefall.freebsd.org> <20030912093107.GH635@unixpages.org> <20030912093846.GK76802@submonkey.net> <20030912103331.GA388@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="gKMricLos+KVdGMg" Content-Disposition: inline In-Reply-To: <20030912103331.GA388@FreeBSD.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.4i Sender: Ceri Davies cc: freebsd-doc@freebsd.org 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: Fri, 12 Sep 2003 11:18:18 -0000 --gKMricLos+KVdGMg Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Sep 12, 2003 at 12:33:33PM +0200, Simon L. Nielsen wrote: > On 2003.09.12 10:38:46 +0100, Ceri Davies wrote: > > On Fri, Sep 12, 2003 at 11:31:08AM +0200, Christian Brueffer wrote: > > > On Fri, Sep 12, 2003 at 02:20:16AM -0700, Ceri Davies wrote: > > > > > > > > > This is already covered in the FAQ. I think if anything, a lin= k should > > > > > suffice. > > > > =20 > > > > I agree that it doesn't need to be duplicated in that article (els= e we'd be > > > > pretty much doing it in every article). > > > > =20 > > > > Perhaps we should have a FreeBSD glossary, where all relevant acro= nyms and > > > > terms are explained. This could then be easily included at the en= d of > > > > printed works, etc. I'd be prepared to make a start on it, but I'= d need > > > > help for sure. > > >=20 > > > Good idea, I'd also like to see something like this. I'm not very fa= miliar > > > with the docbook infrastructure, what would be the best way to implem= ent it? > >=20 > > I'm not sure yet. Doubtless there is already a method for doing it, but > > I'll need to check what the relevant elements, etc. are when I get home. >=20 > I also think this is a good idea. >=20 > As for doing it, I would look at how the bookinfo.legalnotice entity is > defined. Basically : >=20 > The file doc/en_US.ISO8859-1/share/sgml/bookinfo.ent contains : >=20 > >=20 > And then doc/en_US.ISO8859-1/share/sgml/legalnotice.sgml is the actual > text which is just included using "&bookinfo.legalnotice;". >=20 > I think it would be fairly simple to do something like this for a > glossary. Yeah, those are the lines I was thinking along. My reference to "relevant elements" was that there are very likely elements or similar already, which we can make use of. Ceri --=20 User: DO YOU ACCEPT JESUS CHRIST AS YOUR PERSONAL LORD AND SAVIOR? Iniaes: Sure, I can accept all forms of payment. -- www.chatterboxchallenge.com --gKMricLos+KVdGMg Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/Yat1ocfcwTS3JF8RAva5AJ46noLUDY668idH75wiBl/ri1ZxKwCeILa1 4JZ0fTWFRKa276+teQO/uss= =3h6+ -----END PGP SIGNATURE----- --gKMricLos+KVdGMg--