docs/91192: [PATCH] take static part of pgpkeys out of localised handbooks

[Vitaly Bogdanov]

The following reply was made to PR docs/91192; it has been noted by GNATS.

From: Vitaly Bogdanov <gad at gad.glazov.net>
To: bug-followup at FreeBSD.org, Siebrand Mazeland <s.mazeland at xs4all.nl>
Cc:  
Subject: Re: docs/91192: [PATCH] take static part of pgpkeys out of localised handbooks
Date: Sat, 7 Jan 2006 00:07:12 +0400

 On Mon, Jan 02, 2006, Siebrand Mazeland wrote:
 > 
 > >Description:
 > Currently pgpkeys/chapter.sgml contains a lot of 'static' content that is copied
 > in each and every localised version of the handbook.  As changes are often made
 > to this chapter, keeping up to date for non English translations is a time
 > consuming and uninspirational task.  As the blocks of entities should be exactly
 > the same in every localised version, I suggest to take the static parts out of
 > the handbook and place them in share/.  Thus the pgp keyblocks can be included
 > in the localised versions without having to sacrifice the parts of the chapter
 > that should be translated.  See below for patches and what was changed where.
 > >How-To-Repeat:
 > Check contents of handbook/pgpkeys/chapter.sgml for two languages and observe
 > the overlap:
 > http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/handbook/pgpkeys/chapter.sgml?rev=1.285&content-type=text/x-cvsweb-markup
 > http://www.freebsd.org/cgi/cvsweb.cgi/doc/nl_NL.ISO8859-1/books/handbook/pgpkeys/chapter.sgml?rev=1.10&content-type=text/x-cvsweb-markup
 > >Fix:
 > 1. take the static parts out of chapter.sgml and create 3 seperate files in
 >    /doc/share/pgpkeys/ called pgpkeys-core.sgml, pgpkeys-developers.sgml, and
 >    pgpkeys-officers.sgml
 > 2. create 3 new entities in /doc/share/pgpkeys/pgpkeys.ent pointing to the
 >    newly created files
 > 3. add the entities to the localised version of handbook/pgpkeys/chapter.sgml
 >    (done for en_US.ISO8859-1 in the patch)
 > 4. patch /doc/share/pgpkeys/addkey.sh to conform to the new structure.
 > 
 > .....
 > .....
 
 I read this patch and have no objections.
 
 English and Russian versions of handbook are builded normally with these changes.
 
 Vitaly