From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Jürgen Purtz <juergen@purtz.de>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: DocBook 5.2
Date: Mon, 26 Sep 2022 22:25:09 -0400
Message-ID: <YzJfBb+79/gW0d5y@momjian.us> (raw)
In-Reply-To: <3524032.1664228552@sss.pgh.pa.us>
References: <ae14eca5-f57c-2db2-42ce-258bab3c6806@purtz.de>
<20220905111508.wzgmpbcarxizdnin@alvherre.pgsql>
<YzIY/OCgljTdqOgX@momjian.us>
<3524032.1664228552@sss.pgh.pa.us>
On Mon, Sep 26, 2022 at 05:42:32PM -0400, Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > On Mon, Sep 5, 2022 at 01:15:08PM +0200, Álvaro Herrera wrote:
> >> OK, these seem quite significant changes that are likely to cause great
> >> pain. So I repeat my question, what are the benefits of making this
> >> change? They better be very very substantial.
>
> > Would we be converting docs for all supported versions of Postgres to
> > use DocBook 5.2, or just the most current version? If the later, we
> > would find backpatching a pain for five years.
>
> Yeah, I think we'd have to convert all the supported versions to
> make this palatable. If the conversion is sufficiently automated,
> that might not be a big lift. (If it's *not* automated, I think
> the change would never get off the ground even for HEAD, because
> the docs are too much of a moving target.)
+1
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com
Indecision is a decision. Inaction is an action. Mark Batterson
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: bruce@momjian.us, tgl@sss.pgh.pa.us, alvherre@alvh.no-ip.org, juergen@purtz.de, pgsql-docs@lists.postgresql.org
Subject: Re: DocBook 5.2
In-Reply-To: <YzJfBb+79/gW0d5y@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox