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 F273C41F53; Tue, 29 Aug 2023 11:28:10 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 6021A40293; Tue, 29 Aug 2023 11:28:10 +0200 (CEST) Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) by mails.dpdk.org (Postfix) with ESMTP id 282A340279 for ; Tue, 29 Aug 2023 11:28:08 +0200 (CEST) Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id 34F985C0115; Tue, 29 Aug 2023 05:28:05 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute4.internal (MEProxy); Tue, 29 Aug 2023 05:28:05 -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= 1693301285; x=1693387685; bh=PYP3c+1LwKTOU4H7LGk1rjN3+bCXIp+R1er VEOEyePY=; b=UqbdhFQSWVqlZ8q2KBcAgvcdYi2yVgHIHc8zjxksBknIaO2mLXT 0uTGBQaT9aVeB93eAwMO6s19unuHYhKEsnNk5419cZCEmwbBOSYxmviKfuzNi7u9 JAiYCz5MNdV/YLN+mn4RK376BIs7LAdGO/lJL2bSZl8ExB4yIIho6PFbpMEmgHGn UTD7grUy5snlaBw76NNBbo4eDrZ/7u5EzBdDzGlhrj2pLNvB61QoLR2ACGfcHW72 1f4MCdx5hDxkkELXSYWD2MsjTsfSLNiYh1ypqWohgqLX304gDdAZBViMC27cCsHh 0sELfYVVMO81ayP47H+OiV1wpGC6qq3p/0A== 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= 1693301285; x=1693387685; bh=PYP3c+1LwKTOU4H7LGk1rjN3+bCXIp+R1er VEOEyePY=; b=vwBC/uB4MuTJHR6+kekkJavIh+sP/Qs17XC1QztZ7Eb23LJ5s/3 0QteLKzfc7nF6CBGgl5753829dj/GWUNsneIoS70Ju3dKUhlgscGXPAd0N6u3M4S rXry5//Z8nkhFMAYtuztEvobsYJ/SVNDEwvMR3P2XpHKc+wyUwShWgXnQ/z0BhP4 Y2h59lasROdsL3t3Zt9VxZ+Crj9TZHmqPH//kE0QLfSGRQnazbhcwew2gaaRL0/s ZKxUqiwYkLPtgwxg49BAcx39RW2ZY7kIRRCkXNxOka58b9S2hmI0hOpwv/JPZ+Uz 2DnHKuYOHX1Zemf0Xsl/y26li8aUBODdG9w== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedviedrudefiedgudehucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvvefufffkjghfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhm rghsucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenuc ggtffrrghtthgvrhhnpedtjeeiieefhedtfffgvdelteeufeefheeujefgueetfedttdei kefgkeduhedtgfenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfh hrohhmpehthhhomhgrshesmhhonhhjrghlohhnrdhnvght X-ME-Proxy: Feedback-ID: i47234305:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 29 Aug 2023 05:28:04 -0400 (EDT) From: Thomas Monjalon To: Bruce Richardson Cc: dev@dpdk.org, David Marchand Subject: Re: [PATCH v3] doc: build manpages as well as html output Date: Tue, 29 Aug 2023 11:28:01 +0200 Message-ID: <4029524.5fSG56mABF@thomas> In-Reply-To: <20230803164400.98873-1-bruce.richardson@intel.com> References: <20230601153801.118616-1-bruce.richardson@intel.com> <20230803164400.98873-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 3/08/2023, Bruce Richardson: > +#set up common doxygen configuration A space is missing here > +man_cdata.set('FULL_PATH_NAMES', 'NO') Why it has to be disabled? Maybe add a comment? > + meson.add_install_script(mandb) When is it executed exactly? Will it update the database in case we install in a staging directory, when preparing a package for later deploying on another machine? > +.. code-block:: console > + > + export MANPATH=:/path/to/build/doc/api/man Styling consideration: I think we should indent with 3 spaces so it is aligned with "code-block".