From: | Peter Eisentraut <peter(at)eisentraut(dot)org> |
---|---|
To: | Christoph Berg <myon(at)debian(dot)org>, Andres Freund <andres(at)anarazel(dot)de>, 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-07 15:55:37 |
Message-ID: | 848dbc9a-7c6d-4f93-87d9-2069ebe3f222@eisentraut.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On 03.11.23 19:19, Christoph Berg wrote:
>>>> You can control this with the "docs" option for meson, as of recently.
>>> I've been looking into switching the Debian PG 17 build to meson, but
>>> I'm running into several problems.
>>>
>>> * The docs are still not built by default, and -Ddocs=enabled doesn't
>>> change that
>> Maybe I am missing something - they aren't built by default in autoconf
>> either?
> True, but the documentation (and this thread) reads like it should. Or
> at least it should, when I explicitly say -Ddocs=enabled.
>
> What would also help is when the tail of the meson output had a list
> of features that are enabled. There's the list of "External libraries"
> which is quite helpful at figuring out what's still missing, but
> perhaps this could be extended:
>
> Features
> LLVM : YES (/usr/bin/llvm-config-16)
> DOCS : YES (html pdf texinfo)
>
> Atm it's hidden in the long initial blurb of "Checking for.." and the
> "NO" in there don't really stand out as much, since some of them are
> normal.
I don't feel like we have fully worked out how the docs options should
fit together.
With the make build system, there is a canonical sequence of
make world
make check-world
make install-world
that encompasses everything.
Now with meson to handle the documentation one needs to remember a
variety of additional targets. (There is a risk that once this gets
more widespread, more people will submit broken documentation.)
I would like to have some set of options that enables it so that the
standard documentation targets become part of "meson compile" and "meson
install".
From | Date | Subject | |
---|---|---|---|
Next Message | Andres Freund | 2023-11-07 16:08:29 | Re: meson documentation build open issues |
Previous Message | Alvaro Herrera | 2023-11-07 15:46:53 | Re: Compiler warning on Debian 12, PostgreSQL 16 Beta3 |