From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 6C1EF41FDB; Thu, 31 Aug 2023 12:12:22 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 321FE4027B; Thu, 31 Aug 2023 12:12:22 +0200 (CEST) Received: from out2-smtp.messagingengine.com (out2-smtp.messagingengine.com [66.111.4.26]) by mails.dpdk.org (Postfix) with ESMTP id 3E2DF40279 for ; Thu, 31 Aug 2023 12:12:20 +0200 (CEST) Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id 09BB75C018B; Thu, 31 Aug 2023 06:12:19 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute3.internal (MEProxy); Thu, 31 Aug 2023 06:12:19 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:sender:subject:subject:to:to; s=fm1; t= 1693476739; x=1693563139; bh=rv8/QdnSWCM+jvQGNH20GGLbY6qSsHNAEv5 3V5zDacQ=; b=f76X+pwaOXj4x1AF6OYCM4ZuSFKwrFmfnaY3mX4hS7/Lrl6m7yo 8C7AcHjSvyBQCxJUnDrrUIUzir+z7Ya4Cny7E4N+GSwXhRmjlsN2cvV6UF/35c8I KjwMT3XO29EHL1WbHcXwADsMHYXdjFGXl85darJwLGEUvpBbaS4ZMhnrHUB+SKVg uhUReZMtZNvnpkX6TK7MsHo01vOL2krw8iks+B7Gy6qiNtTGuUC+HZats7yUlkE8 hq2u4wEyuu1vXSfVQ5tBT2ktJFs9q+oMU4nCAh8VkdKTlmb6smLbVabpPM/7Pwgh Yb/cSYzzrDVZkYxbGgPb7B2S4tnWiZkHECg== 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=fm1; t= 1693476739; x=1693563139; bh=rv8/QdnSWCM+jvQGNH20GGLbY6qSsHNAEv5 3V5zDacQ=; b=z9rN/HkKd2vT5AmMVLM4TpgM1y0x+BXWQ3dF2ul1A4Vm3eRVDrI aW77o8kisJlwhFyu/sUgknl/eVaJAfPasazehLiTL8g1u2tx04cnPRw8LTA5UKCt vPMk04qwA5D0E2J7fiTzTmcopQP8av3ztUDOesYHfNglrZEJEC5I8N5sZSXjDjLG Z7Jw3tFCQ/bgRH/9RCLShJ6zXWvNlPEsnhi7YVgFxzsCI6NC/zUlUSXnSeUINkry 8ITZOCUjEPOVI3HOFsVqW86D7jc2Uv7iTLHr1GktYl/Becy8PQGd6ioPF9cb6xQh y61FZG7YFh96b/JPByy6TyjuBZVc2zdOB2g== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedviedrudegtddgvdeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvvefufffkjghfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhm rghsucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenuc ggtffrrghtthgvrhhnpedtjeeiieefhedtfffgvdelteeufeefheeujefgueetfedttdei kefgkeduhedtgfenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfh hrohhmpehthhhomhgrshesmhhonhhjrghlohhnrdhnvght X-ME-Proxy: Feedback-ID: i47234305:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 31 Aug 2023 06:12:18 -0400 (EDT) From: Thomas Monjalon To: Bruce Richardson Cc: dev@dpdk.org, David Marchand Subject: Re: [PATCH v4] doc: build manpages as well as html output Date: Thu, 31 Aug 2023 12:12:15 +0200 Message-ID: <2768847.BEx9A2HvPv@thomas> In-Reply-To: <20230831094933.8124-1-bruce.richardson@intel.com> References: <20230601153801.118616-1-bruce.richardson@intel.com> <20230831094933.8124-1-bruce.richardson@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org 31/08/2023 11:49, Bruce Richardson: > Doxygen can produce manpage output as well as html output for the DPDK > APIs. However, we need to do this as a separate task as the manpage > output needs to be placed in a different location post-install to the > html output (/usr/local/share/man vs /usr/local/share/doc/). > > Changes required are: > * Add configurable options for manpage output and html output to the > doxygen config template. (Remove option for html output path as it's > always "html") > * Modify API meson.build file to configure two separate doxygen config > files, for HTML and manpages respectively. > * Change doxygen wrapper script to have separate output log files for > the manpage and HTML jobs, to avoid conflicts > * Add "custom_targets" to meson.build file to build the HTML pages and > the manpages, with individual install locations for each. > * Where supported by meson version, call "mandb" post-install to update > the man database to ensure the new manpages can be found. If the > manpages are not installed in system location i.e. one not in MANPATH, > then this update will have no effect, as only system locations are > scanned. > > Signed-off-by: Bruce Richardson > Reviewed-by: David Marchand Acked-by: Thomas Monjalon