Date: Fri, 6 Jan 2006 20:10:07 GMT From: Vitaly Bogdanov <gad@gad.glazov.net> To: freebsd-doc@FreeBSD.org Subject: Re: docs/91192: [PATCH] take static part of pgpkeys out of localised handbooks Message-ID: <200601062010.k06KA7cA016609@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/91192; it has been noted by GNATS. From: Vitaly Bogdanov <gad@gad.glazov.net> To: bug-followup@FreeBSD.org, Siebrand Mazeland <s.mazeland@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200601062010.k06KA7cA016609>