Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/73439/?format=api
{ "id": 73439, "url": "https://patches.dpdk.org/api/patches/73439/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/1594133126-2518-3-git-send-email-mdr@ashroe.eu/", "project": { "id": 1, "url": "https://patches.dpdk.org/api/projects/1/?format=api", "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", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<1594133126-2518-3-git-send-email-mdr@ashroe.eu>", "list_archive_url": "https://inbox.dpdk.org/dev/1594133126-2518-3-git-send-email-mdr@ashroe.eu", "date": "2020-07-07T14:45:24", "name": "[v1,2/2] doc: clarify alias to experimental period", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "3b987b8d699556c7f3948ceb6e0f6b952905c8ba", "submitter": { "id": 1310, "url": "https://patches.dpdk.org/api/people/1310/?format=api", "name": "Ray Kinsella", "email": "mdr@ashroe.eu" }, "delegate": { "id": 1, "url": "https://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "https://patches.dpdk.org/project/dpdk/patch/1594133126-2518-3-git-send-email-mdr@ashroe.eu/mbox/", "series": [ { "id": 10853, "url": "https://patches.dpdk.org/api/series/10853/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=10853", "date": "2020-07-07T14:45:22", "name": "doc: minor abi policy fixes", "version": 1, "mbox": "https://patches.dpdk.org/series/10853/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/73439/comments/", "check": "fail", "checks": "https://patches.dpdk.org/api/patches/73439/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 5DC65A00BE;\n\tTue, 7 Jul 2020 16:45:56 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 84DB41DE76;\n\tTue, 7 Jul 2020 16:45:47 +0200 (CEST)", "from dal2relay156.mxroute.com (dal2relay156.mxroute.com\n [64.40.26.156]) by dpdk.org (Postfix) with ESMTP id D6AFC1DE49\n for <dev@dpdk.org>; Tue, 7 Jul 2020 16:45:45 +0200 (CEST)", "from filter003.mxroute.com ([168.235.111.26]\n 168-235-111-26.cloud.ramnode.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by dal2relay156.mxroute.com (ZoneMTA) with ESMTPSA id 17329bd52da0005b7b.002\n for <dev@dpdk.org>\n (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES128-GCM-SHA256);\n Tue, 07 Jul 2020 14:45:40 +0000", "from echo.mxrouting.net (echo.mxrouting.net [116.202.222.109])\n by filter003.mxroute.com (Postfix) with ESMTPS id 430F46004E;\n Tue, 7 Jul 2020 14:45:39 +0000 (UTC)" ], "X-Zone-Loop": "34bb24f16af443b36d4f88839d026b933cef409fc634", "X-Originating-IP": "[168.235.111.26]", "From": "Ray Kinsella <mdr@ashroe.eu>", "To": "dev@dpdk.org", "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>", "Date": "Tue, 7 Jul 2020 15:45:24 +0100", "Message-Id": "<1594133126-2518-3-git-send-email-mdr@ashroe.eu>", "X-Mailer": "git-send-email 2.7.4", "In-Reply-To": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>", "X-AuthUser": "mdr@ashroe.eu", "Subject": "[dpdk-dev] [PATCH v1 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 <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@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 | 7 ++++---\n 1 file changed, 4 insertions(+), 3 deletions(-)", "diff": "diff --git a/doc/guides/contributing/abi_versioning.rst b/doc/guides/contributing/abi_versioning.rst\nindex 31a9205..e00dfa8 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-``experimental`` symbol version, so as not to break consuming applications.\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. This\n+alias will then typically be 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": [ "v1", "2/2" ] }