pgsql: Improve docs syntax checking

From: Andrew Dunstan <andrew(at)dunslane(dot)net>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Improve docs syntax checking
Date: 2025-10-02 18:28:44
Message-ID: E1v4O2l-0018fZ-34@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Improve docs syntax checking

Move the checks out of the Makefile into a perl script that can be
called from both the Makefile and meson.build. The set of files checked
is simplified, so it is just all the sgml and xsl files found in
docs/src/sgml directory tree.

Along the way make some adjustments to .cirrus.tasks.yml to support this
better in CI.

Also ensure that the checks are part of the Makefile's html target.

Author: Nazir Bilal Yavuz <byavuz81(at)gmail(dot)com>
Co-Author: Andrew Dunstan <andrew(at)dunslane(dot)net>

Discussion: https://postgr.es/m/CAN55FZ3BnM+0twT-ZWL8As9oBEte_b+SBU==cz6Hk8JUCM_5Wg@mail.gmail.com

Branch
------
master

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

Modified Files
--------------
.cirrus.tasks.yml | 3 ++
doc/src/sgml/Makefile | 18 ++-------
doc/src/sgml/meson.build | 23 ++++++++++++
doc/src/sgml/sgml_syntax_check.pl | 77 +++++++++++++++++++++++++++++++++++++++
4 files changed, 106 insertions(+), 15 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Daniel Gustafsson 2025-10-02 21:05:15 pgsql: Remove check for NULL in STRICT function
Previous Message Daniel Gustafsson 2025-10-02 09:54:00 pgsql: doc: Improve wording for base64url definition