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 40E0E43BE7; Mon, 26 Feb 2024 10:59:51 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3114D42E03; Mon, 26 Feb 2024 10:59:51 +0100 (CET) Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.18]) by mails.dpdk.org (Postfix) with ESMTP id 2650640144 for ; Mon, 26 Feb 2024 10:59:43 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1708941584; x=1740477584; h=date:from:to:cc:subject:message-id:references: in-reply-to:mime-version; bh=pc9is420FKcgYDI/+KbSyMuDnLQ+8QNj5hNWrnO8Wuo=; b=hM43HpfwXknTYs+GB5rs80VRf62Ds04lbhhP+mu85+KgIE/A6swPlD22 yyyGTUfEN0uvkoQehhOapNdLoBf8yCE/RC/DsaD51NQCGMc+CkycxqNNo VwDzVtTIZXAg8H97Bn9FDbgmQzgyIeToroGA+h6fEzYLca1C+pi0wu+Ok HYVhbkzvxSVBJ0RUC6kuEQZh7pOda76LiLu+WNE3PSCtpxsO3hRwSoojz eg3Y13Xyi1YlZ/V1SOuBBfBV84RRhOa5ZUNrEZcORljyvHLt1Sy4et+FY tqhznhHbXK1QDFTD67ak3EGy9ZiK3BoGSvViIK2Q0ICO9gdpiw67nszmc Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10995"; a="3334554" X-IronPort-AV: E=Sophos;i="6.06,185,1705392000"; d="scan'208";a="3334554" Received: from fmviesa009.fm.intel.com ([10.60.135.149]) by orvoesa110.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Feb 2024 01:59:42 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.06,185,1705392000"; d="scan'208";a="6542359" Received: from orsmsx603.amr.corp.intel.com ([10.22.229.16]) by fmviesa009.fm.intel.com with ESMTP/TLS/AES256-GCM-SHA384; 26 Feb 2024 01:59:41 -0800 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.35; Mon, 26 Feb 2024 01:59:41 -0800 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.35 via Frontend Transport; Mon, 26 Feb 2024 01:59:41 -0800 Received: from NAM11-DM6-obe.outbound.protection.outlook.com (104.47.57.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.35; Mon, 26 Feb 2024 01:59:41 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=CtKuu7hTB92a9tb6+6u5eKcYcQIDvqG6/vhmBgii/dN9+RY0eB4gGD5oappeAS+N2wnHn0Q7OefPXM3a7qK5VqfzhPy5q80cMUZEUXGJ8Jgq4nHH4+MYYrOyj2yvBc1g2tdY5evD4JcqsSpLPFD4H+uDDuWJPjXkyzu7oSauUYew/yCa2+HnJhakAH/VZd5vmPHGLMYjtLtO26gBgOwliBEnkFzjA3DcQTrJrkEaKi1NIJgWm+8XFFP6BlENHIrkPUW0vMSscjNdAAiD/C3x/G9EU+jQXmXyrQnKeOC1uFQ1jsWdgmGJ0sNM68+7dGbW475DzeKs6mgq749gvGQ4OA== 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=+DNb8rfxFXdTqp7hXlyLh7Alco3Tat/5ooPlGC6Mn84=; b=VbozyXsR/c7SJaYRuoswjF6VYrD4q8Pm/vTJvh0urjc0aDn6jYXBRCxKIbACLanrI/Db/yPxHXZHJ+7fLu4rQvBTOQnPwRnhTuHNgb+FenNKFyG0buP0GaVpZ5N1p8bSOrPvicBH9emESmY2BhfBQ3ymHwJl8Tmksi6W+I5Nn9nS0pBvSPZSMEteyI6MiKzUuPgtQedjqJs2PCCBGMaKcZJ22e22+MxjoykXFFy0ScMmSQLZlw6bNg++/hrFzHvPHVjO25cyOjKrHmi+vFnyipDofHZrjtvYd0juBvmrCKlYyrWJ553bqbnlJnoJ6wiVSHiO9mveGVgoQjf0ca8NLg== 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 CY8PR11MB7290.namprd11.prod.outlook.com (2603:10b6:930:9a::6) by SJ0PR11MB5937.namprd11.prod.outlook.com (2603:10b6:a03:42c::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7339.22; Mon, 26 Feb 2024 09:59:39 +0000 Received: from CY8PR11MB7290.namprd11.prod.outlook.com ([fe80::243c:2f7c:da5c:871f]) by CY8PR11MB7290.namprd11.prod.outlook.com ([fe80::243c:2f7c:da5c:871f%3]) with mapi id 15.20.7339.023; Mon, 26 Feb 2024 09:59:39 +0000 Date: Mon, 26 Feb 2024 09:59:32 +0000 From: Bruce Richardson To: Pavan Nikhilesh Bhagavatula CC: "dev@dpdk.org" , Jerin Jacob , "mattias.ronnblom@ericsson.com" Subject: Re: [EXT] [PATCH v4 01/12] eventdev: improve doxygen introduction text Message-ID: References: <20240119174346.108905-1-bruce.richardson@intel.com> <20240221103221.933238-1-bruce.richardson@intel.com> <20240221103221.933238-2-bruce.richardson@intel.com> Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline In-Reply-To: X-ClientProxiedBy: FR0P281CA0247.DEUP281.PROD.OUTLOOK.COM (2603:10a6:d10:af::16) To CY8PR11MB7290.namprd11.prod.outlook.com (2603:10b6:930:9a::6) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY8PR11MB7290:EE_|SJ0PR11MB5937:EE_ X-MS-Office365-Filtering-Correlation-Id: bb8880a1-44f6-4e72-61b3-08dc36b1a566 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: vIm0XlyUNqxjstY7OBXzKC6RQr81xJ5BmYvjfjqtUCgsTX4h7DnCnD3sMVXgP0OTO/1ddHXI1JHeMFMSEbFvyFDiX1872MU/pIbhsYMOd8hzRx9GoDM50X7Cx9urPw/Y39udWLw2w/ilNywr3+yWGCtQVtXTDIWsJu8gHpain5jb8HlKdGMNZQDZZItMKq8n3NhCuB99VRqxKcG5nFhqQIUYsYSw5hgoKFDPJWBCcrtcZtuMXsq/ONv57YUPPFQc1dpI5SkgJeNkaKJGaG9EvzIqzTouQB/OTGyNVcIqeA7JXASsvNj4LkUjhVFnu4dB5ju7vik5jHBRD6MZeHpMwAAVX9WTXND48Jtwm3H22deAN/HueW4lD/eI+zZGlmki0sUFTjIib/8Si/mDE6qL7WnzrRo7pavBdf1rKaQ7dNrKVrQ/dMsptx+uJCD5xkvLz9PLMZqhniAP5sSYz1oz3EiEgLMpRXDiQnB133ZUsMyooBO5b4hAm6RkZ7K29UM6pl4BTlwP4FPobe+yc7X/XlPryvo7ENNm11mtL0rHVWiteLEVDP/voKbcRfoa4U0S3dgPyfh/e82A+D5B7v/3iW2ukT87frzWVJpOJ1R37Yxhu9j0bni98W+/mIra7dLC X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CY8PR11MB7290.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?PjvYnzV8zT5/f66HZ6ZRWHfFLxs71VXfxB1NneVLkTI5C1DBalsgX07EEjl/?= =?us-ascii?Q?ICmdJjn9QpniuxzVs6VzDVVsAfJBduZmrxMCh+DgTN4H6YR455xGsU9GmN+D?= =?us-ascii?Q?xrcYbAGPFxvW+NvIluZuPCHUI7cecG7B33ffLVhxs5pJbm6/OZWdpKq3CQz/?= =?us-ascii?Q?9VMGJGOpU/tQUkm2V/1J9fQRuoxLN3DoChLYLoG4ex4YNHeptYvrPsRb9veq?= =?us-ascii?Q?5/aLk3OCEVmwyHsNo/Nk18gA5oSctSS7Bk/qzEar0YAG/4y17CzP/IpjxCvg?= =?us-ascii?Q?blcVrA8+T+2kZKKfWBBDjMRMlufI9s2hKGXWsyumM3rgQZ0t/YzgRZI3SZKp?= =?us-ascii?Q?e/S3F0Z8+GtI93G2py9s91MD5Cebcg8yMmit7Bqf7Ib7ShkEmalE7qy0PbAC?= =?us-ascii?Q?I6nc06d/SfRHFFA+SDP/cyyBtc2RrmumO5tHZ9SEh5ufFS5MSSyNDJx3N1f8?= =?us-ascii?Q?NexCrdisug3X0uOvNucMJMG1RyW9PB1t6Wf9GlZOuMsH3R/GgbKO34igWMgO?= =?us-ascii?Q?JjKQMyngWVjOnGvA52JfkdDyICutByKvZXC9DkwBXBSoJ+8xwP8/CcMyNY2b?= =?us-ascii?Q?+T+Ha4+clv2y2FuTmcO7SroXcAHTt6pO6PC9w28KZ/FRz2H51JbHbJi4TvbA?= =?us-ascii?Q?qyjugtW14/izaD2GWMXlKB1KURY8k3e+kqJQKWoQmrx/RNn3uABeMRg9h1xB?= =?us-ascii?Q?OprXCuIp6YhhSOBwfQpjRGA5VXII0r0olQ0bLlO1Z8C2+tsIjrOabQC23o4r?= =?us-ascii?Q?xQ7vkZfmXvH5vFGqL5BttKO4Y7Cc5xIPV6P21ncMVMUrqV18KQ6skf7z4NmM?= =?us-ascii?Q?H3Hou+esWQsy9hH8KmrUkYOFtCxcQ2yZyGGbt9xz5tBqAV5HWt8dE9rl9sYq?= =?us-ascii?Q?7WjpQp1vcSsAxKrBum5j2kCiZmD2+AztIQwFKIwwQOVzVuujSU0Mm0L2Xssh?= =?us-ascii?Q?6sJZOhFj+4auGUDRd5aQOFCk561gyPJivi9XY/kC7fusGElNJRljHDRaDilP?= =?us-ascii?Q?OXcuX99JOlNqQlyQJb3M67JEQHML0bjdjjNU/45Y1b3VK8KM06LSk34mKSFw?= =?us-ascii?Q?2x/Gbt6VSHpcaNFKRn6eQTzxtb8z8hUhqPzNXcx8UOqoEp5eFQZOTnv7qG/A?= =?us-ascii?Q?QiFdnNuDIDUUT8rWrvXKrYwYXJSfRK81OoE4TZy3ZsvIuploPWF38ZkFF+zb?= =?us-ascii?Q?1yRDROy0W4agOfk/l7KXDyZGjP8CjCMmQdJd0GfPyrsq7xVQ2YihiYvm7v+b?= =?us-ascii?Q?N1ETQEvShbFF8Khbks5Q/xxdgocBJNmQHRvTtikIy2SaFDlJfUNcKHu4JRlS?= =?us-ascii?Q?as37C0fP0dH2WYQ8/8BSM4QxWsOed0d3zBOVk6uRwEFR2mktpHKmjKYAwlYK?= =?us-ascii?Q?qmk7lcKa/uosqgtj/Th0nLc5KlXaxekIO1KL3/Z9pPYRd6ulGcY78Ng0slwB?= =?us-ascii?Q?7mz6GjxNyrhng7KkslrU28+tE35kR4HRBwhjRL9Nn6d8aVLndLkiqd6lFUhz?= =?us-ascii?Q?eSAeHNEl4H9ZfNTrrFmeTqnaCeYu/wpNChNBAh+X3j9NTXTm7Zy8Nuiwdo8m?= =?us-ascii?Q?G8WqOsK7o3vakpDiw1VITKo7CEBym6wiQdW/af9fk+pZoUHR9CLAYHPwchwU?= =?us-ascii?Q?Tg=3D=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: bb8880a1-44f6-4e72-61b3-08dc36b1a566 X-MS-Exchange-CrossTenant-AuthSource: CY8PR11MB7290.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Feb 2024 09:59:39.4193 (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: sjoZ0H6Ah+WJ253gFY8XNoZvr+pFN7lNALWHtMXIenhXk/RBy2OoHW4a9rDOL73MM+W4V2FIS9tTceGXfBwpsqPd5rsoA7+jJGM1ca8jh3s= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR11MB5937 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, Feb 26, 2024 at 04:51:25AM +0000, Pavan Nikhilesh Bhagavatula wrote: > > Make some textual improvements to the introduction to eventdev and event > > devices in the eventdev header file. This text appears in the doxygen > > output for the header file, and introduces the key concepts, for > > example: events, event devices, queues, ports and scheduling. > > > > This patch makes the following improvements: > > * small textual fixups, e.g. correcting use of singular/plural > > * rewrites of some sentences to improve clarity > > * using doxygen markdown to split the whole large block up into > > sections, thereby making it easier to read. > > > > No large-scale changes are made, and blocks are not reordered > > > > Signed-off-by: Bruce Richardson > > > > Acked-by: Pavan Nikhilesh > > > --- > > V4: reworked following review by Jerin > > V3: reworked following feedback from Mattias > > --- > > lib/eventdev/rte_eventdev.h | 140 ++++++++++++++++++++++-------------- > > 1 file changed, 86 insertions(+), 54 deletions(-) > > > > + * In contrast, in an event-driver model, as supported by this "eventdev" > > Should be event-driven model. > Yes, good spot. Jerin, can you just fix this typo on apply, please?