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 5925C42FD2; Fri, 4 Aug 2023 14:12:57 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id DFDD140EE1; Fri, 4 Aug 2023 14:12:56 +0200 (CEST) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mails.dpdk.org (Postfix) with ESMTP id 2F9B340E2D for ; Fri, 4 Aug 2023 14:12:56 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1691151175; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=KBkrrv2jhMGMp+WR2+NQWiABMNZM0dL/HJZmC8z46os=; b=SgiwdBvq9dcPUEVVwhIglzSLQ9Z9TsobWakbVyz63O1GvVZUkBbIuT+Ej7FD8UGKXZwDJS Hcksxo9myJNHEFTDTOJmieuwmpvER+YjdjVxpGHgZP+5rk/iaKjOETXoysMdKS5GrLEAMz peC+M5o/7+IYiWnmEOhLBnVzcclIQQw= Received: from mail-lf1-f72.google.com (mail-lf1-f72.google.com [209.85.167.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-250-pZjmwEhBOpG-_gMnmlz9wA-1; Fri, 04 Aug 2023 08:12:54 -0400 X-MC-Unique: pZjmwEhBOpG-_gMnmlz9wA-1 Received: by mail-lf1-f72.google.com with SMTP id 2adb3069b0e04-4fe38a9f954so1995287e87.3 for ; Fri, 04 Aug 2023 05:12:54 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691151173; x=1691755973; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=KBkrrv2jhMGMp+WR2+NQWiABMNZM0dL/HJZmC8z46os=; b=HRVlbeUaHLZmTj+Zyrv3cloF4ngzp/Jb9jfsEHcgl0GBb9RjV3nuh3Xc1k2hYqbPVU +bRJyL1PGawwz4kwI3eFAQMjIir+BMOZT01IBYC4eEPgY/iNZKZnZS5jYPYuxYf1xR18 qcGAYGeBAFlJBxjXrAWi7C4r5FUmI1XVRoCxxtVZODMBNZfOMsJzSQCg2OhVPt4tiCFM XzkOs0f9qrFHklc7fdSadDCET+2qn7cMVQ6BZJzyDsG5xVZHtsItCQzg8iBTThIxZwwb NaWTlMXY6k2hO06rq6j8vlZSPS7WQuuzf1v5RMIoXEkzoGR+05gr8tOahU+AiPzjQBU1 CZ/g== X-Gm-Message-State: AOJu0Yz5Axld7q9BTkYt0TqEvFuhTQMBv07L4lGj2qUP2IsIDgjmdExE 4RkGr8v4stleAsCdpOdse+//NkGVxFmgxZ+AhrQ4eIBAimigMqQasPTFEaDCPXao5/+gST2SEh5 9ztNI81DWcjG/zFJCn6E= X-Received: by 2002:a05:6512:3e16:b0:4fa:e7e5:66e0 with SMTP id i22-20020a0565123e1600b004fae7e566e0mr1645829lfv.48.1691151172966; Fri, 04 Aug 2023 05:12:52 -0700 (PDT) X-Google-Smtp-Source: AGHT+IExg6SMfhgI3FziBJF7JkMNJisNdGNBnLrgJadSKbZii7SeeBFp8GBDhKluqLNXDtEHlMDMq4g0hffIEsTHzb4= X-Received: by 2002:a05:6512:3e16:b0:4fa:e7e5:66e0 with SMTP id i22-20020a0565123e1600b004fae7e566e0mr1645810lfv.48.1691151172625; Fri, 04 Aug 2023 05:12:52 -0700 (PDT) MIME-Version: 1.0 References: <20230601153801.118616-1-bruce.richardson@intel.com> <20230803164400.98873-1-bruce.richardson@intel.com> In-Reply-To: <20230803164400.98873-1-bruce.richardson@intel.com> From: David Marchand Date: Fri, 4 Aug 2023 14:12:41 +0200 Message-ID: Subject: Re: [PATCH v3] doc: build manpages as well as html output To: Bruce Richardson Cc: dev@dpdk.org, Thomas Monjalon X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable 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 On Thu, Aug 3, 2023 at 6:44=E2=80=AFPM Bruce Richardson wrote: > > 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. > > Signed-off-by: Bruce Richardson > Reviewed-by: David Marchand > > --- > > V3: don't use full file paths when generating manpages Nice! Thank you Bruce. --=20 David Marchand