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 9B209428B2; Mon, 3 Apr 2023 11:42:41 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 731CF40ED7; Mon, 3 Apr 2023 11:42:41 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by mails.dpdk.org (Postfix) with ESMTP id 2432F40A7E for ; Mon, 3 Apr 2023 11:42:39 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1680514960; x=1712050960; h=date:from:to:cc:subject:message-id:references: content-transfer-encoding:in-reply-to:mime-version; bh=z5qbu/c2WChPR6tOeDvKNCC8HZCcFK1bWHWtqnwpEe4=; b=K6+vBluhSkQEwHy9jTU4u2Je4rK082odOHYcsWF0jZZOFbsGFn+VvYmX UWTu+YWilAVgvfGn8RSbR7dy2Z/MBQwKMIVMBz5tk97HD5KggIiuzgE+G 8n+sT6byqQX6cpoNOXwKizFGZjvqiN0ZkgZqHNqgc/3meeX2eMFTdkELb 3EI51AedQnTrSSi6VBhKPAVtcPvQhNIzWGq9TLTeDyw+Yaqh2m77qkkxC H6PetaEJoAsCSq1Y9fPVl/fN6qV64mOdfjMpKSy51bvrDvDiSE1G8UuG/ LkLWhKn7pfX1kmmxi+kM0c+RUJRewVQWQBaifDYZErrj/eqkk5nsHGIG3 A==; X-IronPort-AV: E=McAfee;i="6600,9927,10668"; a="339347593" X-IronPort-AV: E=Sophos;i="5.98,314,1673942400"; d="scan'208";a="339347593" Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 03 Apr 2023 02:42:39 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10668"; a="755173593" X-IronPort-AV: E=Sophos;i="5.98,314,1673942400"; d="scan'208";a="755173593" Received: from fmsmsx602.amr.corp.intel.com ([10.18.126.82]) by fmsmga004.fm.intel.com with ESMTP; 03 Apr 2023 02:42:39 -0700 Received: from fmsmsx610.amr.corp.intel.com (10.18.126.90) by fmsmsx602.amr.corp.intel.com (10.18.126.82) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.21; Mon, 3 Apr 2023 02:42:38 -0700 Received: from fmsedg602.ED.cps.intel.com (10.1.192.136) 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.21 via Frontend Transport; Mon, 3 Apr 2023 02:42:38 -0700 Received: from NAM11-CO1-obe.outbound.protection.outlook.com (104.47.56.169) by edgegateway.intel.com (192.55.55.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.21; Mon, 3 Apr 2023 02:42:38 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=a995IWL4wkkEq07UVG5L5hyznphDPZMJXnZFe9XXvZ6pTT7ffQ4I5W1ZbxDus4Up2wvCSd9GaQbaYIfmmXaezUi/if6NpwFA76jXnTAsRku6wAsau2NjlsgRUu9tqAQQf65TvGpebfxeV9E/KjeDULq7qxxaQDO95FKOxLsMWI8kNH9mLLGEBf2+SzvfNeJAJsEQ8yGdi5Rm6Iz1p2EW/ga8M1yjlvxAPaVf7lXxH7aADegRSKj85ngDN6NXlBHCjro7ACDerti+l1H3DHd1bbMF/xKfT1EDOL8K8BIfX6S5gy/WFMrLKGU1ny5tInnQBplFRGzSIBZF/hwuHppTJg== 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=EUsUehMUb4gmJ7oSJuxedkF6PapJb1A21d0umSWCo+0=; b=T3YT/xKCOzo5Xxk16wDgt2d0O39Nd3MuizrnptGU1mdxCr580gfrX94TwJpwbObToxwTO0kO7TlOI+o3yR994CbOJ6HfTerQs+FRtChmm3FEecsQbSjHLlPhMcjJShm76HxKQZpcTuooiyxUMa1qp7AH0F81kDtImZoWyvS/7S1k4+QCjUCTKhctNCtiFyLE275eODFu2KrmIraAZeTHb7NIMwZSmpS4BAL/o5ZGSmqESHeMTE6sRrOTSBMyc9UqU8bJwCZ0I4+Z/nRa2bjp3lTafGNQBXxsznerX1Ea2NsD3M653Cgin+E+UYJknndxMAuZXTBeFUiGXCCq7BaDRA== 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 BL1PR11MB5366.namprd11.prod.outlook.com (2603:10b6:208:31c::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6254.33; Mon, 3 Apr 2023 09:42:32 +0000 Received: from DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::18d0:ac53:aa1d:d19c]) by DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::18d0:ac53:aa1d:d19c%6]) with mapi id 15.20.6254.030; Mon, 3 Apr 2023 09:42:31 +0000 Date: Mon, 3 Apr 2023 10:42:25 +0100 From: Bruce Richardson To: Juraj =?utf-8?Q?Linke=C5=A1?= CC: Subject: Re: [RFC PATCH v1 0/4] dts: add dts api docs Message-ID: References: <20230323104040.484708-1-juraj.linkes@pantheon.tech> Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-ClientProxiedBy: LO4P123CA0188.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:1a4::13) To DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR11MB7309:EE_|BL1PR11MB5366:EE_ X-MS-Office365-Filtering-Correlation-Id: 90c06636-d580-4091-b8d1-08db3427bef5 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: xQj0jlRdUeOiMG2M495EzTiMO2NDpVv7NQxbBeheuQtYaLzDZ28sBRKkkVuGlGlrjJ09wwl2jTonuUoq0e+OMX2vhlN3Tbv6IU2ApmSeCELgGQ7uWPraiMLofZvNmZw/HRDxpEen5YyGUSPxllT0Ah6pZOOo3ubnW7mUql03zoId6R50xFPsoiDXOHgQjUoMuK/WViJqPNhDJgaDaUs0Hh6z8alR9uuXkPUnniI8Ly7NWEsOKEcYfJZYLghNYCVVFDEPrbwi6VXyyVLKfv4pML7FjZZyhjR9mUfnQA9qmJ3I/yWthomi9OwmPr9BtqO7FU4o4ugVNREmFsSfY7GXEdtR+4fLIh664PcEBf69pNaGgRGy5AA2FmHYUZnk+PA7Jw65c4zogKMr2mMSxrNkearv5kmEFcgEBnbPrh+xSF31P62y/M3h4uVfrE7RXjKd3d8q81bYmG8pmj/FAiCXIVe2D57sySrTJpyFan04V9dJLcJin0oD5FRO4Zz1qwZzXUEnqcZ6AHh3VCgxXNzLNQ2bBAAy06O5MCXywzCegv0= 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)(376002)(396003)(366004)(346002)(136003)(39860400002)(451199021)(86362001)(2906002)(6486002)(966005)(186003)(6512007)(6506007)(26005)(6666004)(6916009)(4326008)(478600001)(8676002)(66946007)(66476007)(66556008)(41300700001)(82960400001)(5660300002)(44832011)(38100700002)(316002)(8936002); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?TlZETkNFTk1RSElBVEVuUW9GVkN2a3ZhOFhPV2lWclc5VC9JYkFWWnhSMHlX?= =?utf-8?B?TnEwbWVDT2lEdGtuYlQ0Y0t6ZmFJSXpsV1BSbTlIOUczMGUxNnU1VkluK28z?= =?utf-8?B?Z2Y2TDJISlo4UFpoZ3g0Wi9HT2JqTnNMaUwzcFhSZ1BQZUNyZ1FJd0E1Smps?= =?utf-8?B?K3p3azloeUxpMnNlTUg3TnFrdERZQ2hPNkdaRXpkYU91WGQrTDF2ckR6MnVW?= =?utf-8?B?N00reHBnQjhBOWhZQ293b083bm5OdmFKcDBLZ0xJdk10d1FJRDVqbE9sWFYz?= =?utf-8?B?bDQrTHZORUZiV28yOXJZeDBjQTFGYUp1YUw5YzFkbENCUWpDamw0b2NlRGxk?= =?utf-8?B?azZ4dTRLS0VDQ3ptREhHeUtBTnd2MXgxcFUxZXBRZGJvY2xCRTdnSU1rL2I2?= =?utf-8?B?VUQ1SEJla2hVdDdzSXNHUXJQRmhIT3QzWXdYWnRxTGF3RjFhRGpiSGkvazlz?= =?utf-8?B?K0hOdkY4QmdBVDZLNEVOK1ZtbU0wT090SUVJRHBUWG0rYnRBQXFyT2UvSjNG?= =?utf-8?B?ZFFQalJ1RUY0aHJuWXM0dHdWYTZHSkRONHV3WHRBbzQ3cUpHQUpadGxYUVFQ?= =?utf-8?B?Z3A2ZXcwQytqTnJnRmxRYitBZFlPZmFzWngrcmlCejl6MHlNM1oxaVBraVB3?= =?utf-8?B?cmRadkFmLzRwL2VJWEpKQ05FSHVFOW5TSzdSZVZWUnd5dmZwR2xVb1VZSy9h?= =?utf-8?B?N0pYa1NCdCtFN0wveGwvVFJxQ0xMVkY1ZkFBWUJONFZvaklJdGhoRy9BUVU3?= =?utf-8?B?UmxjbEpkMG0yc1BJOVVwVjJYdzNnMm5Ic00yK0NJemdHd3RLNXQ0eFA2UW1v?= =?utf-8?B?VUxUbDN4eExTM2tia2MvR04xVHdsNmdQRWZPa0UwNWF3MmV1TXdYc05uajFY?= =?utf-8?B?bTFZRUxCQ045MXhwQmZJT1RIQmliQUs3cWtBNktrVS9RYnFqaldaNllwN2lw?= =?utf-8?B?UG5DdjUxM2s2OS9QRkN5VU1laEw2UlZTck1pS2hDWUtueTgrTkNTZ2cwU09y?= =?utf-8?B?algzbCt0Wko4bzJWVHUwU0N4SUhNdHFubVBvNHllbjhIV0MzdlBPUlkxcitv?= =?utf-8?B?Y2M2cGJoVW9STDRjSUVhTWFNZzAvQk1PdnFEcElWeE5CUDY1bEVVaVNpbkh0?= =?utf-8?B?VWExTjR6dVlLMzBzKys5dVllRUMxMzdsK0J6UU9ZeVlLQXBjSVIyWDR1cytS?= =?utf-8?B?WkNLSVVWb1FJREJpZUFsSEc5TURFSUoxYW1iNnZPOVRzaUZNa0lUWUltdWNu?= =?utf-8?B?UGZ1U3l4aFhKa083V2pCN2ZBbTVvZmRUMHA3Z1JBakt3aUxZblB0RGhBYjlz?= =?utf-8?B?ZG9nUWh6Q2JVQ0xNSlFrOGRQNkREMGIxdXVacXNoUUZPVU4rOHlGS0dvMGFq?= =?utf-8?B?WWFQL3ViUjlsc1l1RldnR2MxUnZxM2JoRHRwaDMybitlVmkwcHJxSWdueFRB?= =?utf-8?B?a29KemFBNFZ3WnRPWk1Xdk5ZUzgva2lZUFJHdDJKcnZzbGUvQ3ZUSXJZbS9j?= =?utf-8?B?Qzc2R1o4QzJMbk1wVlM4NDF6NXByclJmRCt6SlZ0TE9WZURBeGZzRFpUSXdr?= =?utf-8?B?dHk5L2NBWHVPNDdTWFN5WlFOVHlZWUZka1RwREZ5VEl6UTkrK0VyRVpWTXFy?= =?utf-8?B?R1hTc1ljRDhwRk5zTDJSL1A3VFdaRUFlYjlRM3RYRkMwMStNTi94czJnZ2tB?= =?utf-8?B?TWp0bi9RV21rRFlaWUhseVN4RURGd1NqVWNiMnFCNkpLdU9XeXp4Vlp5VmRm?= =?utf-8?B?NkxXVlg1a2R3c2N0K2s3c1A1T0JXN2hTQUhxVlpiMmNZb1UrRmZ6dlhBKzA4?= =?utf-8?B?UEZ3UWEwYXdaK1FMRUpVMEJyTi9yQ2t1YmtvWGFLSi9rN1BvRm0yRW9VaE5C?= =?utf-8?B?V1hrT09EeFlBdE54ejRmUDVsZG5uU2U4KzdPUFpid2NHY2R2TktGdE9hTDd2?= =?utf-8?B?Yzl2NG9mS2Ftck1zZ0ZMUUtaU3dnTWpVWkVvUi92RnVGamVna1JhdHJXaUpG?= =?utf-8?B?c1BRdStmcDRwUHUxZFpMV0JMaXV2S3Z2QnNtVWFTSXBjcG5LZkE0b28wck5Y?= =?utf-8?B?VjREVitMYmVsR3VkKytkZ0FYRUpFNHh0aDFpdk9BL1V6QXVyZmk2Y2NDRmtC?= =?utf-8?B?cEpKMFFHY2dQVHVDMWQzeG05M2lIbGR2MVZXYlAvZGp4NCtKWDh6QkNiOHdl?= =?utf-8?B?eEE9PQ==?= X-MS-Exchange-CrossTenant-Network-Message-Id: 90c06636-d580-4091-b8d1-08db3427bef5 X-MS-Exchange-CrossTenant-AuthSource: DS0PR11MB7309.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Apr 2023 09:42:31.7555 (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: FLHDQLuPoo4IAdB8lcPiz0xwl//TRIchwtqiWFZmG3/6t3a5/037bnVHziuJhpFAHSgaNdyPWJ1GQa5M6w+TT6p0jYPZY0e8c+VQI+xpg6M= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL1PR11MB5366 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 Mon, Apr 03, 2023 at 11:17:06AM +0200, Juraj Linkeš wrote: > Hi Bruce, Thomas, > The meson integration is kinda all over the place. I wanted to use the > existing conf.py Sphinx config file, but I also wanted to keep the docs > separated (because of extra DTS api docs dependencies), so the various > pieces are in different places (the config file in one place, meson > code in dts directory and generated Sphinx docs are in a new directory > in the api build dir, separate from the rest of the Sphinx html). > The big thing here is that I didn't figure out how to separate the dts > api build from the rest of the docs. I don't know how the -Denable_docs > option is supposed to work. I wanted to use -Denable_dts_docs in the > same fashion to decouple the builds, but it doesn't seem to work. > Reading the code I think the original option doesn't actually do > anything - does it work? How is it supposed to work? > Thanks, > Juraj The enable_docs option works by selectively enabling the doc build tasks using the "build_by_default" parameter on them. See http://git.dpdk.org/dpdk/tree/doc/guides/meson.build#n23 for an example. The custom_target for sphinx is not a dependency of any other task, so whether it gets run or not depends entirely on whether the "build_by_default" and/or "install" options are set. As usual, there may be other stuff that needs cleaning up on this, but that's how it works for now, anyway. [And it does actually work, last I tested it :-)] /Bruce