Re: meson documentation build open issues

From: Christoph Berg <myon(at)debian(dot)org>
To: Peter Eisentraut <peter(at)eisentraut(dot)org>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Andres Freund <andres(at)anarazel(dot)de>, pgsql-hackers(at)lists(dot)postgresql(dot)org, Andrew Dunstan <andrew(at)dunslane(dot)net>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: meson documentation build open issues
Date: 2023-11-08 12:55:02
Message-ID: ZUuFJoJ9dOgVcxfl@msg.df7cb.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tomas Vondra 2023-11-08 12:59:55 Re: Syncrep and improving latency due to WAL throttling
Previous Message Euler Taveira 2023-11-08 12:50:47 Re: speed up a logical replica setup