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 DDB0041FCC; Wed, 30 Aug 2023 12:20:30 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id C38674027B; Wed, 30 Aug 2023 12:20:30 +0200 (CEST) Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.136]) by mails.dpdk.org (Postfix) with ESMTP id 9A69A40277 for ; Wed, 30 Aug 2023 12:20:28 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1693390828; x=1724926828; h=date:from:to:cc:subject:message-id:references: in-reply-to:mime-version; bh=ZGw6akFzwGFKhJGpAH+XzhglkgAJjVSHZjWuHjS36PA=; b=S0YtRNbKIN5vQ8kgMI7ws6bPukGDLz4gQB2YayVkxTuSV+u/Ej0n3SZF Cfnrjw9ykfzZxJjdVhCQ95B1PDQ+1BIBn1p9wvR8tX6hjLtimvpZOdPqd 3+liNzJNOZo6Mz73Mxy+JthGEoIK2qsj+fYqHodbBcVmuzogyYfy/Kege olFVP7huWKOJf97JFaxxgDXHoFOf0oxfUo10mUfGrn2x4QBIMslWEs10u ipmH5qraQHg4eGDjTuE0+sc4pXF+tVGNUVKCQzPumGpn/Y0uFy831oR/X lP01PevEOT8psIuEXY55Z68a8LFwqZ/Zfw9vgSjUJ0touZiQI29Pu+qpp g==; X-IronPort-AV: E=McAfee;i="6600,9927,10817"; a="355112458" X-IronPort-AV: E=Sophos;i="6.02,213,1688454000"; d="scan'208";a="355112458" Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Aug 2023 03:20:27 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10817"; a="809083811" X-IronPort-AV: E=Sophos;i="6.02,213,1688454000"; d="scan'208";a="809083811" Received: from orsmsx603.amr.corp.intel.com ([10.22.229.16]) by fmsmga004.fm.intel.com with ESMTP; 30 Aug 2023 03:20:26 -0700 Received: from orsmsx610.amr.corp.intel.com (10.22.229.23) by ORSMSX603.amr.corp.intel.com (10.22.229.16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27; Wed, 30 Aug 2023 03:20:26 -0700 Received: from ORSEDG601.ED.cps.intel.com (10.7.248.6) by orsmsx610.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27 via Frontend Transport; Wed, 30 Aug 2023 03:20:26 -0700 Received: from NAM11-BN8-obe.outbound.protection.outlook.com (104.47.58.169) by edgegateway.intel.com (134.134.137.102) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.27; Wed, 30 Aug 2023 03:20:26 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=mdkELkd3Z80NYczCzw9zrynuQJcYVLCkXbNHJsrwV/BJQbh+rlOxw7klTdi/YCHQuybJmCvxvPexGItUXQzr7IuuTdI6pjvZE9JM0NkbYRkXHk/iMiAInhrXc3C9OgmJjAszjTayLDC7eatMyTZeItz0HE6v4BkYm9TpTuSQQfyey2ABvfupADKkpLkJHxbPvWPCj2yD9d+nEBFOq1ql+tSUwAiW+V2bTscVmRJabzLzXJnT4IwdYlU3Sn7iZg5iMHXGgUA6X8Hviw0DR1B7H1CvRjUhkBk1kJC99V3jCu+JbPKXf9Q6PoiKYY9Q8Gp7HDv4O/E6+V9EMcfZgwA0Jg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=b0TN4/m3QP36AV3msbLQhznsR1PwWl/yvvKDECFfx4A=; b=BZNLJF0lhT2a1+N+Ig9VMNq2NXjKhEc5cI0k8bhAYWOFXj4/WwL3KkQ/01bnsy5293aWFx24/1ZspgBz92b4M7vGW3Zby8VgiJ+ZUYmrMssqcOJ6ykrSM3LLPbCMouPRREp7/yMCdpc4ucM1Maco2gzSv6xsto0RoJSmjq795DXqvXqwycyqBM/aB3xrz9jkjF4s4NgLbr04YxqrOLnQjNLN1I9hmpZVnU2ad43IHvQ88UjkMcKg1ljqwhM+yESQcf5RxdN1PcjLEZJYzA+53CDCyR5OitaBs+s7S977K7NtmQDpEaZLyqVUaSeoFJX4+90Bo+6V0IpTYc+QY93v8A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; Received: from DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) by LV3PR11MB8743.namprd11.prod.outlook.com (2603:10b6:408:20e::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6699.34; Wed, 30 Aug 2023 10:20:24 +0000 Received: from DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::43d1:af60:464:347]) by DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::43d1:af60:464:347%5]) with mapi id 15.20.6745.020; Wed, 30 Aug 2023 10:20:23 +0000 Date: Wed, 30 Aug 2023 11:20:16 +0100 From: Bruce Richardson To: Thomas Monjalon CC: , David Marchand Subject: Re: [PATCH v3] doc: build manpages as well as html output Message-ID: References: <20230601153801.118616-1-bruce.richardson@intel.com> <4029524.5fSG56mABF@thomas> <4505422.LvFx2qVVIh@thomas> Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline In-Reply-To: <4505422.LvFx2qVVIh@thomas> X-ClientProxiedBy: DU2PR04CA0176.eurprd04.prod.outlook.com (2603:10a6:10:2b0::31) To DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR11MB7309:EE_|LV3PR11MB8743:EE_ X-MS-Office365-Filtering-Correlation-Id: 61c8e1fa-a640-4950-f7b3-08dba942b8d9 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: SfwMKk3ZKOP5oRyiS6VY0zwLrzmY09Q2QuE15T0TIwNTdw24Yn3NaZxktsiNBrKzRV0jj7ivp1VecbGo3Sg5V0rWVoqfvkSSRbh1dlFLJykKOKqHeJnVhvWLqBfpelLJr1tMTNFbdTHTSK6c+/i2+Sww80CCLLH1UGI9BkajGEKoxVa5UNDsUUgz6y4OG39FdXoMe9AN9Dto5WXdZd12s43BBBVtsP7AWj2tI0G1peVCxVr2yMamtre3JPtvLlgACR5r0wQj/nwMvM9ju9s5pmCogKD9piKB3E29fuB/INiN/d2XwDv+3nJC2gxm/1jgDV0Wgmmw5vG/GDKBXCmc9cTtH2hmAwc42NYQRyb/OYuaBq/+laLzfFdxeLmEfZ3fIxtYOzZS5xDemvHnWX3uScpxnBAhnbO7MAsj8f+x372V6qcR+8yXdYSgLXMwzZP5quIXH5GK3fTRWpEkG6iQzhhvM/vxf+0QfdRIsLjaKp+SQWDugIm/h3YAtIkE51gVOMHBjs7V+1lBe0X3U7OWka6f7T9Bt+rNbCgTHT0mfd/uSVRc6ihsBoth0auqhDgr X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DS0PR11MB7309.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(39860400002)(396003)(376002)(366004)(136003)(346002)(451199024)(1800799009)(186009)(6512007)(26005)(316002)(38100700002)(82960400001)(6916009)(41300700001)(4326008)(2906002)(86362001)(5660300002)(44832011)(8676002)(83380400001)(8936002)(6666004)(6506007)(66476007)(6486002)(66556008)(66946007)(478600001); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?x++e0Vf1r9an75gICnNCk6/FuKfl4lD08PQftdYVgi2+LqbrY2W7VtVL48+W?= =?us-ascii?Q?O7fgdFiwYVGvzXnb99P5RZF4osr4lma15Ohd5NvvI17UdWeESStj/FyNAyEe?= =?us-ascii?Q?85K1LueBiaxrSjinVeHbwelyYr9jYqI1Gl7JnRL/21jMUIWOqf8ORC76dlbA?= =?us-ascii?Q?wk3LddGTJWRGENDcorREiNEE6ylEDBhjjdBiU2aQXSagXQn7g2e/+a/N5YwV?= =?us-ascii?Q?YQlWfME01b8ja9bhoy0Q9wtXcnRfD7jNZFQMOlsMjr8pDLi6ob6Xliil7uTi?= =?us-ascii?Q?eqD/ICElU8bU8jQvedTPdtLFqsdCoRrrvdDjUIOjMbvuOUIBnTgak33G35Bz?= =?us-ascii?Q?ToXcvW2Ze0+Ux7CJJ3jQy54MIUfdhdIXfCSpP1exYmiz9StXwf5A19KIAqTM?= =?us-ascii?Q?a6FW/uGM4LE+CY3Lmond96lEAxVl6wSSsmjyF8w3AdB+O0iza3fAimfBVQia?= =?us-ascii?Q?miQyeYp8mBchZuUk+FMfw+NZG9Ku4LSEbSd3ggHjAcB7Dl5PKUhPnqSn0NOG?= =?us-ascii?Q?cYvLH1vjQww0ZJY9x0pPtsxE1lHmuZeBnaVia6yzcdwZT4QEKRDnb73x4sux?= =?us-ascii?Q?epgekStdWGaE0qaX/f7ZRFm38akUvyyURizSPWFWbOVIwc3BfPqWBx36youz?= =?us-ascii?Q?frts3SV0ciQq7NMlCpDjZr0s8Xze1Y0x3hbjdtVWoLmFX+Z5qUIpTXmLed1Q?= =?us-ascii?Q?1LspsS2WqpkrkKKaFj3VtWVKe90WAKQTc8whBpKKle2h2QWHERXLNbysma9I?= =?us-ascii?Q?pofjUv9NBzUr6BRAlg23xZ9C3ZzBJTjl703iVpBZBq4MYIaHPWaOW84LbQHp?= =?us-ascii?Q?r75u89TxpyGmworXjKW56nAgTgiEdDbTCgxyj1IkK/d9Mcw7/+MpG52uk8rq?= =?us-ascii?Q?vpmh7bFM4yZHw+SEfKPY8vEdsbWK6NwkevsWlHB7/aK4z5Ku4CaSyY53HU/Q?= =?us-ascii?Q?gRg9WqCeDf4uLEl1pFuWdkbaEIp3RZ+Vfhd6NG4hwA1i10g4O4vJbQJrAO1H?= =?us-ascii?Q?nhFoYbiUa1KMROxznQvn4JuBdSj+Enh3wh2LfqVXd4s8T6ZcHlNfjNK3RreU?= =?us-ascii?Q?aYUVujfXqa/lgW1ZWAnq0iANHPJU11nDtjgikfqnYbjJIOYJ1rgMo5BZJFLB?= =?us-ascii?Q?DWysS5T+dquLr7XRXt7bnWMfsmKkQVsqzt2LotGwVfaVpQYrdr/CDUGbJDw6?= =?us-ascii?Q?gLCsLSxMPcAyqXxLZpun///aP0+0hhq/F1ZdvcvgVWhQ1Z8qmlTl3uHTyo3z?= =?us-ascii?Q?0Rxbfw0kguYRfrYHDNpTmXYctwrvIoAHQ7GVrvhA9mjM6K+Wiab/m3K0FL0R?= =?us-ascii?Q?bz+KP8LLb7aSsTTag1vAD2SM7pJBLe7swwLoiSjl+XmVzTZtW9Q2a7mm1tBt?= =?us-ascii?Q?laEOiJccBadVlvkSXoL3EWVFCj717/n0mUoXbvKzDozqbnc10TsQEvhCMyXB?= =?us-ascii?Q?Xy2Lvg59H/RDxO5vufmsckJF5L0GrnFIXP9FSiD/PCd6TlH6ESvGqVGGXbJE?= =?us-ascii?Q?4ImXEQwKHbWeP1GLiAArT83ObOdisz1OqWs32QOFpcoUJ32i3TeqjKBIaB3K?= =?us-ascii?Q?4MRqz1yJvdv72tnch7AHIDNeIUuWjRXpkIzvtHJG7kgKcx3TPbIyy4HzcXQz?= =?us-ascii?Q?kg=3D=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: 61c8e1fa-a640-4950-f7b3-08dba942b8d9 X-MS-Exchange-CrossTenant-AuthSource: DS0PR11MB7309.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Aug 2023 10:20:23.9256 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: IdcP1sBgIV+4kh2g1t/EPWDZI/iGcolcITcvM0qlmVYAHYnlhZuvN9hMrE2I+INKGJVH+6lNt7FLF4i+vbLkgkD4L59fE4D+owS9uiQlma0= X-MS-Exchange-Transport-CrossTenantHeadersStamped: LV3PR11MB8743 X-OriginatorOrg: intel.com 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 Wed, Aug 30, 2023 at 11:47:00AM +0200, Thomas Monjalon wrote: > 29/08/2023 12:10, Bruce Richardson: > > On Tue, Aug 29, 2023 at 11:28:01AM +0200, Thomas Monjalon wrote: > > > 3/08/2023, Bruce Richardson: > > > > + 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? > > > > Yes, it will. Unfortunately, I can't find any way to just call mandb if > > we are installing in a system manpage location on the local machine. > > Therefore, I had two options: 1. don't update the manpage database. In > > this case, the user won't be able to actually get the newly install > > manpages > > The user can update the manpage database himself. And if installing from > a package, it should have been done automatically. > > > 2. always update the local manpage database. In this case, the user > > installing the docs will find them, but anyone installing to staging > > will experience a slight delay while their local mandb is updated. > > > > I went for #2 on the basis that the delay in the staging case is pretty > > harmless, while not actually finding the manpages is more serious. > > > > However, I'm open to other suggestions on how to work this? > > My concern is polluting the machine of the packager. What happens when > the staging directory is removed? Is it an error when opening a manpage > later? > Running mandb doesn't add the manpages from the staging directory to the database, it simply triggers a scan of the registered manpage directories on the system, adding new pages found there. It's the man equivalent of doing an "ldconfig". /Bruce