Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/134691/?format=api
{ "id": 134691, "url": "https://patches.dpdk.org/api/patches/134691/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/20231129152742.7984-1-stephen@networkplumber.org/", "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": "<20231129152742.7984-1-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20231129152742.7984-1-stephen@networkplumber.org", "date": "2023-11-29T15:27:38", "name": "doc: add sunset clause for experimental tag", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "6082e1764bc1b28ad2dc308f38784eb28e2104d3", "submitter": { "id": 27, "url": "https://patches.dpdk.org/api/people/27/?format=api", "name": "Stephen Hemminger", "email": "stephen@networkplumber.org" }, "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/20231129152742.7984-1-stephen@networkplumber.org/mbox/", "series": [ { "id": 30411, "url": "https://patches.dpdk.org/api/series/30411/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=30411", "date": "2023-11-29T15:27:38", "name": "doc: add sunset clause for experimental tag", "version": 1, "mbox": "https://patches.dpdk.org/series/30411/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/134691/comments/", "check": "success", "checks": "https://patches.dpdk.org/api/patches/134691/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 mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id B65BC43402;\n\tWed, 29 Nov 2023 16:27:56 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 39867409FA;\n\tWed, 29 Nov 2023 16:27:56 +0100 (CET)", "from mail-pl1-f173.google.com (mail-pl1-f173.google.com\n [209.85.214.173])\n by mails.dpdk.org (Postfix) with ESMTP id 573C6402CE\n for <dev@dpdk.org>; Wed, 29 Nov 2023 16:27:55 +0100 (CET)", "by mail-pl1-f173.google.com with SMTP id\n d9443c01a7336-1d00689f5c8so14490895ad.3\n for <dev@dpdk.org>; Wed, 29 Nov 2023 07:27:55 -0800 (PST)", "from hermes.local (204-195-123-141.wavecable.com. [204.195.123.141])\n by smtp.gmail.com with ESMTPSA id\n g8-20020a170902868800b001cfc6388b5dsm6791819plo.260.2023.11.29.07.27.52\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Wed, 29 Nov 2023 07:27:53 -0800 (PST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1701271674;\n x=1701876474; darn=dpdk.org;\n h=content-transfer-encoding:mime-version:message-id:date:subject:cc\n :to:from:from:to:cc:subject:date:message-id:reply-to;\n bh=WPQHPVcyZCrmajeK9z0awP1dVlXbCHR0fuYPMO7Cw4M=;\n b=pJLePay/O59wmI0mb6Uj/O2hgJh+HoWQGC908UVyyjY9vd5qzoSSa2ciau66PA78h4\n w/vINApG0EjCHioWPq6dlT1hsObn1lQMzKNAH/4HKMCpAKFurs9U9lpmirO5QNw+qzCh\n 0VjA0mv0rplpVedx0V1g33Rs6LlBQD1cVs1AJ3RnPNjhCP6mycNU6YOlBBRXA7rWEFf9\n eLc53nxTMBj54jVyIMvoFGsS/dRoTFI64dkHu/OC8fw1TRhDWE01ddrDq98i2R63m6uG\n VguQd9YUtLzRQpQpOGlnZsvICu5Ms5KVz/cvw0bbYzY8U8EoVf4DqrC5iAffKwnqVR5M\n nw/A==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20230601; t=1701271674; x=1701876474;\n h=content-transfer-encoding:mime-version:message-id:date:subject:cc\n :to:from:x-gm-message-state:from:to:cc:subject:date:message-id\n :reply-to;\n bh=WPQHPVcyZCrmajeK9z0awP1dVlXbCHR0fuYPMO7Cw4M=;\n b=A2xGIcE+nC1/x0SdNqeDHIM0vrbRxw8DfpCdZEuIkrVt+m0ZbU+1pBPIL6bPnGh6RN\n kHgxtutwJfAtBodaoEOWtmpGrqvNY45nzdEwsA5ag7oNOaoNXzWB+LBudtSzwHCwFDLm\n l6KJopNuDWPg/P8Udrk9U9o/v0OqhczZHGWG0NEG73MjYjvidcC96xscVA2EZsRkuxPA\n W7R559bbUeHFclXNP/mjxMhdAgBdG5FTMaQBW/3BO2t8oAUQqixxSWsoIRa3EgTGT8ow\n FhZwLLwgFznSUrF4F+UvtVlLIoQGE0Y5w/wGiQX2ClcTOo1qc/V1GmFnwAaPO8ovgB4N\n 7m/w==", "X-Gm-Message-State": "AOJu0Yx3PaZEx9cCffeWDJ6zjdg8vAO2TGYfvEsn+/N0Ddo0jOc8Ld94\n pk5kHLj4yZSme6ydB2+B1X0QDvyM56OkOdBTYh0=", "X-Google-Smtp-Source": "\n AGHT+IHmgJwYJamjf0prN5G671RbK6xC5JmT523mOg3eDcXOHTzHIW0RV6YhpW1o7f2mXT8l/lrF+Q==", "X-Received": "by 2002:a17:902:c94d:b0:1cf:dd05:b57c with SMTP id\n i13-20020a170902c94d00b001cfdd05b57cmr10272767pla.46.1701271673933;\n Wed, 29 Nov 2023 07:27:53 -0800 (PST)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <stephen@networkplumber.org>", "Subject": "[PATCH] doc: add sunset clause for experimental tag", "Date": "Wed, 29 Nov 2023 07:27:38 -0800", "Message-ID": "<20231129152742.7984-1-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.42.0", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "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" }, "content": "The experimental tag is intended as temporary to avoid having\nall of DPDK APIs as experimental and thereby rendering the\nstable policy as worthless.\n\nAdd some wording into the existing policy in doc.\n\nSigned-off-by: Stephen Hemminger <stephen@networkplumber.org>\n---\n doc/guides/contributing/abi_policy.rst | 10 ++++++++++\n 1 file changed, 10 insertions(+)", "diff": "diff --git a/doc/guides/contributing/abi_policy.rst b/doc/guides/contributing/abi_policy.rst\nindex 5fd405258592..fbf26ea24fd6 100644\n--- a/doc/guides/contributing/abi_policy.rst\n+++ b/doc/guides/contributing/abi_policy.rst\n@@ -328,6 +328,16 @@ new APIs and start finding issues with them, new DPDK APIs will be automatically\n marked as ``experimental`` to allow for a period of stabilization before they\n become part of a tracked ABI version.\n \n+The experimental tag has as limited lifetime (sunset provision).\n+It is expected to be removed in a future release.\n+The tag may be removed as soon as the second release with the new DPDK API.\n+After one year, the API must be stable and tag removed unless an\n+exception is approved by the technical board.\n+\n+For example, the symbol ``rte_flow_dev_dump`` was introduced\n+in 20.02 release as ``experimental``. The tag could have been removed\n+in 20.05 release, and should have been removed in 21.03 release.\n+\n Note that marking an API as experimental is a multi step process.\n To mark an API as experimental, the symbols which are desired to be exported\n must be placed in an EXPERIMENTAL version block in the corresponding libraries'\n", "prefixes": [] }