From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 80235A00BE; Tue, 7 Jul 2020 20:44:47 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 17C871DE8D; Tue, 7 Jul 2020 20:44:47 +0200 (CEST) Received: from EUR04-VI1-obe.outbound.protection.outlook.com (mail-eopbgr80047.outbound.protection.outlook.com [40.107.8.47]) by dpdk.org (Postfix) with ESMTP id 9BA652AA6 for ; Tue, 7 Jul 2020 20:44:45 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=SNYsupIj0+VLwyP7NzM3/rTqIaHK4w6sMwOUy7MZDFA=; b=Ix1EGb6yfY8t4RzfugctiP96xPJcuWYZnUy8ebz19iDTHBeAaUQVjaQYLopq0HUha13mYNlvggGEa6v5/QdohnPttlB5o0NqwI0mDdEob0qhZiBHBv7uUUW6DgINCm+pUhz2tUy/FZJv1Gfu8uyf8Zv8vbHNODDR/jSnrDbfwpQ= Received: from DB8PR03CA0022.eurprd03.prod.outlook.com (2603:10a6:10:be::35) by AM0PR08MB3459.eurprd08.prod.outlook.com (2603:10a6:208:e2::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.20; Tue, 7 Jul 2020 18:44:43 +0000 Received: from DB5EUR03FT037.eop-EUR03.prod.protection.outlook.com (2603:10a6:10:be:cafe::47) by DB8PR03CA0022.outlook.office365.com (2603:10a6:10:be::35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3153.23 via Frontend Transport; Tue, 7 Jul 2020 18:44:43 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; dpdk.org; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;dpdk.org; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by DB5EUR03FT037.mail.protection.outlook.com (10.152.20.215) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3153.24 via Frontend Transport; Tue, 7 Jul 2020 18:44:43 +0000 Received: ("Tessian outbound b8ad5ab47c8c:v62"); Tue, 07 Jul 2020 18:44:43 +0000 X-CR-MTA-TID: 64aa7808 Received: from 44065161c0bc.2 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 9AB2C52C-0C21-44FA-97DD-CF1FD5DC8E7D.1; Tue, 07 Jul 2020 18:44:38 +0000 Received: from EUR02-VE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 44065161c0bc.2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Tue, 07 Jul 2020 18:44:38 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=X7GY2asaer90WAb01EJbVNUWAsYcIPoTSywzluJMSYvkACj6a/vTtiXwU/5blUyNJ1aLK4VeJFFAnWfElFfBkyfrUdEouC88OMqtbN7ycQuPB4C+1PDNVUnet31J9Xk5LF0oW0iWkpiTiCoqePC+6Ky7jgotLhyvTvt3wcSuKeXIBygy8ob4vnk2RMq/bfmYZeoB8bGrZ1ri4mFTzIx4taKmntYd3JKcQH971MFJm57/hF2dwCGYfBcLk+CdkxGep7rjSffh+w7L9kfm1EkyGjXY5Bkp1SqHK2PcZ6/p0Lt5VW+9ROBvNHvISTPNv929vchFlkMo6b/JdlGvuscXXg== 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-SenderADCheck; bh=SNYsupIj0+VLwyP7NzM3/rTqIaHK4w6sMwOUy7MZDFA=; b=azZyTcWk7bcEReg6hB4IdKEQWQlv/6nnpJHYhpzZJ1PfgYRTHJ77f/bL/80DuvHevH4VYOuSH8WMyAhZJhSkVmJrjtgfmae+TEz9hT/U2aSX7UPWdV1TJkIClu5vqj6hU6SWUg5oYDEhPapCAHyxDMINpT5OTfr2ZNZTcgt5ABt/FWHshumu/w8TzQV8LKYjZMl+Zx9oHzfQK1v5lBzn7CcQojpCSPVJio+H/1G+YRJephJbtDgkQv0ivaBoLObxiLwRPCiezbbCBhfhL4rj3OlsKo5EMtuY9oFMVCOWWcdiFYlFQypxN27uQP7vxwwFPrpMXXUXWOr/7srGNKMAEg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=SNYsupIj0+VLwyP7NzM3/rTqIaHK4w6sMwOUy7MZDFA=; b=Ix1EGb6yfY8t4RzfugctiP96xPJcuWYZnUy8ebz19iDTHBeAaUQVjaQYLopq0HUha13mYNlvggGEa6v5/QdohnPttlB5o0NqwI0mDdEob0qhZiBHBv7uUUW6DgINCm+pUhz2tUy/FZJv1Gfu8uyf8Zv8vbHNODDR/jSnrDbfwpQ= Received: from DB6PR0802MB2216.eurprd08.prod.outlook.com (2603:10a6:4:85::9) by DB7PR08MB3625.eurprd08.prod.outlook.com (2603:10a6:10:42::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.20; Tue, 7 Jul 2020 18:44:35 +0000 Received: from DB6PR0802MB2216.eurprd08.prod.outlook.com ([fe80::9d1d:207b:e89d:199d]) by DB6PR0802MB2216.eurprd08.prod.outlook.com ([fe80::9d1d:207b:e89d:199d%10]) with mapi id 15.20.3153.029; Tue, 7 Jul 2020 18:44:35 +0000 From: Honnappa Nagarahalli To: Ray Kinsella , "dev@dpdk.org" CC: "fady@mellanox.com" , "thomas@monjalon.net" , Neil Horman , John McNamara , Marko Kovacevic , Harini Ramakrishnan , Omar Cardona , Pallavi Kadam , Ranjit Menon , Honnappa Nagarahalli , nd , nd Thread-Topic: [PATCH v2 2/2] doc: clarify alias to experimental period Thread-Index: AQHWVIdA4CsdmH5+GEOJr2DbAKpG2qj8dAOw Date: Tue, 7 Jul 2020 18:44:35 +0000 Message-ID: References: <1594133126-2518-1-git-send-email-mdr@ashroe.eu> <1594144262-5040-1-git-send-email-mdr@ashroe.eu> <1594144262-5040-3-git-send-email-mdr@ashroe.eu> In-Reply-To: <1594144262-5040-3-git-send-email-mdr@ashroe.eu> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ts-tracking-id: e0f8dee3-da7b-49bd-ae9c-c5f6281af6fe.0 x-checkrecipientchecked: true Authentication-Results-Original: ashroe.eu; dkim=none (message not signed) header.d=none;ashroe.eu; dmarc=none action=none header.from=arm.com; x-originating-ip: [70.112.90.121] x-ms-publictraffictype: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 001478da-73ae-4ed4-424a-08d822a5d040 x-ms-traffictypediagnostic: DB7PR08MB3625:|AM0PR08MB3459: x-ld-processed: f34e5979-57d9-4aaa-ad4d-b122a662184d,ExtAddr x-ms-exchange-transport-forked: True X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true nodisclaimer: true x-ms-oob-tlc-oobclassifiers: OLM:8273;OLM:8273; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: r922bDrpqi0xCBnwL/WEZP+fybsPuYlFlSXEx+vdI9DngqwZfPi8FKI1ILVEjkipNRpSg+FrQj+q+y3IVPjLiuKFGNxHUFrQZ1UHEpqRthRuO7YzUkP2vVr55B7gIq1j1A3/L6XJgVRgw5aM+lvwk3dU3qY6/WMCcGv3zvc1PuM8Af+8FEs9ZES7MUst8CGglTQDHoD4YXW2DfGZuSjh1a+AMCVEZnXoXPfr++LlZZQ/HXtEI85sEZGToKXDLRx6DxK8KAo7GgFQuzm4kZ7KuZr7557qYZVVw/myVXoDdXYNavtoDFCMN60uvB/E17Rvb+leFD3VuVq1izRznej5XQ== X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DB6PR0802MB2216.eurprd08.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(376002)(136003)(346002)(39860400002)(366004)(396003)(8936002)(5660300002)(8676002)(86362001)(71200400001)(52536014)(7696005)(33656002)(4326008)(6506007)(186003)(2906002)(83380400001)(478600001)(64756008)(66946007)(66446008)(66556008)(26005)(66476007)(316002)(55016002)(9686003)(54906003)(7416002)(110136005)(76116006); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: CDcAIM6A0Qf/5BZP041AsOcM1R2zUZYVdJOfR6K0p71hUwLeclXAvwTAR8MGzCnwvEH5y84aIxkxk6x/KK4UO5DHdzpnH24rMNHZz14msTidQcFCchg9XWKOx9Pg2fBzTuwxQt7QPccVtG4Qwvjy2ngcVqbPlCGtcwh8NvWIqDI1HYiVciMA+TQcWlULaglw9zSO679MPfg1A8kEBT2RSzwbZjeCi5SWUacAlqX7TQTtOTaNhKxgmxiFKJAIGiE4XkQ3HUEyGKiAe0HSO2UBu0W3RSwTqx6ATxdTZsA+b8U5UC9lNaovIuMS5+Dp+QN84i9erJLw2cjWgWQFHvHlzZQSvLLhg1vsO7BIxQVGGHC8bB6KYjuuXLGD9Tl9e7xLzEhY4CpivdZZGoUxCT7Mgmr/bGhyeP5/2b6f04hmt5OTaCieKg3VL5mTb2IyyitH7t2iisg7DpGAeNlSvehUsN8+1UrjtZQyYPouSXBTck9rfmY7zMrNlccNk9pJ0d0v Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR08MB3625 Original-Authentication-Results: ashroe.eu; dkim=none (message not signed) header.d=none;ashroe.eu; dmarc=none action=none header.from=arm.com; X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: DB5EUR03FT037.eop-EUR03.prod.protection.outlook.com X-Forefront-Antispam-Report: CIP:63.35.35.123; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:64aa7808-outbound-1.mta.getcheckrecipient.com; PTR:ec2-63-35-35-123.eu-west-1.compute.amazonaws.com; CAT:NONE; SFTY:; SFS:(4636009)(376002)(136003)(346002)(39860400002)(396003)(46966005)(5660300002)(81166007)(8676002)(86362001)(356005)(33656002)(7696005)(52536014)(82740400003)(70206006)(47076004)(186003)(82310400002)(336012)(2906002)(83380400001)(478600001)(8936002)(6506007)(70586007)(26005)(4326008)(316002)(55016002)(9686003)(54906003)(110136005); DIR:OUT; SFP:1101; X-MS-Office365-Filtering-Correlation-Id-Prvs: a6aceec6-c175-4cfa-c64e-08d822a5cbb1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: Xo5/kVsHD/mgoFVhdEIC7u08qBejykuv2i0GhHt04Jx9V6ng8EwUq5futGP7Y9og3tgvLkQDWG/wyHk91Q4GvaFmzi21sA8Q6Es7Zl0fPJzMcKHRdSNwTe8nWA+uzMMU8bqUGkMLj7wbdoUOjzJY9KAxSY3164wBrSkjLZ93McxZhYYUyoXsVaOKHVkMtO4CylZ6uCHuzLuuBiRnjakGUttPiHyCQ4+2q9YKe3RitTT+3YJw2RBg2kaoYNZ5+Tvp7ZEKxiAIFw0CfOKf5wkTtX0a7a0fDyu4Ubh7xYx5DisMsltutHtYHVWlOIz3nu4ib4iv9W6J1FB4maIe+IOeqVUqDKPASwVcASHsgeZ4rKptcOIGOpIJcZV/fung7V6cZnW77JeU47McmcHvwx9JBw== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Jul 2020 18:44:43.1680 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 001478da-73ae-4ed4-424a-08d822a5d040 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d; Ip=[63.35.35.123]; Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: DB5EUR03FT037.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR08MB3459 Subject: Re: [dpdk-dev] [PATCH v2 2/2] doc: clarify alias to experimental period X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" > Subject: [PATCH v2 2/2] doc: clarify alias to experimental period >=20 > Clarify retention period for aliases to experimental. >=20 > Signed-off-by: Ray Kinsella Reviewed-by: Honnappa Nagarahalli > --- > doc/guides/contributing/abi_versioning.rst | 5 +++-- > 1 file changed, 3 insertions(+), 2 deletions(-) >=20 > diff --git a/doc/guides/contributing/abi_versioning.rst > b/doc/guides/contributing/abi_versioning.rst > index 31a9205..b1d09c7 100644 > --- a/doc/guides/contributing/abi_versioning.rst > +++ b/doc/guides/contributing/abi_versioning.rst > @@ -158,7 +158,7 @@ The macros exported are: > * ``VERSION_SYMBOL_EXPERIMENTAL(b, e)``: Creates a symbol version table > entry > binding versioned symbol ``b@EXPERIMENTAL`` to the internal function > ``be``. > The macro is used when a symbol matures to become part of the stable A= BI, > to > - provide an alias to experimental for some time. > + provide an alias to experimental until the next major ABI version. >=20 > .. _example_abi_macro_usage: >=20 > @@ -428,8 +428,9 @@ _____________________________ >=20 > In situations in which an ``experimental`` symbol has been stable for so= me > time, and it becomes a candidate for promotion to the stable ABI. At thi= s > time, when -promoting the symbol, maintainer may choose to provide an > alias to the > +promoting the symbol, the maintainer may choose to provide an alias to > +the > ``experimental`` symbol version, so as not to break consuming applicatio= ns. > +This alias is then dropped in the next major ABI version. >=20 > The process to provide an alias to ``experimental`` is similar to that, > of :ref:`symbol versioning ` described above. > -- > 2.7.4