Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qyv7o-00C3Bp-DI for pgsql-hackers@arkaria.postgresql.org; Fri, 03 Nov 2023 14:26:16 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1qyv7m-00158D-0a for pgsql-hackers@arkaria.postgresql.org; Fri, 03 Nov 2023 14:26:14 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qyv7l-001584-Nc for pgsql-hackers@lists.postgresql.org; Fri, 03 Nov 2023 14:26:13 +0000 Received: from feynman.df7cb.de ([195.49.152.168]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qyv7g-003m9A-Ah for pgsql-hackers@postgresql.org; Fri, 03 Nov 2023 14:26:12 +0000 Received: from msg.df7cb.de (unknown [IPv6:2a02:908:1482:3660:b7d0:f584:a987:bc23]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature ECDSA (P-384) server-digest SHA384) (Client did not present a certificate) by feynman.df7cb.de (Postfix) with ESMTPSA id 4SMNMf1Ftyz3FxF; Fri, 3 Nov 2023 15:26:06 +0100 (CET) Date: Fri, 3 Nov 2023 15:26:05 +0100 From: Christoph Berg To: Peter Eisentraut Cc: Andrew Dunstan , Andres Freund , Tom Lane , pgsql-hackers Subject: Re: meson documentation build open issues Message-ID: Mail-Followup-To: Christoph Berg , Peter Eisentraut , Andrew Dunstan , Andres Freund , Tom Lane , pgsql-hackers References: <3fc3bb9b-f7f8-d442-35c1-ec82280c564a@enterprisedb.com> <7137c5b3-7d9e-4659-03a2-9e2df74cbab7@enterprisedb.com> <20230405144512.zfzb6vd77dk5dnyr@awork3.anarazel.de> <50193d79-e7d1-ea81-1ef3-5670b007c7c3@enterprisedb.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk Re: Peter Eisentraut > > "meson compile" doesn't seem to build the docs by default ( see ), > > and I'd rather it didn't, building the docs is a separate and optional > > step for the buildfarm. > > 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 * None of the "build docs" targets are documented in install-meson.html * "ninja -C build alldocs" works, but it's impossible to see what flavors it's actually building. Everything is autodetected, and perhaps I would like to no build the .txt/something variants, but I have no idea what switch that is, or what package I have to uninstall so it's not autodetected (only html and pdf are documented.) Are there any other targets for the individual formats? (I could probably use one for the manpages only, without the html.) Non-doc issues: * LLVM is off by default (ok), when I enable it with -Dllvm=auto, it gets detected, but no .bc files are built, nor installed * selinux is not autodetected. It needs -Dselinux=auto, but that's not documented in install-meson.html * There is no split between libdir and pkglibdir. We had used that in the past for libpq -> /usr/lib/x86_64-linux-gnu and PG stuff -> /usr/lib/postgresql/17/lib. Christoph