From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Jürgen Purtz <juergen(at)purtz(dot)de>, pgsql-docs(at)lists(dot)postgresql(dot)org |
Subject: | Re: DocBook 5.2 |
Date: | 2022-09-27 02:25:09 |
Message-ID: | YzJfBb+79/gW0d5y@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Mon, Sep 26, 2022 at 05:42:32PM -0400, Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)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(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com
Indecision is a decision. Inaction is an action. Mark Batterson
From | Date | Subject | |
---|---|---|---|
Next Message | Jürgen Purtz | 2022-09-27 07:12:45 | Re: DocBook 5.2 |
Previous Message | Bruce Momjian | 2022-09-27 01:57:57 | Re: pg_dump: regular expression notation for tables |