From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <dev-bounces@dpdk.org> Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 2DC3C42653; Wed, 27 Sep 2023 18:25:31 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 173BD40271; Wed, 27 Sep 2023 18:25:31 +0200 (CEST) Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) by mails.dpdk.org (Postfix) with ESMTP id 99CA94026B for <dev@dpdk.org>; Wed, 27 Sep 2023 18:25:29 +0200 (CEST) Received: from compute6.internal (compute6.nyi.internal [10.202.2.47]) by mailout.nyi.internal (Postfix) with ESMTP id 83A865C267F; Wed, 27 Sep 2023 12:25:26 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute6.internal (MEProxy); Wed, 27 Sep 2023 12:25:26 -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=fm2; t= 1695831926; x=1695918326; bh=XOiSADeUusLq0eeDiY7rVDQZSZDcJf4dvxW XMX0ctSY=; b=tLeAx/WoFMdr9bKRa7FgOGtWKHU0WVcktLsABYGxaqNIPamAiY3 gZxc8Rx+vbm5LOhZHk0Lfpc4HpVZFI7hYMW8kN4ksluC8MgA0T5prxUk4UrWiJuZ h6N3F0Qe9Kpnbs20+geQ8t8AKJoOTxeLqxKatXL/x7nV/k34Gv+9P86RP4xs+7Ye 3+BEQeyiLtbY3wI65lfnUjJmlQHZa0Qu50JNPi8HGPN0PKiKOyBjjXkg5clZAouD bzB0b2+tHrHbnQrglvNZTAn9AaBXxWpWyOc2ehengK33aulSKkB+MADhUxWcPm6I /IHLqfsbWEx2kwpmzdL/m+boP0H1o4Z1nVg== 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= 1695831926; x=1695918326; bh=XOiSADeUusLq0eeDiY7rVDQZSZDcJf4dvxW XMX0ctSY=; b=ZlkhzfPKVC9eUGuvKXabnAyQo88pEjgI45DHFUkFRfQajJWWFTN Ph1eHuHmQ6v22tyS8z8R9P/8ZhcKZczg/uDBBxu6lqcFLenOGi9qYKl6aES5wcMc Q1aUfWHTi/b1H8FJIIG+J6LmViEdRVl5OL7SrnnzV18sUSu8RPfGjsDZHIndzjho ApdvW26mJZqDceFRi+hMBrV0slThEtiNN5JC31HOwh938Vo72YELBgbu+OtXIFYi N5G7rrSJuveChjduwvUH6FMUqewiMjJujA6c2Uxw9ZCc/X5X5NxDc3cMaGzun5HV Hvty0N9yFmeK2btwxdO1DC+JXuKIFxkm0dA== X-ME-Sender: <xms:dlcUZaVXSGNaGA-7r7ASx_ZNdBbJ04E-8VPFoPNJhqqO00cojx_rHQ> <xme:dlcUZWmrnW5O6gVdUFOYjKHK6PUNalqZpujb-oztvktgKTeWE8F-5GF0OKh-vactz rma-afMpYCuA9vacw> X-ME-Received: <xmr:dlcUZeapTst3a9ONNff8VT-YvbzKqItasUCqoRfca3UQYAiNNkYFVsPRjiTb_ZQppo2fqWnvLRPkE5IWAtZ4ob0YQA> X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvjedrtdeggdefjecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvfevufffkfgjfhgggfgtsehtqhertddttddunecuhfhrohhmpefvhhhomhgr shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg ftrfgrthhtvghrnhepfefhjeeluedvvedtuddtuedtvefhieejtefhffeujefhteduudev tdektdeikeffnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrh homhepthhhohhmrghssehmohhnjhgrlhhonhdrnhgvth X-ME-Proxy: <xmx:dlcUZRVnDpYuieVkNcrD0cOf0pPJNuMFLIX6Wym3oRKKZnkV3OBidQ> <xmx:dlcUZUmGXk6VQ5ILHtzq852il7VB_xn6nOYEPJlztbEnf5uJzBRMgA> <xmx:dlcUZWdfF-UOrPS2UoR2dJDksHChaAReS99cEPMKIhxqsUQ3wmY5qQ> <xmx:dlcUZZyz7kuQEc32aAaDNQUWuVfAKg7wVAyeQLSTo_6U6dGTV0vCUA> Feedback-ID: i47234305:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 27 Sep 2023 12:25:25 -0400 (EDT) From: Thomas Monjalon <thomas@monjalon.net> To: Bruce Richardson <bruce.richardson@intel.com> Cc: dev@dpdk.org, David Marchand <david.marchand@redhat.com>, Morten =?ISO-8859-1?Q?Br=F8rup?= <mb@smartsharesystems.com> Subject: Re: [PATCH v4] doc: build manpages as well as html output Date: Wed, 27 Sep 2023 18:25:24 +0200 Message-ID: <11562260.rMLUfLXkoz@thomas> In-Reply-To: <98CBD80474FA8B44BF855DF32C47DC35D87B62@smartserver.smartshare.dk> References: <20230601153801.118616-1-bruce.richardson@intel.com> <2768847.BEx9A2HvPv@thomas> <98CBD80474FA8B44BF855DF32C47DC35D87B62@smartserver.smartshare.dk> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="iso-8859-1" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions <dev.dpdk.org> List-Unsubscribe: <https://mails.dpdk.org/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://mails.dpdk.org/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <https://mails.dpdk.org/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> Errors-To: dev-bounces@dpdk.org 31/08/2023 17:48, Morten Br=F8rup: > > From: Thomas Monjalon [mailto:thomas@monjalon.net] > > Sent: Thursday, 31 August 2023 12.12 > >=20 > > 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 upda= te > > > 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 MANPA= TH, > > > then this update will have no effect, as only system locations are > > > scanned. > > > > > > Signed-off-by: Bruce Richardson <bruce.richardson@intel.com> > > > Reviewed-by: David Marchand <david.marchand@redhat.com> > >=20 > > Acked-by: Thomas Monjalon <thomas@monjalon.net> > >=20 >=20 > Having followed the discussion where the "cross build" details were clari= fied... >=20 > Acked-by: Morten Br=F8rup <mb@smartsharesystems.com> Applied, thanks.