docs/56729: [patch] artciles/pr-guidelines: explain meaning of MFC

[Ceri Davies]

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 link should
> > > >  >  suffice.
> > > >  
> > > >  I agree that it doesn't need to be duplicated in that article (else we'd be
> > > >  pretty much doing it in every article).
> > > >  
> > > >  Perhaps we should have a FreeBSD glossary, where all relevant acronyms and
> > > >  terms are explained.  This could then be easily included at the end of
> > > >  printed works, etc.  I'd be prepared to make a start on it, but I'd need
> > > >  help for sure.
> > > 
> > > Good idea, I'd also like to see something like this.  I'm not very familiar
> > > with the docbook infrastructure, what would be the best way to implement it?
> > 
> > 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.
> 
> I also think this is a good idea.
> 
> As for doing it, I would look at how the bookinfo.legalnotice entity is
> defined.  Basically :
> 
> The file doc/en_US.ISO8859-1/share/sgml/bookinfo.ent contains :
> 
> <!ENTITY bookinfo.legalnotice SYSTEM "legalnotice.sgml">
> 
> And then doc/en_US.ISO8859-1/share/sgml/legalnotice.sgml is the actual
> text which is just included using "&bookinfo.legalnotice;".
> 
> 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 <glossary>
elements or similar already, which we can make use of.

Ceri
-- 
User: DO YOU ACCEPT JESUS CHRIST AS YOUR PERSONAL LORD AND SAVIOR?
Iniaes: Sure, I can accept all forms of payment.
                                           -- www.chatterboxchallenge.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030912/af90cd93/attachment.sig>