Feedback-ID: ie0a040ee:Fastmail
Message-ID: <e537eb95-752e-4e23-bf07-598a2858b85a@eisentraut.org>
Date: Wed, 11 Sep 2024 11:47:58 +0200
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: DocBook 5.2
To: =?UTF-8?Q?J=C3=BCrgen_Purtz?= <juergen@purtz.de>,
 Pg Docs <pgsql-docs@lists.postgresql.org>
Cc: Thomas Schraitle <tom_schr@web.de>
References: <ae14eca5-f57c-2db2-42ce-258bab3c6806@purtz.de>
 <20220905111508.wzgmpbcarxizdnin@alvherre.pgsql>
 <YzIY/OCgljTdqOgX@momjian.us> <3524032.1664228552@sss.pgh.pa.us>
 <YzJfBb+79/gW0d5y@momjian.us> <3d846208-ff49-5a23-1684-a2e00a14496b@purtz.de>
 <88e50ac0-4097-42cb-a04c-ff91270b263a@purtz.de>
 <79ff1cda-df66-456a-a125-c2a6ed3ba356@purtz.de>
 <2019879.1725566465@sss.pgh.pa.us>
 <2595a346-1dc3-486a-8eab-04be064fe9c0@purtz.de>
Content-Language: en-US
From: Peter Eisentraut <peter@eisentraut.org>
In-Reply-To: <2595a346-1dc3-486a-8eab-04be064fe9c0@purtz.de>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Archived-At: 
 <https://www.postgresql.org/message-id/e537eb95-752e-4e23-bf07-598a2858b85a%40eisentraut.org>
Precedence: bulk

On 06.09.24 10:50, Jürgen Purtz wrote:
> For the PG community I would like to raise the question: Do we need 
> DocBook in the distro of any operating system? In the past we developed 
> some stylesheets to adopt DocBook to our needs. They are part of PG's 
> distro and refer to the standard with statements like <xsl:import 
> href="http://docbook.sourceforge.net/release/xsl/current/xxxx/docbook.xsl"/>. With the migration to db5.x the links change to <xsl:import href="http://cdn.docbook.org/release/xsl/1.79.2/xxxx/docbook.xsl"/>. Hence we don't need any additional local stylesheet outside of our own distro. Concerning DTD/schema/relax-ng: In db5.2 there is no DTD nor a XML-schema, for validation we need only the Relax-NG file 'docbook.rng'. This file is available at https://docs.oasis-open.org/docbook/docbook/v5.2/os/rng/docbook.rng (during the conversion-process I used a local copy).
> 
> I assume we don't need any operating system distro of DocBook. Please 
> correct me, if I'm wrong.

Note that we run xsltproc with the --nonet option.  So stylesheet and 
schema need to be available as local files.  Downloading these 
on-the-fly during the build process has been found to be unreliable, and 
it's also not sound software supply chain hygiene.