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 1320742F6E; Fri, 28 Jul 2023 17:23:36 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id D0A0440685; Fri, 28 Jul 2023 17:23:35 +0200 (CEST) Received: from mgamail.intel.com (unknown [192.55.52.115]) by mails.dpdk.org (Postfix) with ESMTP id A68984021E for ; Fri, 28 Jul 2023 17:23:33 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1690557813; x=1722093813; h=date:from:to:cc:subject:message-id:references: in-reply-to:mime-version; bh=7zsVzCkcYGVyfDWCUfZJKi9jbbQb+hSl224U4Wd4Elo=; b=SYqo1aWWoQFvANPvcSQpPKcSDt/zhmIcrNI22UD68jk2JxygrB23ghOU mh24lMqn9JDkQfMX6e9qKTKmPHDlZ6o8Wgj3HL/f8BIvsdmMCH4O4aC9E 46PlztQCwrQmvzcTt8Me4pCcaan8SLg4mjDZSoySV2MtBxFeMapUTFZFR HoQl5GOCyv493SMD6hLzOJNhBKnqN/uPWM63V4uFn/DAbWadd1iwlN0qq o7ddM7blGjJT2BtBH/ckBu43zLFhPi7Rh6dZvWPvcddZ8yh7aoSimsc+c aswaRpJFLIJO+D7qQEgFWvAQ5m+zoJB4QV9tzY6dq18oEXoRVefg9iILz g==; X-IronPort-AV: E=McAfee;i="6600,9927,10784"; a="368630107" X-IronPort-AV: E=Sophos;i="6.01,237,1684825200"; d="scan'208";a="368630107" Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 28 Jul 2023 08:23:32 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10784"; a="792976204" X-IronPort-AV: E=Sophos;i="6.01,237,1684825200"; d="scan'208";a="792976204" Received: from fmsmsx601.amr.corp.intel.com ([10.18.126.81]) by fmsmga008.fm.intel.com with ESMTP; 28 Jul 2023 08:23:32 -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.27; Fri, 28 Jul 2023 08:23:32 -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.27; Fri, 28 Jul 2023 08:23:31 -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.27 via Frontend Transport; Fri, 28 Jul 2023 08:23:31 -0700 Received: from NAM04-MW2-obe.outbound.protection.outlook.com (104.47.73.170) 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.27; Fri, 28 Jul 2023 08:23:31 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=a4ZJBJfo1PSaCcYJoxlBNgoZjrPe6IVKc1KdHBECEF8B6Vo2cgRqoKlupigN7yU/O4FTglKanU9CZehmXaCcqVdwlWdCZ7ZbNSVG+OEQQXZ0DaRQFD1B8QqOFn2G5kUOpYlrc8nDAUtmld0tfS17d+Kho9NJVETCWBFICY2HmqS3Km9Tg3K16uLz5ywRuYbKDVDimr7dHv7yzjpGGs8VYVWHjG495Zh7Gq3dWWgC+SLfC41aXDzWr1mI5u5wg97jr4ewN4MGXmf695mRHZ7+FMX4B22tfq/f5EO6vctnkligCiYqHR8ug50cFBwTHfjlTRwPi7XzvTRvd3fLDfnUOQ== 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=rf+a+fkrt5Hy0cl0H/GWWIHRfV6KeVs7cs3xvXy1cuw=; b=naZfmInNc7XywOZm4NTMlpGL5VKRtwhyI2jDwntk6EcZmJNFy0dyZ/zE4Jfzvft3HD40W/CoQsnkwH6rFzC8b18sWlHKH7s+v5TlI8TMZsQatDjaJsw0cWlzlDZM1fmRRTVkVnGXrJS4ogTSeas4nkgG9pcwCyqUDCr38R3WMrj3/rgsxNaNzFQZfQvAX4o1cv/Uol0JqRL5EeL6SMmnmJyI0e3NW/PELmAWUA/Cc1T78Wne07FYHAUE/twAb3V6Ce7E2Whb2gKDdHl6ZzSW2mfBn8KO54FV5jowtPzvtwhHG+mHUuAS0ONU6rJHDaDX/kVsHryaB/UiePVVfpfIYw== 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 SA3PR11MB7527.namprd11.prod.outlook.com (2603:10b6:806:314::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6609.33; Fri, 28 Jul 2023 15:23:30 +0000 Received: from DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::4f48:e1c1:e09f:54c2]) by DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::4f48:e1c1:e09f:54c2%6]) with mapi id 15.20.6631.026; Fri, 28 Jul 2023 15:23:30 +0000 Date: Fri, 28 Jul 2023 16:23:22 +0100 From: Bruce Richardson To: Thomas Monjalon CC: Subject: Re: [PATCH v2] doc: announce new major ABI version Message-ID: References: <20230728142946.1201459-1-thomas@monjalon.net> <20230728152052.1204486-1-thomas@monjalon.net> Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline In-Reply-To: <20230728152052.1204486-1-thomas@monjalon.net> X-ClientProxiedBy: DU2PR04CA0173.eurprd04.prod.outlook.com (2603:10a6:10:2b0::28) To DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR11MB7309:EE_|SA3PR11MB7527:EE_ X-MS-Office365-Filtering-Correlation-Id: 23a29d74-3b74-472b-cf86-08db8f7e9916 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: /87DtIjgLQ8TOblpNVd9LLMuK9IzIgiw5lWLlPH+1rZkbjqfAefq7zBaLXHzXZq7utcm0jKXmPp4lqNYXpxWQ8gAzH92ZMJrU7lKTnvW1LhJCsuFrYZRrVLKRE1QMTuu6ELxbYwqzWtnDyB760IEIG9WXtni1UTCieKESjJtl2okT+VZ1Zya4/1KOd2ZFusz6JPdYse5EDhLCgQ3kgmbGamPgSP5W4kc6vKMtCVsCzKXu5FXmRtnwqk3DMiXAtbxJxPRb8frYfv7zHtFgqsU1POMX4uWlVJxHyQm2vymQH7mdNxIE/H8O8TSPBuAf1YE7bVj4RSrS2NNQ4jvqIvikP/3bWA8mN9xwnbffJaUSHSzN9c4ZOHBJu6RHqTDibc6nJg36H5lntdBmTxVBr7XzAypTLK8nXRtn7lrfuPe6e0et9vcAMOFXW83D4BYwP7+U9P+r0rVDyUXCEtOryKXJIUVXCdeVmzTYyP6X5XZ8wxJ/mREPhMZ7Xy+qGeq8QYK2tkY00Plp1MAOyhzk3RJBU1C6cxbRrYBSqyyA84rNbCGyROcJBbXfvZeVWJKlAAKHEFVxVwXwMQkaNWK/nAx23yDqX3+x89DppICpoIXj2Y= 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)(39860400002)(366004)(396003)(376002)(136003)(346002)(451199021)(6512007)(316002)(186003)(26005)(6506007)(5660300002)(2906002)(41300700001)(66476007)(6486002)(44832011)(66946007)(66556008)(4326008)(38100700002)(8936002)(8676002)(6916009)(83380400001)(86362001)(6666004)(478600001)(82960400001)(67856001); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?NmAdOSXhablxNn1mBCm48GUAKQypar6eq1Jbhhe9vB6TGvZKuTg/QYvUmUpE?= =?us-ascii?Q?GJFd7tadcar5vTZUI+rIT7LPxJk9DIa0lACnGOWzjutXMloCVnFKSnoApuK8?= =?us-ascii?Q?gUOwy9MuCBDFcM3vHzjp6IxZ6RpXp06xPxfuraG5zZzh4gAsHw4MgLDDmLyF?= =?us-ascii?Q?X3vlYPz8UMMj301hmZF0YcYGcUtSOpmAvsmxshDPuDy1lS2a1F1hgKwDq3DB?= =?us-ascii?Q?jwWnbrCPlsIG5YvoH7+4lwCgL+EJfwpKsKOMqwgdyyc5EaXJzp18Ugj3/Mjy?= =?us-ascii?Q?3pULUg+f91b9QTF4O/LI214UDzqXmuVt8KeWOOSjAc+GAoMIBShGReCixZPu?= =?us-ascii?Q?vKGPXLK5IzsARvgcCeBABHB0U+ZnVPVT8jBXQH4MfoPiJUAQ8/ymrQ0GbNSd?= =?us-ascii?Q?hgQMHCgoJWYyQtPUHBf1mpw/zdprA49rucUfYh/6uA2aqXnrDDMy8ioA71sX?= =?us-ascii?Q?TK4HqTJovdNyHVlzRQEqg6eq2Uscg/ITKoUZ8H5yJuyqaEX6uy9jVw5Az06f?= =?us-ascii?Q?uq0bKSsPn4BYNRAjSUEnjWEWuMVI0WyOndt+3/n6sVEhLUmyqOJWWgKOc7T7?= =?us-ascii?Q?kzLWjEi21xw/4JGlEpin70y0Tu61ABemjjhKN+Z4rSmUZ0j4R2wwp76J31Wg?= =?us-ascii?Q?3HXrO6/JnrVan/hNna7uKTpnXSLNbTmnutlmW74yvrLytHMw7p99ViGBUzvj?= =?us-ascii?Q?sEwj1SBT8s2QxqNG3qNXXT309oT9BLV/yk45P2p9nBBXYxXFGZFSv93Igtad?= =?us-ascii?Q?W6+CbOlbXNOFRw1oXyNlXsjTjaKwxYLx9eCSndOK7ccfDJCazmnxXta9f+lt?= =?us-ascii?Q?nz35W5zWqXMcXI/mdV86MfyCCLoIF7J8GfH84pf+KQOU16BAItmsNdUdVnGl?= =?us-ascii?Q?GIHgER2mu0dfBc/HLAS4i6zoAvos5e/4Z+qEdPczvzDQ7KVUFW+YUwr2TzLW?= =?us-ascii?Q?KJ0g0LSY6Whw+7lMAKtUOlZOHqlobYwEaiVEmuE/llO+B3r2gZZECUJ3sDwy?= =?us-ascii?Q?iz+lpivS/1Dup6b6+ihb3XstmurrAVf0EacvNbSXEpwysvg72O0DJCA3VweF?= =?us-ascii?Q?J6aQ531Gj/UU1zoxmGx1q5J3u0DSWUm1944j4H/WmJZ3nHVXL5uSuS6JRsb1?= =?us-ascii?Q?L63Nk3nCSnGOMrNPFRU7SVAqGpnnrF+52R2hw7ppQ07ZAfnMJ3x3LZJTUeRa?= =?us-ascii?Q?tGYC16D9sSg0Tu/TWLiLMaV+WOVEbSmV+4H0zZC1dcPfCoffpFO6nU7rg7LD?= =?us-ascii?Q?x4XoMSbPL/4vUXfU/+xC6E7iVe3TLe8LUjs4mIabEqGZI3zr94m+OBeNoGr9?= =?us-ascii?Q?vvg8mgOWmgQrqc8cK7sS/b5yFSOkmBLHwo1C834cn/Hj6LAPD1xMq1WILsXk?= =?us-ascii?Q?9eY0UadPuKEaZa4Ib4WnkZGE73CM3QTaw618Gx18N0jpDXIDXCHG6rNACo6C?= =?us-ascii?Q?hWHxtdNrvx5ssYMgSqrRaCC+BvGiB7xNhFRbDEL1NRn8icaKay1Ii0561+jT?= =?us-ascii?Q?oXtBMXMlUaRfCZg8zq2RXlU5mQ/H79d7FkGE2DDef1+w0I0RFXOWJwNl6dbh?= =?us-ascii?Q?3OPOPkctdHe1ws4XqEwOSOjfccu6yprpemKRwu7ulOCC3Y5YmpfBPH+K0o48?= =?us-ascii?Q?yg=3D=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: 23a29d74-3b74-472b-cf86-08db8f7e9916 X-MS-Exchange-CrossTenant-AuthSource: DS0PR11MB7309.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jul 2023 15:23:30.2450 (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: V8JTr7fpo/MsePMO8lklQvAINvKNkH6O2+krCntYXnAKo+qDlxgYDjQ2/zI1fE3iHgIFKy8Saqhpno09j3GayJ9W0P1x112X/YjGgE20Zok= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA3PR11MB7527 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 Fri, Jul 28, 2023 at 05:18:40PM +0200, Thomas Monjalon wrote: > The next DPDK release 23.11 won't keep ABI compatibility. > Only the changes impacting the users should be announced in advance. > > Signed-off-by: Thomas Monjalon > --- > v2: improve wording (thanks Bruce) > --- > doc/guides/rel_notes/deprecation.rst | 12 +++++++++--- > 1 file changed, 9 insertions(+), 3 deletions(-) > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > index 91ac8f0229..18281d7304 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -4,9 +4,15 @@ > ABI and API Deprecation > ======================= > > -See the guidelines document for details of the :doc:`ABI policy > -<../contributing/abi_policy>`. API and ABI deprecation notices are to be posted > -here. > +See the guidelines document for details > +of the :doc:`ABI policy <../contributing/abi_policy>`. > + This has a strange line-break position. It can probably be a single line. > +With DPDK 23.11, there will be a new major ABI version: 24. > +This means that during the development of 23.11, > +new items may be added to structs or enums, > +even if those additions involve an ABI compatibility breakage. > + > +Other API and ABI deprecation notices are to be posted below. > Acked-by: Bruce Richardson