From owner-freebsd-doc@FreeBSD.ORG Fri Jan 6 20:10:08 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1ACD716A41F for ; Fri, 6 Jan 2006 20:10:08 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 852C743D46 for ; Fri, 6 Jan 2006 20:10:07 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k06KA7G5016610 for ; Fri, 6 Jan 2006 20:10:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k06KA7cA016609; Fri, 6 Jan 2006 20:10:07 GMT (envelope-from gnats) Date: Fri, 6 Jan 2006 20:10:07 GMT Message-Id: <200601062010.k06KA7cA016609@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Vitaly Bogdanov Cc: Subject: Re: docs/91192: [PATCH] take static part of pgpkeys out of localised handbooks X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Vitaly Bogdanov List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 06 Jan 2006 20:10:08 -0000 The following reply was made to PR docs/91192; it has been noted by GNATS. From: Vitaly Bogdanov To: bug-followup@FreeBSD.org, Siebrand Mazeland 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