pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Peter Eisentraut <peter@eisentraut.org>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Run xmllint validation only once
Date: Wed, 14 Sep 2022 16:15:03 +0000
Message-ID: <E1oYV2V-000KTP-5V@gemulon.postgresql.org> (raw)

Run xmllint validation only once

Before, each documentation target that built something from
postgres.sgml ran xmllint first to validate the input.  Here, we
change it so that the validation only runs once and produces an output
file, and all the other targets build from that output file.  This
avoids redundant work when building multiple documentation targets
(such as html and man).

Also, when we run xmllint, we can resolve entities (included files).
This helps with tools that don't support vpath builds, such as
dbtoepub.

All this also organizes the make targets a bit better for implementing
equivalent steps in meson.

Discussion: https://www.postgresql.org/message-id/e3ae16de-c9f9-f559-2d11-70b1342ae3d1@enterprisedb.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/ab393528fa4b2486237ee7aa51fac67f82fee824

Modified Files
--------------
doc/src/sgml/Makefile               | 46 +++++++++++++++++++++----------------
doc/src/sgml/standalone-install.xml |  8 +++----
2 files changed, 30 insertions(+), 24 deletions(-)



Message-ID: <E1oYV2V-000KTP-5V@gemulon.postgresql.org>
Permalink:  ../E1oYV2V-000KTP-5V@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1oYV2V-000KTP-5V@gemulon.postgresql.org

 · 

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 from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  To: pgsql-committers@postgresql.org
  Cc: peter@eisentraut.org
  Subject: Re: pgsql: Run xmllint validation only once
  In-Reply-To: <E1oYV2V-000KTP-5V@gemulon.postgresql.org>
  References: <E1oYV2V-000KTP-5V@gemulon.postgresql.org>

* 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