From: Christoph Berg <myon@debian.org>
To: Peter Eisentraut <peter@eisentraut.org>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Andres Freund <andres@anarazel.de>
Cc: pgsql-hackers@lists.postgresql.org, Andrew Dunstan <andrew@dunslane.net>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: pgsql-hackers <pgsql-hackers@postgresql.org>
Subject: Re: meson documentation build open issues
Date: Wed, 8 Nov 2023 13:55:02 +0100
Message-ID: <ZUuFJoJ9dOgVcxfl@msg.df7cb.de> (raw)
In-Reply-To: <d5c8cb60-b4b5-4364-9aa1-cacc11b3aa05@eisentraut.org>
References: <202311071640.leoc3qgmfvmx@alvherre.pgsql>
<d5c8cb60-b4b5-4364-9aa1-cacc11b3aa05@eisentraut.org>
Re: Peter Eisentraut
> > If the problem is broken doc patches, then maybe a solution is to
> > include the `xmllint --noout --valid` target in whatever the check-world
> > equivalent is for meson. Looking at doc/src/sgml/meson.build, we don't
> > seem to do that anywhere. Doing the no-output lint run is very fast
> > (375ms real time in my machine, whereas "make html" takes 27s).
>
> This would be a start, but it wouldn't cover everything. Lately, we require
> id attributes on certain elements, which is checked on the XSLT level.
I'd think there should be a catchy "make check-world"-equivalent that
does run all reasonable check that we can tell people to run by
default. Then if that takes too long, we could still offer
alternatives that exclude some areas. If it's the other way round,
some areas will never be checked widely.
Christoph
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-hackers@postgresql.org
Cc: myon@debian.org, peter@eisentraut.org, alvherre@alvh.no-ip.org, andres@anarazel.de, andrew@dunslane.net, tgl@sss.pgh.pa.us
Subject: Re: meson documentation build open issues
In-Reply-To: <ZUuFJoJ9dOgVcxfl@msg.df7cb.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