Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pk0JK-0002VQ-Iu for pgsql-hackers@arkaria.postgresql.org; Wed, 05 Apr 2023 10:24:14 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1pk0JJ-0005yQ-5X for pgsql-hackers@arkaria.postgresql.org; Wed, 05 Apr 2023 10:24:13 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pk0JI-0005yC-R6 for pgsql-hackers@lists.postgresql.org; Wed, 05 Apr 2023 10:24:12 +0000 Received: from new4-smtp.messagingengine.com ([66.111.4.230]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pk0JF-0002op-Pl for pgsql-hackers@postgresql.org; Wed, 05 Apr 2023 10:24:11 +0000 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailnew.nyi.internal (Postfix) with ESMTP id BB9BF5823BB; Wed, 5 Apr 2023 06:24:07 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Wed, 05 Apr 2023 06:24:07 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:sender:subject:subject:to:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t= 1680690247; x=1680697447; bh=8y7HzurjHG5J03Ly9EoNZXD5W2RAwGLds74 QZ+W3hsg=; b=k6Ils1GizCJagnHT9NHpPola9OQZC4hQWdEYFqFavQY7cTQ/lDP 4uBY0Mc+OnpKwqvnAj4xZ5/oYu6tJPqsBp28KZS4ElV3BH7QUk2TdP2eZ1gXq5AR 3BnonJFHWim2Ex/X/oPsBYCYa0oy6kRBNbCsKXZ2oDg5CvnElWdTxdHk7ZFnGL5L zFA8pZqauL4bZkJ44Kak1zmnjPd+8t5fHD9rtjF6/D8P5hde4Lzs22sredZgIQSl KiwwUEJYGDB/4FQUYzo/4fYYOZrWQuB+UIzTvrxFSg+IlqXqvH76pEwzYy+6dKRE UkcCH0nNy5CjJsqqEqk388c6WzOrquMxqzQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvhedrvdejuddgvdelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhepkfffgggfuffhvfhfvegjtgfgsehtkeertddtfeejnecuhfhrohhmpefrvght vghrucfgihhsvghnthhrrghuthcuoehpvghtvghrrdgvihhsvghnthhrrghuthesvghnth gvrhhprhhishgvuggsrdgtohhmqeenucggtffrrghtthgvrhhnpeffvddtteduleethefg vddvheegffetgfdvteeggeeigfejgfeugeekieeguedvveenucevlhhushhtvghrufhiii gvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehpvghtvghrrdgvihhsvghnthhrrghu thesvghnthgvrhhprhhishgvuggsrdgtohhm X-ME-Proxy: Feedback-ID: i131946ab:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 5 Apr 2023 06:24:05 -0400 (EDT) Message-ID: <7137c5b3-7d9e-4659-03a2-9e2df74cbab7@enterprisedb.com> Date: Wed, 5 Apr 2023 12:24:04 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Thunderbird/102.9.1 Subject: Re: meson documentation build open issues Content-Language: en-US From: Peter Eisentraut To: pgsql-hackers References: <3fc3bb9b-f7f8-d442-35c1-ec82280c564a@enterprisedb.com> Cc: Andres Freund In-Reply-To: <3fc3bb9b-f7f8-d442-35c1-ec82280c564a@enterprisedb.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On 15.03.23 08:14, Peter Eisentraut wrote: > I have identified several open issues with the documentation build under > Meson (approximately in priority order): Some work has been done on this. Here is my current assessment. > 1. Image files are not handled at all, so they don't show up in the > final product. This is fixed. > 2. Defaults to website stylesheet, no way to configure.  This should be > adjusted to match the make build. This is fixed. > 3. The various build targets and their combinations are mismatching and > incomplete. This has been improved, and I see there is documentation. I think it's still an issue that "make docs" builds html and man but "ninja docs" only builds html. For some reason the wiki page actually claims that ninja docs builds both, but this does not happen for me. > 4. There doesn't appear to be a way to install the documentation. This has been addressed. > 5. There doesn't appear to be an equivalent of "make world" and "make > install-world" that includes documentation builds. This has been addressed with the additional meson auto options. But it seems that these options only control building, not installing, so there is no "install-world" aspect yet.