Date: Fri, 12 Sep 2003 12:18:13 +0100 From: Ceri Davies <setantae@submonkey.net> To: "Simon L. Nielsen" <simon@FreeBSD.org> Cc: freebsd-doc@freebsd.org Subject: Re: docs/56729: [patch] artciles/pr-guidelines: explain meaning of MFC Message-ID: <20030912111813.GA75659@submonkey.net> In-Reply-To: <20030912103331.GA388@FreeBSD.org> References: <200309120920.h8C9KGZ8091585@freefall.freebsd.org> <20030912093107.GH635@unixpages.org> <20030912093846.GK76802@submonkey.net> <20030912103331.GA388@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--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
> <!ENTITY bookinfo.legalnotice SYSTEM "legalnotice.sgml">
>=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 <glossar=
y>
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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030912111813.GA75659>