agora inbox for pgsql-docs@postgresql.org  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Jürgen Purtz <juergen@purtz.de>
Cc: pgsql-docs@lists.postgresql.org, Alexander Law <exclusion@gmail.com>
Subject: Re: DocBook 5.2
Date: Thu, 05 Sep 2024 16:01:05 -0400
Message-ID: <2019879.1725566465@sss.pgh.pa.us> (raw)
In-Reply-To: <79ff1cda-df66-456a-a125-c2a6ed3ba356@purtz.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>

=?UTF-8?Q?J=C3=BCrgen_Purtz?= <juergen@purtz.de> writes:
> [ conversion to DocBook 5.2 ]

I took another look at this issue, and found that no Red Hat distro is
yet shipping DocBook 5.2; not even Fedora 40 which is bleeding edge.
So I would have to obtain and manually install the relevant DTDs
and style sheets, as would a lot of other contributors.  I'm less
familiar with the Debian ecosystem but AFAICT they are shipping
even older docbook packages than Red Hat.

In short, making this conversion now would destroy most contributors'
ability to build the docs at all.  Not to mention packagers, who
generally don't have the option to use stuff not yet blessed by their
distro.  Since we've lately been encouraging packagers to build the
docs for themselves, that part is likely to be a pain point long
after it stops being one for average contributors.

I don't see how we can migrate to 5.2 until it becomes a lot more
widespread in standard distros.

			regards, tom lane





view thread (19+ messages)  latest in thread

Message-ID: <2019879.1725566465@sss.pgh.pa.us>
Permalink:  ../2019879.1725566465@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/2019879.1725566465@sss.pgh.pa.us

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: tgl@sss.pgh.pa.us, juergen@purtz.de, exclusion@gmail.com
  Subject: Re: DocBook 5.2
  In-Reply-To: <2019879.1725566465@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox