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 92D4B42C10; Fri, 2 Jun 2023 10:40:29 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 6A9E840ED8; Fri, 2 Jun 2023 10:40:29 +0200 (CEST) Received: from mga06.intel.com (mga06b.intel.com [134.134.136.31]) by mails.dpdk.org (Postfix) with ESMTP id 389D2406B8; Fri, 2 Jun 2023 10:40: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=1685695228; x=1717231228; h=date:from:to:cc:subject:message-id:references: content-transfer-encoding:in-reply-to:mime-version; bh=SYWzlS8IP1DqoTSL4KpXyf5YqrLDOAi51CeI1C5bBgE=; b=m7IPxrz+fASKXSrROgLEY7fIF/osj+Zn1+IWI9OryemYDgQazq0tNvS/ xMp/wQmloe+vcRpFO3O1OUsHVtuNrAplIiMmAUVBYmkPJwY0U6/wVbO3I pDMcR22LBnTSi4/3ULGoyUBuP2dTiWipdQjSQRj4enQ4H8A+KHRjNt0aI BawlDT06/ak2o8ZFZ5AxVZqVOeH+fBdQl86HAZSXv7EBntzMZZAUKCE35 RvXNxQiKkjQt0ni5WD9Cl/IAMLZGlOuCC9E2+mxF8KEh/PnJxGwbXmay0 DtmTeDcv5PmwVA1XVFGnkX8XD7MnjoZB24o+j0xy4KhYbZbdyeeQH8B+l g==; X-IronPort-AV: E=McAfee;i="6600,9927,10728"; a="419348579" X-IronPort-AV: E=Sophos;i="6.00,212,1681196400"; d="scan'208";a="419348579" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 02 Jun 2023 01:40:27 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10728"; a="1037861128" X-IronPort-AV: E=Sophos;i="6.00,212,1681196400"; d="scan'208";a="1037861128" Received: from fmsmsx601.amr.corp.intel.com ([10.18.126.81]) by fmsmga005.fm.intel.com with ESMTP; 02 Jun 2023 01:40:26 -0700 Received: from fmsmsx610.amr.corp.intel.com (10.18.126.90) by fmsmsx601.amr.corp.intel.com (10.18.126.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Fri, 2 Jun 2023 01:40:26 -0700 Received: from fmsmsx610.amr.corp.intel.com (10.18.126.90) by fmsmsx610.amr.corp.intel.com (10.18.126.90) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Fri, 2 Jun 2023 01:40:26 -0700 Received: from FMSEDG603.ED.cps.intel.com (10.1.192.133) by fmsmsx610.amr.corp.intel.com (10.18.126.90) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23 via Frontend Transport; Fri, 2 Jun 2023 01:40:25 -0700 Received: from NAM11-DM6-obe.outbound.protection.outlook.com (104.47.57.174) by edgegateway.intel.com (192.55.55.68) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.23; Fri, 2 Jun 2023 01:40:25 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=LTbHdzCpU7NQgGshVEzKS59OBS8qc3IMpR4P+PVwWq+WQ4bwTKwWNc1UoZM3anaIFW9ZvFUwRpZ+fYJ6xZeTeW0mEgD39Sn2rnrfk5ETe/81RFbxQcajUpyEmLOiMFfalv4gurXWOtO6ImTfeTlArZ96YIgv2Acnsf6MiF6USLjy8xNiCETIZc30bUxcoo1XYZS0fe9UWnvegfFtDfrW/GXrNC8Vva6MHML78Gin0OQUHeNevAx317XhKmnyYOYP50TQbMu7T30F6qv7GW2kDfKZlmIW/2bvwONMrKs5xhXPmqAOVHAuqOqC9vBzCmr/eaL2RzSfmbx4bB2EYU7UPQ== 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=HSdlVGmdSp+PbM2R2PC+hYccFUXqGeM2mZABIMz2jdU=; b=drUreczFbjW1b53qRfeU8QAW0k1txWVMqcBtkL3Cvw0i7BzfH/CLi6S6Kajt12CFT50twqC0mLYVQTX2zwo1CovBaL6LGU3Sljc5Pgtr72dm9VOXopFqBih1eExD4n5RyVGLciA2mMetHHSDciBYkrBfkOOCf3GcSOlQr/wi4bgjkK83KtgnScQQCspXgyDwGYIipi8ROaoVIoUokhd2pTAnpBEN1xf3SiNxlkM6J7+5xqLuyxQb0fzgfDF6FpkE8f1Vkg169YgJgGuDc5Dp3TpqqaRKUdqPlX01POcCy506upA9qaKiPgvRMTVS284e8QSXAlRE5y362msIqaZDMA== 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 SN7PR11MB6946.namprd11.prod.outlook.com (2603:10b6:806:2a9::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.22; Fri, 2 Jun 2023 08:40:24 +0000 Received: from DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::b8f3:958:d2c5:2232]) by DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::b8f3:958:d2c5:2232%7]) with mapi id 15.20.6433.025; Fri, 2 Jun 2023 08:40:24 +0000 Date: Fri, 2 Jun 2023 09:40:17 +0100 From: Bruce Richardson To: Thomas Monjalon CC: Jerin Jacob , , , , Subject: Re: [dpdk-dev] [PATCH v1] doc: remove warning with doxygen 1.9.7 Message-ID: References: <20230531124648.1358005-1-jerinj@marvell.com> <3106713.TQGk6oTFT5@thomas> <2232141.KTMopqUuYO@thomas> Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <2232141.KTMopqUuYO@thomas> X-ClientProxiedBy: LO4P123CA0306.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:196::23) To DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR11MB7309:EE_|SN7PR11MB6946:EE_ X-MS-Office365-Filtering-Correlation-Id: dc70363f-96d8-4165-988b-08db634501d5 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 9dzKmmmQZ45JkCM0wf00axR8ILE6vM2xt1d32JtRx2OIgaC1HOuZf3LR6E18qF0aMZn6DhjexH0yXXE3OkwoeNFTKIbqODA8piN0AuxaK03I4nG0+fh/ry/FdSetH1Zl8MRuehb6KcBRw4BV/Ki6lu5aN2Qnw+YnVtAaVcmVvFECnS9IJ8X2hZTgdpQSxr1KODtabK86ZWMvG71UAdz1q3eKovTFChq7yoTrM1jhMZungLriKkxgVOfUVkSp+krhheWvm2d/lrXSzHepCbV+TZqExxKk0cST9XyGxmsLlcTZVCuto72ECbBuc0DykYItNS8fhg1yrp8+4Qb4GUtSJNiujo9s0EOOJvBMwX/3R/MR4rJ0YqVUzFqWjQRtw/2nvL6LrfJxl406BBFwrYsyd05n+bZPMgbsarzMGpxuS1QZLsdojmEiy3g9Un5cMNlHVbLnF9GXQ12isI7NrKTPsp0P475VE2qnNVnC5+90etYIcTLri5+/UvXAjtPtRfJqs6rfP7ChoKCSzKQFA/d9d6g9sJOOXst95A7yqQzV3H8= 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:(13230028)(366004)(376002)(346002)(39860400002)(136003)(396003)(451199021)(82960400001)(38100700002)(86362001)(66899021)(8936002)(6506007)(41300700001)(26005)(8676002)(44832011)(966005)(6512007)(53546011)(5660300002)(6486002)(186003)(83380400001)(66556008)(66476007)(316002)(66946007)(478600001)(6916009)(2906002)(4326008)(6666004); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?SDBlbnk1ZTFyakdOeFVhR2QxQnkvVjlSVkdUSk5hODBtMnJ4TlZBTXkyTk9D?= =?utf-8?B?RzY2eHRLY3ZvTzQwa2M1aDNBMW56OTZPUEYwL1lyN215a250b3hUVG1WTnZt?= =?utf-8?B?UjltYk5XWUpQOU5VY0tYVTIybUlTZGU1MnlhbHI3dlJzdzRQNlQvS3diQVVm?= =?utf-8?B?eExRYWd6Tm5sbllHbWRKait1NmFPTmdDMlNqQkVNOWVkeVY5cktTSk9LS3VI?= =?utf-8?B?VEhaSithTFpnREw4TDF1Ym0yYjE1b3RsL0IwSlJhK1Z3MkYwUDVNWE1iZG1o?= =?utf-8?B?MXpiejZhcSt6cHVRR2Y2ckJuY3R1YmVxdERCcU5VT0xMazRPanJtQWUvQUor?= =?utf-8?B?cjJydndMcEpVdlh5V2dsTU1sWGZDbkd6SklzcmRlUGcrZHBHUjRtVzh6M1Js?= =?utf-8?B?alIzNEFQeHpEaURwN1piRkJIcnd1SXdPczBpZXpURnY3SGF5T2M5ZTBxNmpE?= =?utf-8?B?d2tpeStrMEt1YVBjZjRDUmlmUnI5c2J1R05nWnRISlIxSnIrRU5idURXbGpV?= =?utf-8?B?ZWE1QUJuRStqZGZ3dm0wc2VhOVBXMTY3TTJ4dXE4WUhBeEkrc0NNSXFqaXdz?= =?utf-8?B?OTlONXhIUEdtZ2dHTUJrcUZJYWo5dXh5aGVWRjJXQTZKUDZScWJkd3RRa2Rk?= =?utf-8?B?NUlIYkxFNmM1Z0lMWnNyMUFFazg1Qk9xWVNZMkFJbGtCUnh2YndrQjV0RHJ3?= =?utf-8?B?TlFUcUpIRm9XNUJlQ2Q0TjZ6eDlFaElJSHJsekFXQnh1bmFpZVNxK2ZPWlBK?= =?utf-8?B?QzI4L0RnYmtKbURyUEgzMzhGVkdGZWV3SHJib1NhRHE0am9rYXllb1pvK0xy?= =?utf-8?B?eXhUbFRZd1pHek11dzFER3FVQ2x0UVlldlhXeFlpMVl2bFFJRy82WjBJRFY4?= =?utf-8?B?eDEvNGVFNUJrZkUrekN5K1JxQllUWG1wUlJQVEgrWFYwQnQ3MFRzYnJvVHZ1?= =?utf-8?B?clBiYWcyeDJJOHJONkRUcHo2aXBWZE1leFNJbW5kRm9iVFFYWFNtRkExUU14?= =?utf-8?B?R0RBQk1KK2FVQ0ZBRTBKWHAzamU5TVVqYkNoRHozZ0NLaEdpRU9ibG13V01U?= =?utf-8?B?YXpiZk05MlJ1eG1FWVp5T21OU3RCdnMzODBGWmhKU1lDMlFMR0loTWxLUnBo?= =?utf-8?B?dS9SYTRZUzR0eCtHNjRHWS9NcE83b0dUSTRlT05vRWZsVmJiZk81Z1prUVRE?= =?utf-8?B?YmdORkRxUlNIRTk2VmpkS2Izb1FDTkVLSHEvSzhYWDluOVdzbnZsekZlZzVZ?= =?utf-8?B?d0p2TGtYWmdZNE5kTSt2aHREOWVHUkNuWnN4RTFtL1pKZ0t1N0NlYitsWjNm?= =?utf-8?B?d3g3OUNQeWhKM2paL1RXb3lBRU5QRWtFSFdmRTVreWhQUDFOSFV1Y1R1SHFs?= =?utf-8?B?ZGxlZmJjWEcrMEpIWStabHNhM0pncFI1VW5hUXZWRzJzeXhncHRVSDNkWDVq?= =?utf-8?B?a0xyeWJBQi9rOW1rUlRVTkRRMm9tQmpQUXViL2tVOWNvdnk0cHp4bGpsUVJM?= =?utf-8?B?Zlk5clYwRXZuZUJ6NFR3b1hHRllpbmVPOUJuUjNRcktGTjNPNWZLdUFVRFNW?= =?utf-8?B?alFTQ3BTZzg1QUpZUGlyYkcxMk1QVGQ1NWVPMUVuUzZnUXEwVTdKc1R1endM?= =?utf-8?B?Tk9naVB2RnlhejJaRkhWTHVJVU5ock1TTUJzK3A5NklEVFRqYWtLYUJ0cnIx?= =?utf-8?B?bXluUU1pM1ZKTDZNUXRXaTMvZlRkeVVVK0s1Rmd5M0doeXZ2a3lwTHM1bEdU?= =?utf-8?B?aUg5VmR2N3Jxa2tqSVVqc1dqQ0QzY29DSTVLcSsyTjR0Y083TTlNNDJxaEVI?= =?utf-8?B?MGpHNFlORGc3eG03R2F3QTlMOGdpSWdQTzlpd09TOGpUYSs3YU1Cdm5sUWFT?= =?utf-8?B?c2tqaCtZWjhNQmdnYUVDR2dNRkc0U2NCU0FLSmVoakFmSFluUHlpY1k2eEx5?= =?utf-8?B?MW1sNW9iVUZ3LzI0MTJtSmFWV2JQYzcwT1ZpUFFURzN4VjFaOTZhM2Zpejc3?= =?utf-8?B?dmM5amtwWTJkdm9OSVIrem8wYml1SUdSbzdmSXZhcEY2VUFUWjhGVUFIY042?= =?utf-8?B?RFRvcjRzNWRuY3Y3Y0VHdTZMd2FoSDVBYUFQZ2svbjUxcDBydWVXQnJnU2dL?= =?utf-8?B?UjN0cTBoc1liMjVnK3Q3bnBpNlJQeVhFdElUZElzWFhka01qbWZ6Sjk2YTE5?= =?utf-8?B?b1E9PQ==?= X-MS-Exchange-CrossTenant-Network-Message-Id: dc70363f-96d8-4165-988b-08db634501d5 X-MS-Exchange-CrossTenant-AuthSource: DS0PR11MB7309.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Jun 2023 08:40:24.0403 (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: CSgIHEmkP/Hl2GDVyHPmnwRTTcL2IGdUUt96WuPm2jWvCjONBM2tz1C7AruxZx7/ePeyCukmymh4ZS/jbKhj2YtjtT44qV+uogt9MCwRgfY= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR11MB6946 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, May 31, 2023 at 04:49:04PM +0200, Thomas Monjalon wrote: > 31/05/2023 16:07, Jerin Jacob: > > On Wed, May 31, 2023 at 7:31 PM Thomas Monjalon wrote: > > > > > > 31/05/2023 15:21, Jerin Jacob: > > > > On Wed, May 31, 2023 at 6:17 PM wrote: > > > > > > > > > > From: Jerin Jacob > > > > > > > > > > Since doxygen 1.9.7 version, HTML_TIMESTAMP configuration option > > > > > changed to TIMESTAMP [2]. Fixed the following warning[1] by providing > > > > > the correct configuration option based on doxygen version. > > > > > > > > loongarch-compilation reported a build issue at > > > > http://mails.dpdk.org/archives/test-report/2023-May/402940.html > > > > https://mesonbuild.com/Reference-manual_returned_external_program.html#external_programversion > > > > introduced in 0.62 version, so not sure how we can do version check > > > > without that. > > > > > > > > Another option is to just remove HTIML_TIMESTAMP from config file. > > > > Since 1.8.9 doxgen version, > > > > it is disabled by default. > > > > > > > > Thoughts? > > > > > > No need to disable if it is already disabled by default. > > > What was the default of the old HTML_TIMESTAMP? > > > > Prior to doxygen Release_1_8_9_1-64-g3f2e8a306 it is enabled by default. > > Then it would be better to keep HTML_TIMESTAMP until doxygen 1.9 > and don't add TIMESTAMP for new versions. > Sorry for late arrival in the discussion. I am not sure it's worth going to all that trouble. If the option is disabled by default in all new versions of doxygen, then we don't have an issue with the official DPDK docs on the website being any different if we just drop the option from our config. All that would happen is that any individual developer/user generating the docs with an older doxygen, will get their HTML output timestampted in the footer. Not a big deal, to my mind. Therefore I suggest just removing the option, and being done with it. Once we put in the version check code, it's nigh on impossible to remove it as it gets forgotten. /Bruce