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 85D4941FDE;
	Thu, 31 Aug 2023 17:49:11 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id 8458040285;
	Thu, 31 Aug 2023 17:49:11 +0200 (CEST)
Received: from dkmailrelay1.smartsharesystems.com
 (smartserver.smartsharesystems.com [77.243.40.215])
 by mails.dpdk.org (Postfix) with ESMTP id B54F44029A
 for <dev@dpdk.org>; Thu, 31 Aug 2023 17:48:50 +0200 (CEST)
Received: from smartserver.smartsharesystems.com
 (smartserver.smartsharesys.local [192.168.4.10])
 by dkmailrelay1.smartsharesystems.com (Postfix) with ESMTP id BEE7B204BA;
 Thu, 31 Aug 2023 17:48:49 +0200 (CEST)
Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Subject: RE: [PATCH v4] doc: build manpages as well as html output
Date: Thu, 31 Aug 2023 17:48:46 +0200
X-MimeOLE: Produced By Microsoft Exchange V6.5
Message-ID: <98CBD80474FA8B44BF855DF32C47DC35D87B62@smartserver.smartshare.dk>
In-Reply-To: <2768847.BEx9A2HvPv@thomas>
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
Thread-Topic: [PATCH v4] doc: build manpages as well as html output
Thread-Index: Adnb86SE72X7AzFGQE+dd633H8eYKgALqn4A
References: <20230601153801.118616-1-bruce.richardson@intel.com>
 <20230831094933.8124-1-bruce.richardson@intel.com>
 <2768847.BEx9A2HvPv@thomas>
From: =?iso-8859-1?Q?Morten_Br=F8rup?= <mb@smartsharesystems.com>
To: "Thomas Monjalon" <thomas@monjalon.net>,
 "Bruce Richardson" <bruce.richardson@intel.com>
Cc: <dev@dpdk.org>,
	"David Marchand" <david.marchand@redhat.com>
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

> 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 =
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 <bruce.richardson@intel.com>
> > Reviewed-by: David Marchand <david.marchand@redhat.com>
>=20
> Acked-by: Thomas Monjalon <thomas@monjalon.net>
>=20

Having followed the discussion where the "cross build" details were =
clarified...

Acked-by: Morten Br=F8rup <mb@smartsharesystems.com>