Patch Detail
Show a patch.
GET /api/patches/73463/
https://patches.dpdk.org/api/patches/73463/", "web_url": "https://patches.dpdk.org/patch/73463/", "project": { "id": 1, "url": "https://patches.dpdk.org/api/projects/1/", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk" }, "msgid": "<1594144262-5040-3-git-send-email-mdr@ashroe.eu>", "date": "2020-07-07T17:51:01", "name": "[v2,2/2] doc: clarify alias to experimental period", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "9e29fc8e42a60609f82deffcd3d2059833b5c925", "submitter": { "id": 1310, "url": "https://patches.dpdk.org/api/people/1310/", "name": "Kinsella, Ray", "email": "mdr@ashroe.eu" }, "delegate": { "id": 1, "url": "https://patches.dpdk.org/api/users/1/", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "https://patches.dpdk.org/patch/73463/mbox/", "series": [ { "id": 10862, "url": "https://patches.dpdk.org/api/series/10862/", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=10862", "date": "2020-07-07T17:51:00", "name": "doc: minor abi policy fixes", "version": 2, "mbox": "https://patches.dpdk.org/series/10862/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/73463/comments/", "check": "fail", "checks": "https://patches.dpdk.org/api/patches/73463/checks/", "tags": {}, "headers": { "X-Mailer": "git-send-email 2.7.4", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "From": "Ray Kinsella <mdr@ashroe.eu>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "Date": "Tue, 7 Jul 2020 18:51:01 +0100", "X-Mailman-Version": "2.1.15", "Delivered-To": "patchwork@inbox.dpdk.org", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "X-Originating-IP": "[149.28.56.236]", "Cc": "fady@mellanox.com, thomas@monjalon.net, Honnappa.Nagarahalli@arm.com,\n Ray Kinsella <mdr@ashroe.eu>, Neil Horman <nhorman@tuxdriver.com>,\n John McNamara <john.mcnamara@intel.com>,\n Marko Kovacevic <marko.kovacevic@intel.com>,\n Harini Ramakrishnan <harini.ramakrishnan@microsoft.com>,\n Omar Cardona <ocardona@microsoft.com>,\n Pallavi Kadam <pallavi.kadam@intel.com>,\n Ranjit Menon <ranjit.menon@intel.com>", "To": "dev@dpdk.org", "Errors-To": "dev-bounces@dpdk.org", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <1594144262-5040-1-git-send-email-mdr@ashroe.eu>", "Sender": "\"dev\" <dev-bounces@dpdk.org>", "List-Post": "<mailto:dev@dpdk.org>", "Return-Path": "<dev-bounces@dpdk.org>", "X-BeenThere": "dev@dpdk.org", "X-AuthUser": "mdr@ashroe.eu", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id A421CA00BE;\n\tTue, 7 Jul 2020 19:51:28 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 5D6011DECC;\n\tTue, 7 Jul 2020 19:51:21 +0200 (CEST)", "from qrelay216.mxroute.com (qrelay216.mxroute.com [172.82.139.216])\n by dpdk.org (Postfix) with ESMTP id 22BA81DECB\n for <dev@dpdk.org>; Tue, 7 Jul 2020 19:51:20 +0200 (CEST)", "from filter004.mxroute.com ([149.28.56.236] 149.28.56.236.vultr.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by qrelay216.mxroute.com (ZoneMTA) with ESMTPA id 1732a673e9500027dd.002\n for <dev@dpdk.org>; Tue, 07 Jul 2020 17:51:16 +0000", "from echo.mxrouting.net (echo.mxrouting.net [116.202.222.109])\n by filter004.mxroute.com (Postfix) with ESMTPS id 529993EDA8;\n Tue, 7 Jul 2020 17:51:15 +0000 (UTC)" ], "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "X-Zone-Loop": "966a081cec0689ff9066600571a497c490ba79eda2b3", "Subject": "[dpdk-dev] [PATCH v2 2/2] doc: clarify alias to experimental period", "In-Reply-To": "<1594144262-5040-1-git-send-email-mdr@ashroe.eu>", "Message-Id": "<1594144262-5040-3-git-send-email-mdr@ashroe.eu>", "Precedence": "list", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "X-Original-To": "patchwork@inbox.dpdk.org" }, "content": "Clarify retention period for aliases to experimental.\n\nSigned-off-by: Ray Kinsella <mdr@ashroe.eu>\n---\n doc/guides/contributing/abi_versioning.rst | 5 +++--\n 1 file changed, 3 insertions(+), 2 deletions(-)", "diff": "diff --git a/doc/guides/contributing/abi_versioning.rst b/doc/guides/contributing/abi_versioning.rst\nindex 31a9205..b1d09c7 100644\n--- a/doc/guides/contributing/abi_versioning.rst\n+++ b/doc/guides/contributing/abi_versioning.rst\n@@ -158,7 +158,7 @@ The macros exported are:\n * ``VERSION_SYMBOL_EXPERIMENTAL(b, e)``: Creates a symbol version table entry\n binding versioned symbol ``b@EXPERIMENTAL`` to the internal function ``be``.\n The macro is used when a symbol matures to become part of the stable ABI, to\n- provide an alias to experimental for some time.\n+ provide an alias to experimental until the next major ABI version.\n \n .. _example_abi_macro_usage:\n \n@@ -428,8 +428,9 @@ _____________________________\n \n In situations in which an ``experimental`` symbol has been stable for some time,\n and it becomes a candidate for promotion to the stable ABI. At this time, when\n-promoting the symbol, maintainer may choose to provide an alias to the\n+promoting the symbol, the maintainer may choose to provide an alias to the\n ``experimental`` symbol version, so as not to break consuming applications.\n+This alias is then dropped in the next major ABI version.\n \n The process to provide an alias to ``experimental`` is similar to that, of\n :ref:`symbol versioning <example_abi_macro_usage>` described above.\n", "prefixes": [ "v2", "2/2" ] }{ "id": 73463, "url": "