From: Jürgen Purtz <juergen@purtz.de>
To: pgsql-docs@lists.postgresql.org
Subject: Re: DocBook 5.2
Date: Tue, 27 Sep 2022 09:12:45 +0200
Message-ID: <3d846208-ff49-5a23-1684-a2e00a14496b@purtz.de> (raw)
In-Reply-To: <YzJfBb+79/gW0d5y@momjian.us>
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>
>> 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
The process is totally automated. There are general steps which work for
every DocBook 4.x book. And there are Postgres-specific steps
(doRealModifictions.sh) which looks for individual patterns per file.
This is the critical part. Currently it's tested only with HEAD. My
expectation is, that it should work also for translations to other
languages because the patterns contain only elements and attributes, no
text. But if they run against older versions it's likely that we need
some changes or additional patterns. I'm willing to work on this if a)
there is a consensus in the community that the work should go on and b)
someone helps me to resolve the reported unacceptable runtime problem
during PDF generation.
--
J. Purtz
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: juergen@purtz.de, pgsql-docs@lists.postgresql.org
Subject: Re: DocBook 5.2
In-Reply-To: <3d846208-ff49-5a23-1684-a2e00a14496b@purtz.de>
* 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