Patch Comment List
List patch comments
GET /api/patches/73439/comments/?format=api&order=-submitter
[ { "id": 115389, "web_url": "https://patches.dpdk.org/comment/115389/", "msgid": "<955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu>", "list_archive_url": "https://inbox.dpdk.org/dev/955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu", "date": "2020-07-07T16:35:13", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 1310, "url": "https://patches.dpdk.org/api/people/1310/?format=api", "name": "Ray Kinsella", "email": "mdr@ashroe.eu" }, "content": "On 07/07/2020 16:26, Thomas Monjalon wrote:\n> 07/07/2020 16:45, Ray Kinsella:\n>> Clarify retention period for aliases to experimental.\n>>\n>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n>> ---\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> Why limiting the period for experimental status?\n> Some API want to remain experimental longer.\n> \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> \n> Please start a sentence on a new line.\n\nACK\n\n> \n>> +alias will then typically be dropped in the next major ABI version.\n> \n> I don't see the need for the time estimation.\n> \n> \n\nWill reword to ...\n\n\"This alias will then be dropped in the next major ABI version.\"", "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 A68C2A00BE;\n\tTue, 7 Jul 2020 18:35:21 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 8D2471DD65;\n\tTue, 7 Jul 2020 18:35:21 +0200 (CEST)", "from dal2relay72.mxroute.com (dal2relay72.mxroute.com [64.40.26.72])\n by dpdk.org (Postfix) with ESMTP id 80A701DD3B\n for <dev@dpdk.org>; Tue, 7 Jul 2020 18:35:19 +0200 (CEST)", "from filter003.mxroute.com ([168.235.111.26]\n 168-235-111-26.cloud.ramnode.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by dal2relay72.mxroute.com (ZoneMTA) with ESMTPSA id 1732a21b1680005b7b.002\n for <dev@dpdk.org>\n (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES128-GCM-SHA256);\n Tue, 07 Jul 2020 16:35:17 +0000", "from echo.mxrouting.net (echo.mxrouting.net [116.202.222.109])\n by filter003.mxroute.com (Postfix) with ESMTPS id 8648060007;\n Tue, 7 Jul 2020 16:35:16 +0000 (UTC)" ], "X-Zone-Loop": "607373d220f5fc1352f9450002d29e89e87c3a5a9de2", "X-Originating-IP": "[168.235.111.26]", "To": "Thomas Monjalon <thomas@monjalon.net>", "Cc": "dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com,\n Neil Horman <nhorman@tuxdriver.com>, John McNamara\n <john.mcnamara@intel.com>, 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>, david.marchand@redhat.com,\n bruce.richardson@intel.com", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <1594133126-2518-3-git-send-email-mdr@ashroe.eu> <2116547.mo2HYodoZD@thomas>", "From": "\"Kinsella, Ray\" <mdr@ashroe.eu>", "Autocrypt": "addr=mdr@ashroe.eu; keydata=\n mQINBFv8B3wBEAC+5ImcgbIvadt3axrTnt7Sxch3FsmWTTomXfB8YiuHT8KL8L/bFRQSL1f6\n ASCHu3M89EjYazlY+vJUWLr0BhK5t/YI7bQzrOuYrl9K94vlLwzD19s/zB/g5YGGR5plJr0s\n JtJsFGEvF9LL3e+FKMRXveQxBB8A51nAHfwG0WSyx53d61DYz7lp4/Y4RagxaJoHp9lakn8j\n HV2N6rrnF+qt5ukj5SbbKWSzGg5HQF2t0QQ5tzWhCAKTfcPlnP0GymTBfNMGOReWivi3Qqzr\n S51Xo7hoGujUgNAM41sxpxmhx8xSwcQ5WzmxgAhJ/StNV9cb3HWIoE5StCwQ4uXOLplZNGnS\n uxNdegvKB95NHZjRVRChg/uMTGpg9PqYbTIFoPXjuk27sxZLRJRrueg4tLbb3HM39CJwSB++\n YICcqf2N+GVD48STfcIlpp12/HI+EcDSThzfWFhaHDC0hyirHxJyHXjnZ8bUexI/5zATn/ux\n TpMbc/vicJxeN+qfaVqPkCbkS71cHKuPluM3jE8aNCIBNQY1/j87k5ELzg3qaesLo2n1krBH\n bKvFfAmQuUuJT84/IqfdVtrSCTabvDuNBDpYBV0dGbTwaRfE7i+LiJJclUr8lOvHUpJ4Y6a5\n 0cxEPxm498G12Z3NoY/mP5soItPIPtLR0rA0fage44zSPwp6cQARAQABtBxSYXkgS2luc2Vs\n bGEgPG1kckBhc2hyb2UuZXU+iQJUBBMBCAA+FiEEcDUDlKDJaDuJlfZfdJdaH/sCCpsFAlv8\n B3wCGyMFCQlmAYAFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AACgkQdJdaH/sCCptdtRAAl0oE\n msa+djBVYLIsax+0f8acidtWg2l9f7kc2hEjp9h9aZCpPchQvhhemtew/nKavik3RSnLTAyn\n B3C/0GNlmvI1l5PFROOgPZwz4xhJKGN7jOsRrbkJa23a8ly5UXwF3Vqnlny7D3z+7cu1qq/f\n VRK8qFyWkAb+xgqeZ/hTcbJUWtW+l5Zb+68WGEp8hB7TuJLEWb4+VKgHTpQ4vElYj8H3Z94a\n 04s2PJMbLIZSgmKDASnyrKY0CzTpPXx5rSJ1q+B1FCsfepHLqt3vKSALa3ld6bJ8fSJtDUJ7\n JLiU8dFZrywgDIVme01jPbjJtUScW6jONLvhI8Z2sheR71UoKqGomMHNQpZ03ViVWBEALzEt\n TcjWgJFn8yAmxqM4nBnZ+hE3LbMo34KCHJD4eg18ojDt3s9VrDLa+V9fNxUHPSib9FD9UX/1\n +nGfU/ZABmiTuUDM7WZdXri7HaMpzDRJUKI6b+/uunF8xH/h/MHW16VuMzgI5dkOKKv1LejD\n dT5mA4R+2zBS+GsM0oa2hUeX9E5WwjaDzXtVDg6kYq8YvEd+m0z3M4e6diFeLS77/sAOgaYL\n 92UcoKD+Beym/fVuC6/55a0e12ksTmgk5/ZoEdoNQLlVgd2INtvnO+0k5BJcn66ZjKn3GbEC\n VqFbrnv1GnA58nEInRCTzR1k26h9nmS5Ag0EW/wHfAEQAMth1vHr3fOZkVOPfod3M6DkQir5\n xJvUW5EHgYUjYCPIa2qzgIVVuLDqZgSCCinyooG5dUJONVHj3nCbITCpJp4eB3PI84RPfDcC\n hf/V34N/Gx5mTeoymSZDBmXT8YtvV/uJvn+LvHLO4ZJdvq5ZxmDyxfXFmkm3/lLw0+rrNdK5\n pt6OnVlCqEU9tcDBezjUwDtOahyV20XqxtUttN4kQWbDRkhT+HrA9WN9l2HX91yEYC+zmF1S\n OhBqRoTPLrR6g4sCWgFywqztpvZWhyIicJipnjac7qL/wRS+wrWfsYy6qWLIV80beN7yoa6v\n ccnuy4pu2uiuhk9/edtlmFE4dNdoRf7843CV9k1yRASTlmPkU59n0TJbw+okTa9fbbQgbIb1\n pWsAuicRHyLUIUz4f6kPgdgty2FgTKuPuIzJd1s8s6p2aC1qo+Obm2gnBTduB+/n1Jw+vKpt\n 07d+CKEKu4CWwvZZ8ktJJLeofi4hMupTYiq+oMzqH+V1k6QgNm0Da489gXllU+3EFC6W1qKj\n tkvQzg2rYoWeYD1Qn8iXcO4Fpk6wzylclvatBMddVlQ6qrYeTmSbCsk+m2KVrz5vIyja0o5Y\n yfeN29s9emXnikmNfv/dA5fpi8XCANNnz3zOfA93DOB9DBf0TQ2/OrSPGjB3op7RCfoPBZ7u\n AjJ9dM7VABEBAAGJAjwEGAEIACYWIQRwNQOUoMloO4mV9l90l1of+wIKmwUCW/wHfAIbDAUJ\n CWYBgAAKCRB0l1of+wIKm3KlD/9w/LOG5rtgtCUWPl4B3pZvGpNym6XdK8cop9saOnE85zWf\n u+sKWCrxNgYkYP7aZrYMPwqDvilxhbTsIJl5HhPgpTO1b0i+c0n1Tij3EElj5UCg3q8mEc17\n c+5jRrY3oz77g7E3oPftAjaq1ybbXjY4K32o3JHFR6I8wX3m9wJZJe1+Y+UVrrjY65gZFxcA\n thNVnWKErarVQGjeNgHV4N1uF3pIx3kT1N4GSnxhoz4Bki91kvkbBhUgYfNflGURfZT3wIKK\n +d50jd7kqRouXUCzTdzmDh7jnYrcEFM4nvyaYu0JjSS5R672d9SK5LVIfWmoUGzqD4AVmUW8\n pcv461+PXchuS8+zpltR9zajl72Q3ymlT4BTAQOlCWkD0snBoKNUB5d2EXPNV13nA0qlm4U2\n GpROfJMQXjV6fyYRvttKYfM5xYKgRgtP0z5lTAbsjg9WFKq0Fndh7kUlmHjuAIwKIV4Tzo75\n QO2zC0/NTaTjmrtiXhP+vkC4pcrOGNsbHuaqvsc/ZZ0siXyYsqbctj/sCd8ka2r94u+c7o4l\n BGaAm+FtwAfEAkXHu4y5Phuv2IRR+x1wTey1U1RaEPgN8xq0LQ1OitX4t2mQwjdPihZQBCnZ\n wzOrkbzlJMNrMKJpEgulmxAHmYJKgvZHXZXtLJSejFjR0GdHJcL5rwVOMWB8cg==", "Message-ID": "<955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu>", "Date": "Tue, 7 Jul 2020 17:35:13 +0100", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101\n Thunderbird/68.10.0", "MIME-Version": "1.0", "In-Reply-To": "<2116547.mo2HYodoZD@thomas>", "Content-Type": "text/plain; charset=utf-8", "Content-Language": "en-US", "Content-Transfer-Encoding": "7bit", "X-AuthUser": "mdr@ashroe.eu", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115391, "web_url": "https://patches.dpdk.org/comment/115391/", "msgid": "<97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>", "list_archive_url": "https://inbox.dpdk.org/dev/97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu", "date": "2020-07-07T16:37:49", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 1310, "url": "https://patches.dpdk.org/api/people/1310/?format=api", "name": "Ray Kinsella", "email": "mdr@ashroe.eu" }, "content": "On 07/07/2020 17:36, Thomas Monjalon wrote:\n> 07/07/2020 18:35, Kinsella, Ray:\n>> On 07/07/2020 16:26, Thomas Monjalon wrote:\n>>> 07/07/2020 16:45, Ray Kinsella:\n>>>> Clarify retention period for aliases to experimental.\n>>>>\n>>>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n>>>> ---\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>>> Why limiting the period for experimental status?\n>>> Some API want to remain experimental longer.\n>>>\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>>>\n>>> Please start a sentence on a new line.\n>>\n>> ACK\n>>\n>>>\n>>>> +alias will then typically be dropped in the next major ABI version.\n>>>\n>>> I don't see the need for the time estimation.\n>>>\n>>>\n>>\n>> Will reword to ...\n>>\n>> \"This alias will then be dropped in the next major ABI version.\"\n> \n> It is not addressing my first comment. Please see above.\n> \n\nThank you, I don't necessarily agree with the first comment :-)\nWe need to say when the alias should be dropped no?", "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 8D128A00BE;\n\tTue, 7 Jul 2020 18:37:56 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 676841DD65;\n\tTue, 7 Jul 2020 18:37:56 +0200 (CEST)", "from dal3relay23.mxroute.com (dal3relay23.mxroute.com [64.40.27.23])\n by dpdk.org (Postfix) with ESMTP id 5DB181DCB9\n for <dev@dpdk.org>; Tue, 7 Jul 2020 18:37:55 +0200 (CEST)", "from filter004.mxroute.com ([149.28.56.236] 149.28.56.236.vultr.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by dal3relay23.mxroute.com (ZoneMTA) with ESMTPSA id 1732a24131d0005b7b.002\n for <dev@dpdk.org>\n (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES128-GCM-SHA256);\n Tue, 07 Jul 2020 16:37:54 +0000", "from echo.mxrouting.net (echo.mxrouting.net [116.202.222.109])\n by filter004.mxroute.com (Postfix) with ESMTPS id 0CA973EDA2;\n Tue, 7 Jul 2020 16:37:53 +0000 (UTC)" ], "X-Zone-Loop": "4055dec37fd0c9ba8bcb6f2046dbec865c98624a2ef1", "X-Originating-IP": "[149.28.56.236]", "To": "Thomas Monjalon <thomas@monjalon.net>", "Cc": "dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com,\n Neil Horman <nhorman@tuxdriver.com>, John McNamara\n <john.mcnamara@intel.com>, 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>, david.marchand@redhat.com,\n bruce.richardson@intel.com", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <2116547.mo2HYodoZD@thomas> <955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu>\n <3262308.1Tv495sWla@thomas>", "From": "\"Kinsella, Ray\" <mdr@ashroe.eu>", "Autocrypt": "addr=mdr@ashroe.eu; keydata=\n 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", "Message-ID": "<97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>", "Date": "Tue, 7 Jul 2020 17:37:49 +0100", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101\n Thunderbird/68.10.0", "MIME-Version": "1.0", "In-Reply-To": "<3262308.1Tv495sWla@thomas>", "Content-Type": "text/plain; charset=utf-8", "Content-Language": "en-US", "Content-Transfer-Encoding": "7bit", "X-AuthUser": "mdr@ashroe.eu", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115397, "web_url": "https://patches.dpdk.org/comment/115397/", "msgid": "<b605b1ae-042d-bbed-1dd7-a5406942e924@ashroe.eu>", "list_archive_url": "https://inbox.dpdk.org/dev/b605b1ae-042d-bbed-1dd7-a5406942e924@ashroe.eu", "date": "2020-07-07T17:01:17", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 1310, "url": "https://patches.dpdk.org/api/people/1310/?format=api", "name": "Ray Kinsella", "email": "mdr@ashroe.eu" }, "content": "On 07/07/2020 17:57, Thomas Monjalon wrote:\n> 07/07/2020 18:37, Kinsella, Ray:\n>>\n>> On 07/07/2020 17:36, Thomas Monjalon wrote:\n>>> 07/07/2020 18:35, Kinsella, Ray:\n>>>> On 07/07/2020 16:26, Thomas Monjalon wrote:\n>>>>> 07/07/2020 16:45, Ray Kinsella:\n>>>>>> Clarify retention period for aliases to experimental.\n>>>>>>\n>>>>>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n>>>>>> ---\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>>>>> Why limiting the period for experimental status?\n>>>>> Some API want to remain experimental longer.\n>>>>>\n>>>>> [...]\n>>>>>> +alias will then typically be dropped in the next major ABI version.\n>>>>>\n>>>>> I don't see the need for the time estimation.\n>>>>\n>>>> Will reword to ...\n>>>>\n>>>> \"This alias will then be dropped in the next major ABI version.\"\n>>>\n>>> It is not addressing my first comment. Please see above.\n>>\n>> Thank you, I don't necessarily agree with the first comment :-)\n> \n> You don't have to agree. But in this case we must discuss :-)\n> \n>> We need to say when the alias should be dropped no?\n> \n> I don't think so.\n> Until now, it is let to the appreciation of the maintainer.\n> If we want to change the rule, especially for experimental period,\n> it must be said clearly and debated.\n\nIt doesn't make _any_ sense to maintain an alias after the new ABI.\n\nThe alias is there to maintain ABI compatibility, \nthere is no reason to maintain compatibility in the new ABI - so it should be dropped", "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 639AFA00BE;\n\tTue, 7 Jul 2020 19:01:26 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 48DD71BFBF;\n\tTue, 7 Jul 2020 19:01:26 +0200 (CEST)", "from qrelay128.mxroute.com (qrelay128.mxroute.com [172.82.139.128])\n by dpdk.org (Postfix) with ESMTP id A503E4F9A\n for <dev@dpdk.org>; Tue, 7 Jul 2020 19:01:24 +0200 (CEST)", "from filter003.mxroute.com ([168.235.111.26]\n 168-235-111-26.cloud.ramnode.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by qrelay128.mxroute.com (ZoneMTA) with ESMTPA id 1732a398db400027dd.002\n for <dev@dpdk.org>; Tue, 07 Jul 2020 17:01:21 +0000", "from echo.mxrouting.net (echo.mxrouting.net [116.202.222.109])\n by filter003.mxroute.com (Postfix) with ESMTPS id C3B296269F;\n Tue, 7 Jul 2020 17:01:20 +0000 (UTC)" ], "X-Zone-Loop": "db7026383d4489f41adc9f9e0c7cec64e8dd6ce37f5d", "X-Originating-IP": "[168.235.111.26]", "To": "Thomas Monjalon <thomas@monjalon.net>", "Cc": "dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com,\n Neil Horman <nhorman@tuxdriver.com>, John McNamara\n <john.mcnamara@intel.com>, 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>, david.marchand@redhat.com,\n bruce.richardson@intel.com", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <3262308.1Tv495sWla@thomas> <97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>\n <3753229.KUAPmvbx1T@thomas>", "From": "\"Kinsella, Ray\" <mdr@ashroe.eu>", "Autocrypt": "addr=mdr@ashroe.eu; keydata=\n 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", "Message-ID": "<b605b1ae-042d-bbed-1dd7-a5406942e924@ashroe.eu>", "Date": "Tue, 7 Jul 2020 18:01:17 +0100", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101\n Thunderbird/68.10.0", "MIME-Version": "1.0", "In-Reply-To": "<3753229.KUAPmvbx1T@thomas>", "Content-Type": "text/plain; charset=utf-8", "Content-Language": "en-US", "Content-Transfer-Encoding": "7bit", "X-AuthUser": "mdr@ashroe.eu", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115398, "web_url": "https://patches.dpdk.org/comment/115398/", "msgid": "<726b8422-a2cc-8035-1b04-ecbd3b32fd7c@ashroe.eu>", "list_archive_url": "https://inbox.dpdk.org/dev/726b8422-a2cc-8035-1b04-ecbd3b32fd7c@ashroe.eu", "date": "2020-07-07T17:01:51", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 1310, "url": "https://patches.dpdk.org/api/people/1310/?format=api", "name": "Ray Kinsella", "email": "mdr@ashroe.eu" }, "content": "On 07/07/2020 18:00, Thomas Monjalon wrote:\n> 07/07/2020 18:55, Honnappa Nagarahalli:\n>>> On 07/07/2020 17:36, Thomas Monjalon wrote:\n>>>> 07/07/2020 18:35, Kinsella, Ray:\n>>>>> On 07/07/2020 16:26, Thomas Monjalon wrote:\n>>>>>> 07/07/2020 16:45, Ray Kinsella:\n>>>>>>> Clarify retention period for aliases to experimental.\n>>>>>>>\n>>>>>>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n>>>>>>> ---\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\n>>> table entry\n>>>>>>> binding versioned symbol ``b@EXPERIMENTAL`` to the internal\n>>> function ``be``.\n>>>>>>> The macro is used when a symbol matures to become part of the\n>>>>>>> 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>>>>>> Why limiting the period for experimental status?\n>>>>>> Some API want to remain experimental longer.\n>>\n>> This is not limiting the period.\n>> This is about how long VERSION_SYMBOL_EXPERIMENTAL should be in place\n>> for a symbol after the experimental tag is removed for the symbol.\n> \n> Oh wait, I was wrong. It is only about the alias which is set\n> AFTER the experimental period.\n> \n>>>>>> [...]\n>>>>>>> In situations in which an ``experimental`` symbol has been stable\n>>>>>>> for some time, and it becomes a candidate for promotion to the\n>>>>>>> stable ABI. At this time, when -promoting the symbol, maintainer\n>>>>>>> may choose to provide an alias to the -``experimental`` symbol version,\n>>> so as not to break consuming applications.\n>>>>>>> +promoting the symbol, the maintainer may choose to provide an\n>>>>>>> +alias to the ``experimental`` symbol version, so as not to break\n>>>>>>> +consuming applications. This\n>>>>>>\n>>>>>> Please start a sentence on a new line.\n>>>>>\n>>>>> ACK\n>>>>>\n>>>>>>\n>>>>>>> +alias will then typically be dropped in the next major ABI version.\n>>>>>>\n>>>>>> I don't see the need for the time estimation.\n>>\n>> I prefer this wording as it clarifying what should be done while creating a patch.\n> \n> Yes, after a second read, I am OK.\n> \nperfect, I will sort out the other bits.", "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 ADB33A00BE;\n\tTue, 7 Jul 2020 19:01:59 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 8B4E81DE7F;\n\tTue, 7 Jul 2020 19:01:59 +0200 (CEST)", "from dal1relay55.mxroute.com (dal1relay55.mxroute.com\n [199.181.239.55]) by dpdk.org (Postfix) with ESMTP id 0E0581DE7E\n for <dev@dpdk.org>; Tue, 7 Jul 2020 19:01:57 +0200 (CEST)", "from filter003.mxroute.com ([168.235.111.26]\n 168-235-111-26.cloud.ramnode.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by dal1relay55.mxroute.com (ZoneMTA) with ESMTPSA id 1732a3a113e0005b7b.003\n for <dev@dpdk.org>\n (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES128-GCM-SHA256);\n Tue, 07 Jul 2020 17:01:55 +0000", "from echo.mxrouting.net (echo.mxrouting.net [116.202.222.109])\n by filter003.mxroute.com (Postfix) with ESMTPS id 8186C60007;\n Tue, 7 Jul 2020 17:01:54 +0000 (UTC)" ], "X-Zone-Loop": "1975dd15c899d0d930cf4e593053ef3696e2d580e2d3", "X-Originating-IP": "[168.235.111.26]", "To": "Thomas Monjalon <thomas@monjalon.net>,\n Honnappa Nagarahalli <Honnappa.Nagarahalli@arm.com>", "Cc": "\"dev@dpdk.org\" <dev@dpdk.org>, \"fady@mellanox.com\" <fady@mellanox.com>,\n Neil Horman <nhorman@tuxdriver.com>, John McNamara\n <john.mcnamara@intel.com>, 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>,\n \"david.marchand@redhat.com\" <david.marchand@redhat.com>,\n \"bruce.richardson@intel.com\" <bruce.richardson@intel.com>, nd <nd@arm.com>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>\n <DB6PR0802MB221635326CD588F02F8D77E998660@DB6PR0802MB2216.eurprd08.prod.outlook.com>\n <1615812.mBlSNTTGHt@thomas>", "From": "\"Kinsella, Ray\" <mdr@ashroe.eu>", "Autocrypt": "addr=mdr@ashroe.eu; keydata=\n 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", "Message-ID": "<726b8422-a2cc-8035-1b04-ecbd3b32fd7c@ashroe.eu>", "Date": "Tue, 7 Jul 2020 18:01:51 +0100", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101\n Thunderbird/68.10.0", "MIME-Version": "1.0", "In-Reply-To": "<1615812.mBlSNTTGHt@thomas>", "Content-Type": "text/plain; charset=utf-8", "Content-Language": "en-US", "Content-Transfer-Encoding": "7bit", "X-AuthUser": "mdr@ashroe.eu", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115394, "web_url": "https://patches.dpdk.org/comment/115394/", "msgid": "<DB6PR0802MB221635326CD588F02F8D77E998660@DB6PR0802MB2216.eurprd08.prod.outlook.com>", "list_archive_url": "https://inbox.dpdk.org/dev/DB6PR0802MB221635326CD588F02F8D77E998660@DB6PR0802MB2216.eurprd08.prod.outlook.com", "date": "2020-07-07T16:55:33", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 1045, "url": "https://patches.dpdk.org/api/people/1045/?format=api", "name": "Honnappa Nagarahalli", "email": "honnappa.nagarahalli@arm.com" }, "content": "<snip>\n\n> Subject: Re: [PATCH v1 2/2] doc: clarify alias to experimental period\n> \n> \n> \n> On 07/07/2020 17:36, Thomas Monjalon wrote:\n> > 07/07/2020 18:35, Kinsella, Ray:\n> >> On 07/07/2020 16:26, Thomas Monjalon wrote:\n> >>> 07/07/2020 16:45, Ray Kinsella:\n> >>>> Clarify retention period for aliases to experimental.\n> >>>>\n> >>>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n> >>>> ---\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\n> table entry\n> >>>> binding versioned symbol ``b@EXPERIMENTAL`` to the internal\n> function ``be``.\n> >>>> The macro is used when a symbol matures to become part of the\n> >>>> 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> >>> Why limiting the period for experimental status?\n> >>> Some API want to remain experimental longer.\nThis is not limiting the period. This is about how long VERSION_SYMBOL_EXPERIMENTAL should be in place for a symbol after the experimental tag is removed for the symbol.\n\n> >>>\n> >>> [...]\n> >>>> In situations in which an ``experimental`` symbol has been stable\n> >>>> for some time, and it becomes a candidate for promotion to the\n> >>>> stable ABI. At this time, when -promoting the symbol, maintainer\n> >>>> may choose to provide an alias to the -``experimental`` symbol version,\n> so as not to break consuming applications.\n> >>>> +promoting the symbol, the maintainer may choose to provide an\n> >>>> +alias to the ``experimental`` symbol version, so as not to break\n> >>>> +consuming applications. This\n> >>>\n> >>> Please start a sentence on a new line.\n> >>\n> >> ACK\n> >>\n> >>>\n> >>>> +alias will then typically be dropped in the next major ABI version.\n> >>>\n> >>> I don't see the need for the time estimation.\nI prefer this wording as it clarifying what should be done while creating a patch.\n\n> >>>\n> >>>\n> >>\n> >> Will reword to ...\n> >>\n> >> \"This alias will then be dropped in the next major ABI version.\"\n> >\n> > It is not addressing my first comment. Please see above.\n> >\n> \n> Thank you, I don't necessarily agree with the first comment :-) We need to say\n> when the alias should be dropped no?", "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 6E6AEA00BE;\n\tTue, 7 Jul 2020 18:55:44 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 6F3FA1DE23;\n\tTue, 7 Jul 2020 18:55:43 +0200 (CEST)", "from EUR05-DB8-obe.outbound.protection.outlook.com\n (mail-db8eur05on2053.outbound.protection.outlook.com [40.107.20.53])\n by dpdk.org (Postfix) with ESMTP id 20D341DD9B\n for <dev@dpdk.org>; Tue, 7 Jul 2020 18:55:42 +0200 (CEST)", "from DB7PR05CA0028.eurprd05.prod.outlook.com (2603:10a6:10:36::41)\n by DB8PR08MB4043.eurprd08.prod.outlook.com (2603:10a6:10:a8::29) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.20; Tue, 7 Jul\n 2020 16:55:40 +0000", "from DB5EUR03FT054.eop-EUR03.prod.protection.outlook.com\n (2603:10a6:10:36:cafe::36) by DB7PR05CA0028.outlook.office365.com\n (2603:10a6:10:36::41) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3153.22 via Frontend\n Transport; Tue, 7 Jul 2020 16:55:40 +0000", "from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by\n DB5EUR03FT054.mail.protection.outlook.com (10.152.20.248) with\n Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.3153.24 via Frontend Transport; Tue, 7 Jul 2020 16:55:40 +0000", "(\"Tessian outbound 114f46c34313:v62\");\n Tue, 07 Jul 2020 16:55:40 +0000", "from 8ea67cd6b481.1\n by 64aa7808-outbound-1.mta.getcheckrecipient.com id\n DBE30FC3-04A7-427D-A255-2796CB611480.1;\n Tue, 07 Jul 2020 16:55:35 +0000", "from EUR03-DB5-obe.outbound.protection.outlook.com\n by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id\n 8ea67cd6b481.1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384);\n Tue, 07 Jul 2020 16:55:35 +0000", "from DB6PR0802MB2216.eurprd08.prod.outlook.com (2603:10a6:4:85::9)\n by DB6PR0801MB1829.eurprd08.prod.outlook.com (2603:10a6:4:39::23) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3153.21; Tue, 7 Jul\n 2020 16:55:33 +0000", "from DB6PR0802MB2216.eurprd08.prod.outlook.com\n ([fe80::9d1d:207b:e89d:199d]) by DB6PR0802MB2216.eurprd08.prod.outlook.com\n ([fe80::9d1d:207b:e89d:199d%10]) with mapi id 15.20.3153.029; Tue, 7 Jul 2020\n 16:55:33 +0000" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com;\n s=selector2-armh-onmicrosoft-com;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=rTDOBPN8nqC2P7lLtC7tq4TapSSUfAU3afH47qI+jF8=;\n b=uuI9MMzJGAZ9c38Ytkt1XovMnmQnM5IKqZ//kRU5jPLtf//dPRsaG5WOQUSygQKXn0jWVqqugnp6aRO7Ngf4ZwA9SkLIIrCm3qnmHd+eiM4ZyofVzcB21bYU7EFXciViDnuhWmUD8zyXIq7Pu6hPJKG6KAez2DS0k1SGAUpSjeA=", "v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com;\n s=selector2-armh-onmicrosoft-com;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=rTDOBPN8nqC2P7lLtC7tq4TapSSUfAU3afH47qI+jF8=;\n b=uuI9MMzJGAZ9c38Ytkt1XovMnmQnM5IKqZ//kRU5jPLtf//dPRsaG5WOQUSygQKXn0jWVqqugnp6aRO7Ngf4ZwA9SkLIIrCm3qnmHd+eiM4ZyofVzcB21bYU7EFXciViDnuhWmUD8zyXIq7Pu6hPJKG6KAez2DS0k1SGAUpSjeA=" ], "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 63.35.35.123)\n smtp.mailfrom=arm.com; dpdk.org; dkim=pass (signature was verified)\n header.d=armh.onmicrosoft.com;dpdk.org; dmarc=bestguesspass action=none\n header.from=arm.com;", "Received-SPF": "Pass (protection.outlook.com: domain of arm.com designates\n 63.35.35.123 as permitted sender) receiver=protection.outlook.com;\n client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com;", "X-CR-MTA-TID": "64aa7808", "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=EvTjtHHLVSEr34KtUZnCanV7eiLmUpKzoaTojVHCoq9KsQ4z/y7jFZVgLsHGE0G71rl7fscPnDJKt2KtyYD4KkkLtkSwMnFA/dlkVJexsuygKTE+ira/gl4SDJ8gy9/vfWwlK40MF7KBiF1dUPV9lqzyzZJrxE18AKTxjrCIduriyZBGDTQ/6TEO3UvnUgdHYGMxGyFnyMBYiA/fehqNhc9YCy5lKk0ymQvdUOk6NbOEvtCes3P9Rmydt7RtPB4IQjHHXqSNWyOtA/uQ0D7f+gmP/ciz3QtS6et/SzY47jlhKC5Ey09IfzLxJkZ7rBmxECZBUxKxl+BZKehQpUqkhw==", "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=rTDOBPN8nqC2P7lLtC7tq4TapSSUfAU3afH47qI+jF8=;\n b=W+k6QV131XwoMIkvJ92PeGsWywd8BPjwvFbkpcd+kWMlPdmOFIEKesTEAIblMbHVTsinHRW35KWnb+ZF5wpxObTi0kHb65usWVH0mDEGVy4b4SQjY04F474f4fUTD10nd50fiEGSkAkPKHwxuQxIJiCN9C+rkgg+DBb0i48SSStQog9QgJHr6IRyhPx9O/Df02BoPHsNCxWdAorigc9Ay7T2Q26+n6QzuHHDhnOAS1y5Lu6oqV1fXXAwTMbfzLjMpKmxKnxIKdyzjeYY8hkb0mIZg/0AVRrW5AJeoNKp2PKZ/YKUDIMO5xa4cFn11//1fH0Wpnqvid/Q5QsVDHO0qg==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass\n smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass\n header.d=arm.com; arc=none", "From": "Honnappa Nagarahalli <Honnappa.Nagarahalli@arm.com>", "To": "\"Kinsella, Ray\" <mdr@ashroe.eu>, \"thomas@monjalon.net\"\n <thomas@monjalon.net>", "CC": "\"dev@dpdk.org\" <dev@dpdk.org>, \"fady@mellanox.com\" <fady@mellanox.com>,\n Neil Horman <nhorman@tuxdriver.com>, John McNamara <john.mcnamara@intel.com>,\n Marko Kovacevic <marko.kovacevic@intel.com>, Harini Ramakrishnan\n <harini.ramakrishnan@microsoft.com>, Omar Cardona <ocardona@microsoft.com>,\n Pallavi Kadam <pallavi.kadam@intel.com>, Ranjit Menon\n <ranjit.menon@intel.com>, \"david.marchand@redhat.com\"\n <david.marchand@redhat.com>, \"bruce.richardson@intel.com\"\n <bruce.richardson@intel.com>, Honnappa Nagarahalli\n <Honnappa.Nagarahalli@arm.com>, nd <nd@arm.com>, nd <nd@arm.com>", "Thread-Topic": "[PATCH v1 2/2] doc: clarify alias to experimental period", "Thread-Index": "AQHWVG1UTzbHjAGJFEKQazFLj9J+9Kj8PR2AgAATNYCAAABlAIAAAFWAgAACfHA=", "Date": "Tue, 7 Jul 2020 16:55:33 +0000", "Message-ID": "\n <DB6PR0802MB221635326CD588F02F8D77E998660@DB6PR0802MB2216.eurprd08.prod.outlook.com>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <2116547.mo2HYodoZD@thomas> <955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu>\n <3262308.1Tv495sWla@thomas> <97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>", "In-Reply-To": "<97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>", "Accept-Language": "en-US", "Content-Language": "en-US", "X-MS-Has-Attach": "", "X-MS-TNEF-Correlator": "", "x-ts-tracking-id": "9e9dd684-1df8-4293-a8e8-d22011963f62.0", "x-checkrecipientchecked": "true", "Authentication-Results-Original": "ashroe.eu; dkim=none (message not signed)\n 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": "7afe46d6-043a-4a49-3876-08d822969480", "x-ms-traffictypediagnostic": "DB6PR0801MB1829:|DB8PR08MB4043:", "x-ld-processed": "f34e5979-57d9-4aaa-ad4d-b122a662184d,ExtAddr", "x-ms-exchange-transport-forked": "True", "X-Microsoft-Antispam-PRVS": "\n <DB8PR08MB40437BE36DC91C44C2E9A41298660@DB8PR08MB4043.eurprd08.prod.outlook.com>", "x-checkrecipientrouted": "true", "nodisclaimer": "true", "x-ms-oob-tlc-oobclassifiers": "OLM:9508;OLM:9508;", "x-forefront-prvs": "0457F11EAF", "X-MS-Exchange-SenderADCheck": "1", "X-Microsoft-Antispam-Untrusted": "BCL:0;", "X-Microsoft-Antispam-Message-Info-Original": "\n 8Q4G20Tm8IK6sGrv/hDCL+NB9pHf+Lt09dCXr5aztM/dYvMiRGGwnzYbYr5trloA7OPnCMRLebuaQ6Au/gjRz+Xm1DWK8kG2ILSYtfD4tQINSHmmFrsd1iBAeiSIX243599e6LySfs0WR3M0DgzmgpTitM5qsuMUuQpxbmezYbh+06Bc9g4v88z0keL5cFyVXN2TgmjrCsGbCokDn1Wujm3GEgs2MCj7pem6g+mn7O2ZpYqzj+7NjNcmGBwZpOLSHLAz0T6HxBIFeuYw4bZnmUii2qqcojyrI4QzOw7UEXLegYCspi1Eikol+X0UyVSWkzvdch9QHSmvRr5qKUdBvA==", "X-Forefront-Antispam-Report-Untrusted": "CIP:255.255.255.255; CTRY:; LANG:en;\n SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DB6PR0802MB2216.eurprd08.prod.outlook.com;\n PTR:; CAT:NONE; SFTY:;\n SFS:(4636009)(396003)(346002)(366004)(136003)(376002)(39860400002)(54906003)(33656002)(5660300002)(83380400001)(76116006)(478600001)(52536014)(110136005)(86362001)(7416002)(4326008)(316002)(186003)(7696005)(8936002)(8676002)(71200400001)(9686003)(26005)(55016002)(64756008)(66446008)(66946007)(66476007)(2906002)(6506007)(53546011)(66556008);\n DIR:OUT; SFP:1101;", "x-ms-exchange-antispam-messagedata": "\n ZqlSnVpjPCUGxs+nA37DNGrXEwzWp0v3wQVOXrt7WS1ohuSSNofkGByENtDmPd+V9T54Z86oMVpyqxV2NmOnsva33mlvEgEkisde2i4rVvaNKMckLjkv06QEYMqnHcGvNsS/p8HiyAnqag/K96EI2e9S8iV1VgZ20JruIQwX2RKBzTsnqf9KsrcPsAlCdqtudylzRhEXLvWBcq1NEly2RJhzaJqciuuTLwr5nA4R+CBldp4X7ZmhsLvLTdA4YgQ4MGQJjD0rok0Jnv0H3/he8C8hfqxHLEVFjeimyRqqJpSIm7XxMUcoOle5L1qU3bGQ9xhokz46MhoiqDihoXXRPq+RJUs0H66nH+IQnOL9uM3GllN68Q9GlSgsX/5QTCI+db1qWU7Oi817sBOoI5qobg6kgcAk2D+V/PT0PXBk5qV88HukIM8fx3aOInqGCxy6G4iFij3MQ3PFoWbBXmJvJcC3/su/gE9L0UNNIoQkX/PqTCl0seveEMth9NgBH5vI", "Content-Type": "text/plain; charset=\"utf-8\"", "Content-Transfer-Encoding": "base64", "MIME-Version": "1.0", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": [ "DB6PR0801MB1829", "DB8PR08MB4043" ], "Original-Authentication-Results": "ashroe.eu; dkim=none (message not signed)\n header.d=none;ashroe.eu; dmarc=none action=none header.from=arm.com;", "X-EOPAttributedMessage": "0", "X-MS-Exchange-Transport-CrossTenantHeadersStripped": "\n DB5EUR03FT054.eop-EUR03.prod.protection.outlook.com", "X-Forefront-Antispam-Report": "CIP:63.35.35.123; CTRY:IE; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:64aa7808-outbound-1.mta.getcheckrecipient.com;\n PTR:ec2-63-35-35-123.eu-west-1.compute.amazonaws.com; CAT:NONE; SFTY:;\n SFS:(4636009)(376002)(136003)(346002)(39860400002)(396003)(46966005)(8936002)(5660300002)(81166007)(8676002)(86362001)(356005)(33656002)(7696005)(82740400003)(52536014)(70586007)(70206006)(4326008)(47076004)(186003)(82310400002)(336012)(2906002)(83380400001)(6506007)(478600001)(26005)(53546011)(55016002)(316002)(54906003)(9686003)(110136005);\n DIR:OUT; SFP:1101;", "X-MS-Office365-Filtering-Correlation-Id-Prvs": "\n dcf0036c-be1b-4df7-6714-08d822969081", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n UWDu2pu3Q5y0qlQ/9qDCXVQyREMIr4u8s0l2gATg40ZUl/xrJKWpUy9yKtjtz1ov0DZ1/DpwSWOC6Wr8aILZw5wVGolKddPyNFF0w9B5bCAIwrqeLdJWDhrH3huul4vOwJtEQlnTp0LV5opKm2XDyP/s2LQWdV60wGWwe0j9VP92h3mEXyky8sAqZ1vulDucGFKm66neYOvt3BHF0aWCOZVndbvqtRgJSCsm9o0ZNVeTiaR/mRd3jTaIgaKlOudRRYYc/wbr/R6BlXnJn2MEUFHoIy2lZyGk6P8TrAXJuJQokG4p2a2r8QX0O8vxNAGTYvcSG2RxYnCCuIxNLZGIPrqK3GcKl0o3kgP77nJ6DkjORHxcJW4AvAwqb1f1dNSknIVKeqATBasd5eBhUSTJGg==", "X-OriginatorOrg": "arm.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "07 Jul 2020 16:55:40.4725 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 7afe46d6-043a-4a49-3876-08d822969480", "X-MS-Exchange-CrossTenant-Id": "f34e5979-57d9-4aaa-ad4d-b122a662184d", "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d; Ip=[63.35.35.123];\n Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com]", "X-MS-Exchange-CrossTenant-AuthSource": "\n DB5EUR03FT054.eop-EUR03.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115399, "web_url": "https://patches.dpdk.org/comment/115399/", "msgid": "<3268992.TtKfxP2iOo@thomas>", "list_archive_url": "https://inbox.dpdk.org/dev/3268992.TtKfxP2iOo@thomas", "date": "2020-07-07T17:08:22", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 685, "url": "https://patches.dpdk.org/api/people/685/?format=api", "name": "Thomas Monjalon", "email": "thomas@monjalon.net" }, "content": "07/07/2020 19:01, Kinsella, Ray:\n> On 07/07/2020 17:57, Thomas Monjalon wrote:\n> > 07/07/2020 18:37, Kinsella, Ray:\n> >> On 07/07/2020 17:36, Thomas Monjalon wrote:\n> >>> 07/07/2020 18:35, Kinsella, Ray:\n> >>>> On 07/07/2020 16:26, Thomas Monjalon wrote:\n> >>>>> 07/07/2020 16:45, Ray Kinsella:\n> >>>>>> Clarify retention period for aliases to experimental.\n> >>>>>>\n> >>>>>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n> >>>>>> ---\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> >>>>> Why limiting the period for experimental status?\n> >>>>> Some API want to remain experimental longer.\n> >>>>>\n> >>>>> [...]\n> >>>>>> +alias will then typically be dropped in the next major ABI version.\n> >>>>>\n> >>>>> I don't see the need for the time estimation.\n> >>>>\n> >>>> Will reword to ...\n> >>>>\n> >>>> \"This alias will then be dropped in the next major ABI version.\"\n> >>>\n> >>> It is not addressing my first comment. Please see above.\n> >>\n> >> Thank you, I don't necessarily agree with the first comment :-)\n> > \n> > You don't have to agree. But in this case we must discuss :-)\n> > \n> >> We need to say when the alias should be dropped no?\n> > \n> > I don't think so.\n> > Until now, it is let to the appreciation of the maintainer.\n> > If we want to change the rule, especially for experimental period,\n> > it must be said clearly and debated.\n> \n> It doesn't make _any_ sense to maintain an alias after the new ABI.\n> \n> The alias is there to maintain ABI compatibility, \n> there is no reason to maintain compatibility in the new ABI - so it should be dropped\n\nYes I was wrong, sorry.", "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 3D76AA00BE;\n\tTue, 7 Jul 2020 19:08:28 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 859731DE77;\n\tTue, 7 Jul 2020 19:08:27 +0200 (CEST)", "from new1-smtp.messagingengine.com (new1-smtp.messagingengine.com\n [66.111.4.221]) by dpdk.org (Postfix) with ESMTP id 53B1A1DE6E\n for <dev@dpdk.org>; Tue, 7 Jul 2020 19:08:26 +0200 (CEST)", "from compute7.internal (compute7.nyi.internal [10.202.2.47])\n by mailnew.nyi.internal (Postfix) with ESMTP id BD97D580421;\n Tue, 7 Jul 2020 13:08:25 -0400 (EDT)", "from mailfrontend2 ([10.202.2.163])\n by compute7.internal (MEProxy); Tue, 07 Jul 2020 13:08:25 -0400", "from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184])\n by mail.messagingengine.com (Postfix) with ESMTPA id B82A230600A6;\n Tue, 7 Jul 2020 13:08:23 -0400 (EDT)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h=\n from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding:content-type; s=fm1; bh=\n dYXa5YhOnHBagVMiYJYRhPU7jdq20uXzhhiaTCB9idM=; b=IRs9PbzFDnc6+dbi\n GNOP1kxviQ8eEpjIkmS/yU9qeLtlOojCEbcMK/lxx17tZ8m1uAVsQWxZQlTKcGYr\n SvnH5GJ0a/tzZ23ouofGAr0a8uWljgUMz2OF6UTPb1HmgqKmHS3Asw92duXSnfyS\n mssKgtCRbjwQHdZzjoD7cXA63p9+rYzx/1mV2E1WOFn4upBnUbaxF9BE2UdBGhr5\n bMnaMDlb37esUFP1FadEr2U1Y/tsUsmNEiz9i0uQNtNg3x2b2tMm3SHlV0TgzR+x\n lUhmYgJlc46KmR1HkiuL/rWsQj0ZAba7aVWUYIo/tlrFEQQKSJQJndNJOs+znPis\n WvZ00w==", "v=1; a=rsa-sha256; c=relaxed/relaxed; d=\n messagingengine.com; h=cc:content-transfer-encoding:content-type\n :date:from:in-reply-to:message-id:mime-version:references\n :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender\n :x-sasl-enc; s=fm3; bh=dYXa5YhOnHBagVMiYJYRhPU7jdq20uXzhhiaTCB9i\n dM=; b=Ssn163ylheH2sjkUBlTirgm/yAznDJdwg1uoqTmrRZhQYrmA171PUXbV5\n N3Dkdsd41wsXME3cx563O88V0ScwpCc1ctEKdnRr7HN8f6eSKnQqOiPbH0SexG3t\n bjKv0dYzDa4Aw5ibYG/t2nrkhgVyJdIXNQlQTvTdxmMd2opYNWxLstNJcfVFGBzw\n a6VriRXkWL+BnlTa3+qG5t72d289BFMpOJSTfoHf5awE5aT99qThLwCfDZJd9jLj\n CznNyTPCuWmzRIZdzUxf0HLqGeCns9PdIUpST3CPgtT3jAe43c1g3xDqCl2Qd7Nv\n zXwiPDiM5saO9Fhui267ahXpQX5Sg==" ], "X-ME-Sender": "<xms:CawEX05nLQo2B3LFFNnJ4-PtRr2kD7omBcfxAab5pKgdjoRkEiZa5w>", "X-ME-Proxy-Cause": "\n gggruggvucftvghtrhhoucdtuddrgeduiedrudehgddutdefucetufdoteggodetrfdotf\n fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen\n uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne\n cujfgurhephffvufffkfgjfhgggfgtsehtufertddttddvnecuhfhrohhmpefvhhhomhgr\n shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg\n ftrfgrthhtvghrnhepudeggfdvfeduffdtfeeglefghfeukefgfffhueejtdetuedtjeeu\n ieeivdffgeehnecukfhppeejjedrudefgedrvddtfedrudekgeenucevlhhushhtvghruf\n hiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghl\n ohhnrdhnvght", "X-ME-Proxy": "<xmx:CawEX14sA0g6WrMEeEq7gPwcX7Wk-_silDXQi7BJf6Okx9XBfFsxnQ>\n <xmx:CawEXzewPuWZ9-VDV3xzXmE6dSYRs2v1RzGxuv6-QjCduS_IMaKlWQ>\n <xmx:CawEX5LdmVfC0YRFaSh3HxW3zzAnMPhrMO_z5zczaySesYND-56IJQ>\n <xmx:CawEX9WGCbUhIrVCtcvsYo4VPbZHdQy7t3qWv8I8rWFqhUxkYGfu_g>", "From": "Thomas Monjalon <thomas@monjalon.net>", "To": "\"Kinsella, Ray\" <mdr@ashroe.eu>", "Cc": "dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com,\n Neil Horman <nhorman@tuxdriver.com>, 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>, david.marchand@redhat.com,\n bruce.richardson@intel.com", "Date": "Tue, 07 Jul 2020 19:08:22 +0200", "Message-ID": "<3268992.TtKfxP2iOo@thomas>", "In-Reply-To": "<b605b1ae-042d-bbed-1dd7-a5406942e924@ashroe.eu>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <3753229.KUAPmvbx1T@thomas> <b605b1ae-042d-bbed-1dd7-a5406942e924@ashroe.eu>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "7Bit", "Content-Type": "text/plain; charset=\"us-ascii\"", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115390, "web_url": "https://patches.dpdk.org/comment/115390/", "msgid": "<3262308.1Tv495sWla@thomas>", "list_archive_url": "https://inbox.dpdk.org/dev/3262308.1Tv495sWla@thomas", "date": "2020-07-07T16:36:38", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 685, "url": "https://patches.dpdk.org/api/people/685/?format=api", "name": "Thomas Monjalon", "email": "thomas@monjalon.net" }, "content": "07/07/2020 18:35, Kinsella, Ray:\n> On 07/07/2020 16:26, Thomas Monjalon wrote:\n> > 07/07/2020 16:45, Ray Kinsella:\n> >> Clarify retention period for aliases to experimental.\n> >>\n> >> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n> >> ---\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> > Why limiting the period for experimental status?\n> > Some API want to remain experimental longer.\n> > \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> > \n> > Please start a sentence on a new line.\n> \n> ACK\n> \n> > \n> >> +alias will then typically be dropped in the next major ABI version.\n> > \n> > I don't see the need for the time estimation.\n> > \n> > \n> \n> Will reword to ...\n> \n> \"This alias will then be dropped in the next major ABI version.\"\n\nIt is not addressing my first comment. Please see above.", "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 305C6A00BE;\n\tTue, 7 Jul 2020 18:36:46 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 05B651DD89;\n\tTue, 7 Jul 2020 18:36:46 +0200 (CEST)", "from new3-smtp.messagingengine.com (new3-smtp.messagingengine.com\n [66.111.4.229]) by dpdk.org (Postfix) with ESMTP id 3B2301DD3B\n for <dev@dpdk.org>; Tue, 7 Jul 2020 18:36:44 +0200 (CEST)", "from compute7.internal (compute7.nyi.internal [10.202.2.47])\n by mailnew.nyi.internal (Postfix) with ESMTP id 80566580251;\n Tue, 7 Jul 2020 12:36:42 -0400 (EDT)", "from mailfrontend1 ([10.202.2.162])\n by compute7.internal (MEProxy); Tue, 07 Jul 2020 12:36:42 -0400", "from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184])\n by mail.messagingengine.com (Postfix) with ESMTPA id 1E7EE3280066;\n Tue, 7 Jul 2020 12:36:40 -0400 (EDT)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h=\n from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding:content-type; s=fm1; bh=\n fdfMsHdiVc+i8m/ZG4RRecMbZMLc73q52JCh7Iw7Wxk=; b=CPkHitaaSXkGP0hZ\n MYnURewh3Swx5of13/8JnhCIEr+t1tytlgDlVrBaAqPLNy2pvPUUFnBD1VTSXiKG\n q7dDWxBMKvhRXlZWYXmpztgZ/RQgFaABdLJEQmAZbEYDgmiiaz/8ehYV9f32z7+o\n UKl+zsRp7rGfeae88IBpbKgKotPWPU0cA7fw6TU8Dx9xsT5qTzVTLRcAL1c1Y0xS\n JuVCCnc7juKUAPV+muIzmB0umGB/qpc7pFSJLmZT03ty1ZSkLg0/VbWiXH6aTVLg\n mPRDt6x7qmLpnzzfd0WIXB9N3utA/8tZjP7RmjZ8vGZRVyo2MCFR0VpuevPZN5oN\n pd0dbw==", "v=1; a=rsa-sha256; c=relaxed/relaxed; d=\n messagingengine.com; h=cc:content-transfer-encoding:content-type\n :date:from:in-reply-to:message-id:mime-version:references\n :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender\n :x-sasl-enc; s=fm3; bh=fdfMsHdiVc+i8m/ZG4RRecMbZMLc73q52JCh7Iw7W\n xk=; b=O4tITgYXLJGr1eh98IY/6XEyNCL6jjXLkn0VtdQA3r2tWBzyB9OiXUCyy\n 1SHrdun62PFr8IeSN/lMtjaE6BZ5c0RgdwyLdHEJQxOlHOB3rWwdVJ99DNNLWzeb\n VqeXs6Rvjfxd2TLNeoSuBWu2MDCH4FebBFmjiSBHd/vXiCrqLmTFRCg5ycfmLJ0+\n N2JcC4u5V1iIAzWbdK9fkSBZWxPyN84m7YYH4n2byiDeyHh9/0LLKF9g9Co+BI66\n gL8e+2T6h8ar2sVDnvoofJ7f0Ybib2R39NL3af5qSbgHQiTx2Xb8XKNgosbaZ8L+\n Lq3zq+B9wWYggj5IsB+7u+3L66bVw==" ], "X-ME-Sender": "<xms:maQEXxsVQXyNket5SKYbLB16BTDYmsnYqRrBlFU03MZOOEvwuj97kA>", "X-ME-Proxy-Cause": "\n gggruggvucftvghtrhhoucdtuddrgeduiedrudehgdeljecutefuodetggdotefrodftvf\n curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu\n uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc\n fjughrpefhvffufffkjghfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhmrghs\n ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucggtf\n frrghtthgvrhhnpedugefgvdefudfftdefgeelgffhueekgfffhfeujedtteeutdejueei\n iedvffegheenucfkphepjeejrddufeegrddvtdefrddukeegnecuvehluhhsthgvrhfuih\n iivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhho\n nhdrnhgvth", "X-ME-Proxy": "<xmx:maQEX6dahod0K8LJGJm_RalaAIJ5Yzs9s6GIbV4jMsNBORMv3sNW_A>\n <xmx:maQEX0z7-sSx4-ZZ6sTbpyjPmt5RFhke7TZY6FqU9czvr_cPSdvjRA>\n <xmx:maQEX4OzljOPWYlPsjSGNCVtv4UaMaa63JhHWzHHtX9cfXvc3yzWsg>\n <xmx:mqQEXwa7G9s26ZKcfeT_cUx5_0d7JeyWtZrCPtHdSUre39j0U3Ozag>", "From": "Thomas Monjalon <thomas@monjalon.net>", "To": "\"Kinsella, Ray\" <mdr@ashroe.eu>", "Cc": "dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com,\n Neil Horman <nhorman@tuxdriver.com>, 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>, david.marchand@redhat.com,\n bruce.richardson@intel.com", "Date": "Tue, 07 Jul 2020 18:36:38 +0200", "Message-ID": "<3262308.1Tv495sWla@thomas>", "In-Reply-To": "<955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <2116547.mo2HYodoZD@thomas> <955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "7Bit", "Content-Type": "text/plain; charset=\"us-ascii\"", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115395, "web_url": "https://patches.dpdk.org/comment/115395/", "msgid": "<3753229.KUAPmvbx1T@thomas>", "list_archive_url": "https://inbox.dpdk.org/dev/3753229.KUAPmvbx1T@thomas", "date": "2020-07-07T16:57:09", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 685, "url": "https://patches.dpdk.org/api/people/685/?format=api", "name": "Thomas Monjalon", "email": "thomas@monjalon.net" }, "content": "07/07/2020 18:37, Kinsella, Ray:\n> \n> On 07/07/2020 17:36, Thomas Monjalon wrote:\n> > 07/07/2020 18:35, Kinsella, Ray:\n> >> On 07/07/2020 16:26, Thomas Monjalon wrote:\n> >>> 07/07/2020 16:45, Ray Kinsella:\n> >>>> Clarify retention period for aliases to experimental.\n> >>>>\n> >>>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n> >>>> ---\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> >>> Why limiting the period for experimental status?\n> >>> Some API want to remain experimental longer.\n> >>>\n> >>> [...]\n> >>>> +alias will then typically be dropped in the next major ABI version.\n> >>>\n> >>> I don't see the need for the time estimation.\n> >>\n> >> Will reword to ...\n> >>\n> >> \"This alias will then be dropped in the next major ABI version.\"\n> > \n> > It is not addressing my first comment. Please see above.\n> \n> Thank you, I don't necessarily agree with the first comment :-)\n\nYou don't have to agree. But in this case we must discuss :-)\n\n> We need to say when the alias should be dropped no?\n\nI don't think so.\nUntil now, it is let to the appreciation of the maintainer.\nIf we want to change the rule, especially for experimental period,\nit must be said clearly and debated.", "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 8995CA00BE;\n\tTue, 7 Jul 2020 18:57:15 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 542511DE23;\n\tTue, 7 Jul 2020 18:57:15 +0200 (CEST)", "from new1-smtp.messagingengine.com (new1-smtp.messagingengine.com\n [66.111.4.221]) by dpdk.org (Postfix) with ESMTP id B3B4A1DD9B\n for <dev@dpdk.org>; Tue, 7 Jul 2020 18:57:13 +0200 (CEST)", "from compute7.internal (compute7.nyi.internal [10.202.2.47])\n by mailnew.nyi.internal (Postfix) with ESMTP id EFA8D580451;\n Tue, 7 Jul 2020 12:57:12 -0400 (EDT)", "from mailfrontend2 ([10.202.2.163])\n by compute7.internal (MEProxy); Tue, 07 Jul 2020 12:57:12 -0400", "from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184])\n by mail.messagingengine.com (Postfix) with ESMTPA id B3A8A30600A6;\n Tue, 7 Jul 2020 12:57:10 -0400 (EDT)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h=\n from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding:content-type; s=fm1; bh=\n 6yHOVQjxUhG10sBPyWP1Gcz6g60Do23FIBxQqe48BXo=; b=hBMubwCz2cl/UxVS\n 52Mk9We70Pms3CeEH0PJ9wRJsn2tXbrRUjIlCAj36igxeZmicUyB8o9O5fjsputc\n HxPUZ7X35jjUn5daFpZlmpmisfHOhlcFnhc/j9IQW4xdqxZBXzJs58RCSYGCiRq/\n LgBuM88qMb1oAmJQI9mGn7bkoguyZIlsfiNwwYeM1gnKVKRWlr7OXJ3TYHw0nj2w\n VS3M1Nay76xBkunIywCoVprita4RPGb0De4egBtOegC9dejELWw1JMThPSAdpIyl\n mvXf32N4WSwBj9CZ5YJc1hV7u7LKarhiTWDvS+pZ+oM9qJY/lpOQwct08rC8hUb/\n 9LsyBw==", "v=1; a=rsa-sha256; c=relaxed/relaxed; d=\n messagingengine.com; h=cc:content-transfer-encoding:content-type\n :date:from:in-reply-to:message-id:mime-version:references\n :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender\n :x-sasl-enc; s=fm3; bh=6yHOVQjxUhG10sBPyWP1Gcz6g60Do23FIBxQqe48B\n Xo=; b=rajVpjZ6oPpExqcFdj/m6+SFmovfUdi+XvLsMC4JGwrxKglRbWOQL4MpH\n ZkjAcoD4SH7DrIPm4XWJ0z3NqYvSLlumNWF1sppcfkK64/ybYpTxlH6/qozRqwuC\n Wl5ebCW9mjUjQGYLViKNZKSJtv86KIyMnD5kxRFYG21oHeKtq23UgvIPiecoJ1IZ\n LR2HgSTf13/OPtjsG58rqu4CkwWgl0qtNSkpUiqppwjQa4wPyZMbjqPiTRU4qAJD\n T0lvhtYb0XAw/L7R2P5uDCP1ldiSrB8e5IdSKcwoWXpd+yHWGOHreUCGjwAcDAad\n h2TYySUAMLeuTUdCEpE6G5R+VrYzw==" ], "X-ME-Sender": "<xms:aKkEXyBqeFlM-vljgmsdSLqlhM_ivKCCHvpeRv5hir2BUpCFZK8ArA>", "X-ME-Proxy-Cause": "\n gggruggvucftvghtrhhoucdtuddrgeduiedrudehgddutdduucetufdoteggodetrfdotf\n fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen\n uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne\n cujfgurhephffvufffkfgjfhgggfgtsehtufertddttddvnecuhfhrohhmpefvhhhomhgr\n shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg\n ftrfgrthhtvghrnhepudeggfdvfeduffdtfeeglefghfeukefgfffhueejtdetuedtjeeu\n ieeivdffgeehnecukfhppeejjedrudefgedrvddtfedrudekgeenucevlhhushhtvghruf\n hiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghl\n ohhnrdhnvght", "X-ME-Proxy": "<xmx:aKkEX8gLFCVXOEDl7RsZm9Ph-k0OBg3qGkPoAeH908UiCGYHd7g9Mw>\n <xmx:aKkEX1kM3w_zqRM8a1TxJii7wYephD-7qCpnuGM8XiixFvIhWtPLQw>\n <xmx:aKkEXwyk__uG2AImGzOYs2S5wIB9CeVJuQZzGeuLZ_S7C2h2cx0Ebw>\n <xmx:aKkEX8_fte0-hasQ5FBd94DEQQOehjpcWtyOg1mrqTiOuDAOnDXMZQ>", "From": "Thomas Monjalon <thomas@monjalon.net>", "To": "\"Kinsella, Ray\" <mdr@ashroe.eu>", "Cc": "dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com,\n Neil Horman <nhorman@tuxdriver.com>, 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>, david.marchand@redhat.com,\n bruce.richardson@intel.com", "Date": "Tue, 07 Jul 2020 18:57:09 +0200", "Message-ID": "<3753229.KUAPmvbx1T@thomas>", "In-Reply-To": "<97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <3262308.1Tv495sWla@thomas> <97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "7Bit", "Content-Type": "text/plain; charset=\"us-ascii\"", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115396, "web_url": "https://patches.dpdk.org/comment/115396/", "msgid": "<1615812.mBlSNTTGHt@thomas>", "list_archive_url": "https://inbox.dpdk.org/dev/1615812.mBlSNTTGHt@thomas", "date": "2020-07-07T17:00:41", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 685, "url": "https://patches.dpdk.org/api/people/685/?format=api", "name": "Thomas Monjalon", "email": "thomas@monjalon.net" }, "content": "07/07/2020 18:55, Honnappa Nagarahalli:\n> > On 07/07/2020 17:36, Thomas Monjalon wrote:\n> > > 07/07/2020 18:35, Kinsella, Ray:\n> > >> On 07/07/2020 16:26, Thomas Monjalon wrote:\n> > >>> 07/07/2020 16:45, Ray Kinsella:\n> > >>>> Clarify retention period for aliases to experimental.\n> > >>>>\n> > >>>> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n> > >>>> ---\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\n> > table entry\n> > >>>> binding versioned symbol ``b@EXPERIMENTAL`` to the internal\n> > function ``be``.\n> > >>>> The macro is used when a symbol matures to become part of the\n> > >>>> 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> > >>> Why limiting the period for experimental status?\n> > >>> Some API want to remain experimental longer.\n> \n> This is not limiting the period.\n> This is about how long VERSION_SYMBOL_EXPERIMENTAL should be in place\n> for a symbol after the experimental tag is removed for the symbol.\n\nOh wait, I was wrong. It is only about the alias which is set\nAFTER the experimental period.\n\n> > >>> [...]\n> > >>>> In situations in which an ``experimental`` symbol has been stable\n> > >>>> for some time, and it becomes a candidate for promotion to the\n> > >>>> stable ABI. At this time, when -promoting the symbol, maintainer\n> > >>>> may choose to provide an alias to the -``experimental`` symbol version,\n> > so as not to break consuming applications.\n> > >>>> +promoting the symbol, the maintainer may choose to provide an\n> > >>>> +alias to the ``experimental`` symbol version, so as not to break\n> > >>>> +consuming applications. This\n> > >>>\n> > >>> Please start a sentence on a new line.\n> > >>\n> > >> ACK\n> > >>\n> > >>>\n> > >>>> +alias will then typically be dropped in the next major ABI version.\n> > >>>\n> > >>> I don't see the need for the time estimation.\n> \n> I prefer this wording as it clarifying what should be done while creating a patch.\n\nYes, after a second read, I am OK.", "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 634CCA00BE;\n\tTue, 7 Jul 2020 19:00:47 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id D28E11D426;\n\tTue, 7 Jul 2020 19:00:46 +0200 (CEST)", "from new1-smtp.messagingengine.com (new1-smtp.messagingengine.com\n [66.111.4.221]) by dpdk.org (Postfix) with ESMTP id 8E72A4F9A\n for <dev@dpdk.org>; Tue, 7 Jul 2020 19:00:45 +0200 (CEST)", "from compute7.internal (compute7.nyi.internal [10.202.2.47])\n by mailnew.nyi.internal (Postfix) with ESMTP id 34B4358045F;\n Tue, 7 Jul 2020 13:00:44 -0400 (EDT)", "from mailfrontend1 ([10.202.2.162])\n by compute7.internal (MEProxy); Tue, 07 Jul 2020 13:00:44 -0400", "from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184])\n by mail.messagingengine.com (Postfix) with ESMTPA id 7A08A328006A;\n Tue, 7 Jul 2020 13:00:42 -0400 (EDT)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h=\n from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding:content-type; s=fm1; bh=\n RYHAdUwxCao7E343KC9pvEovA9n9sGgHGGee3aZmX6Y=; b=QmnkHxijwlK01QFD\n +nKi3FChYqODW1mg4ew9RftL1oZcbwiDDMai3FBBiYSS5W+D5Z1cjtf791SWZk61\n UFt9C8Yn98/uvIJLifWXMkKE5UJM0ymLGgsFgWWMNSByyJb+vO0lWwZ8itqaykLu\n miqtXI8YHNkzBMmpkbGCzaqN6EEKl8XcDva3G+oYTwN3esbJAOHt7Y4PMmxEgzYj\n xJtsG+Pg1S0Yza6iQCG/zxV0x4ffyPKl2fbWRdtahlItSWCZT5fgDZ+VGPQgiO9G\n IlLgK6OvohxyTL2pSLBDh1h2fun4P5am8ZV04aDcPmFRdD+IXuZXHWCLx6ICl91P\n kOtOKA==", "v=1; a=rsa-sha256; c=relaxed/relaxed; d=\n messagingengine.com; h=cc:content-transfer-encoding:content-type\n :date:from:in-reply-to:message-id:mime-version:references\n :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender\n :x-sasl-enc; s=fm3; bh=RYHAdUwxCao7E343KC9pvEovA9n9sGgHGGee3aZmX\n 6Y=; b=IuzxKBnB6qcrRyfmmXeSHRW4ujpMNIgV/Si+Gg59G5PG49dgWG91AESW9\n PYecsmnuqv9ufce2GyNBdfIGy4cT849WumrLWTgqjcWRo6v3kExa1l20S9wGD7Y8\n XUSp03HtwIMczTsFvVrVXoF97AP5UAVQcNiSMBN6q3QmOJqbp2CzCHhkC7l1mV+q\n asD5+itS9ocyH5Igw5Y+nnDIktLEnVlzSrCWw0tHY8VGaSPik4fhneNAaaQ3CdOe\n ul1YjTuQE489IGej76MSf/QJHgb4MsiAup8IB+0snjLyJ5ozjKwSuhOK1/kC4L/N\n TiFGKq3II9uIS7bQMoGnChJNMUJLQ==" ], "X-ME-Sender": "<xms:O6oEX576QO_G_z6UtqeuSV25_6CUbkuqdnGH6frgSyjtXRu2vinfBA>", "X-ME-Proxy-Cause": "\n gggruggvucftvghtrhhoucdtuddrgeduiedrudehgddutddvucetufdoteggodetrfdotf\n fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen\n uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne\n cujfgurhephffvufffkfgjfhgggfgtsehtufertddttddvnecuhfhrohhmpefvhhhomhgr\n shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg\n ftrfgrthhtvghrnhepudeggfdvfeduffdtfeeglefghfeukefgfffhueejtdetuedtjeeu\n ieeivdffgeehnecukfhppeejjedrudefgedrvddtfedrudekgeenucevlhhushhtvghruf\n hiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghl\n ohhnrdhnvght", "X-ME-Proxy": "<xmx:O6oEX27FcpWjhGY6FZUcVR6STW5jm1tlKDwvcT2V7UnZqkwAM3KJFg>\n <xmx:O6oEXwc8BxyvnDSWhgYL7iDZkxH0eULhzA6rElJBwtyBt1sMJDFxDg>\n <xmx:O6oEXyJFWhyYvZ-dVktjacKL6ilPJxmdzLIrFc0zoUcY0uIglwiH2Q>\n <xmx:PKoEX6DqJTVKBG4ClmTNZMnl-fvPDukShmmDSaUwLCtv8O3Y_10Sjw>", "From": "Thomas Monjalon <thomas@monjalon.net>", "To": "\"Kinsella, Ray\" <mdr@ashroe.eu>,\n Honnappa Nagarahalli <Honnappa.Nagarahalli@arm.com>", "Cc": "\"dev@dpdk.org\" <dev@dpdk.org>, \"fady@mellanox.com\" <fady@mellanox.com>,\n Neil Horman <nhorman@tuxdriver.com>, 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>,\n \"david.marchand@redhat.com\" <david.marchand@redhat.com>,\n \"bruce.richardson@intel.com\" <bruce.richardson@intel.com>, nd <nd@arm.com>", "Date": "Tue, 07 Jul 2020 19:00:41 +0200", "Message-ID": "<1615812.mBlSNTTGHt@thomas>", "In-Reply-To": "\n <DB6PR0802MB221635326CD588F02F8D77E998660@DB6PR0802MB2216.eurprd08.prod.outlook.com>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu>\n <DB6PR0802MB221635326CD588F02F8D77E998660@DB6PR0802MB2216.eurprd08.prod.outlook.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "7Bit", "Content-Type": "text/plain; charset=\"us-ascii\"", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null }, { "id": 115382, "web_url": "https://patches.dpdk.org/comment/115382/", "msgid": "<2116547.mo2HYodoZD@thomas>", "list_archive_url": "https://inbox.dpdk.org/dev/2116547.mo2HYodoZD@thomas", "date": "2020-07-07T15:26:29", "subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "submitter": { "id": 685, "url": "https://patches.dpdk.org/api/people/685/?format=api", "name": "Thomas Monjalon", "email": "thomas@monjalon.net" }, "content": "07/07/2020 16:45, Ray Kinsella:\n> Clarify retention period for aliases to experimental.\n> \n> Signed-off-by: Ray Kinsella <mdr@ashroe.eu>\n> ---\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\nWhy limiting the period for experimental status?\nSome API want to remain experimental longer.\n\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\nPlease start a sentence on a new line.\n\n> +alias will then typically be dropped in the next major ABI version.\n\nI don't see the need for the time estimation.", "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 3F713A00BE;\n\tTue, 7 Jul 2020 17:26:35 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 7BBE01DE74;\n\tTue, 7 Jul 2020 17:26:34 +0200 (CEST)", "from new3-smtp.messagingengine.com (new3-smtp.messagingengine.com\n [66.111.4.229]) by dpdk.org (Postfix) with ESMTP id 88D251DDD8\n for <dev@dpdk.org>; Tue, 7 Jul 2020 17:26:32 +0200 (CEST)", "from compute7.internal (compute7.nyi.internal [10.202.2.47])\n by mailnew.nyi.internal (Postfix) with ESMTP id 1E9C15801D1;\n Tue, 7 Jul 2020 11:26:32 -0400 (EDT)", "from mailfrontend2 ([10.202.2.163])\n by compute7.internal (MEProxy); Tue, 07 Jul 2020 11:26:32 -0400", "from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184])\n by mail.messagingengine.com (Postfix) with ESMTPA id 4997C30600B1;\n Tue, 7 Jul 2020 11:26:30 -0400 (EDT)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h=\n from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding:content-type; s=fm1; bh=\n IxRi00qvbJqnTstC7Yfl+6UCNa3gJUJwLAg3dNHSGYs=; b=JReUnw4WkSo3l/Fr\n 8tUX2g5KUg6T0PD8UckJ2HguNCc6rNwCB0W/X3ucn2V5JWAYCitF9f6/Aad62gcV\n PlRZEGMtYIiyv8gRyCL2wpNED9dfsT0vmv4MAUES0/hh6BAeHm2ikyRKMKJaHT0E\n SIihwkNUaFroan/M/CpAWROMurMmEUaeS873MD2Qw2/s/elvQUPq8ECf8OU+Fuv0\n npBFkAjBG+fpbmrEismyVYksxIFVpYOtA3YU4pn+2EpiY90o+ekI2ORa/WbujhPp\n WKrO8SgGSoOQey9CvJHk+vcqiIvFDGemCigj1XqzfoNy1JyCyDLKT3SvjfGPpfuh\n oecyAQ==", "v=1; a=rsa-sha256; c=relaxed/relaxed; d=\n messagingengine.com; h=cc:content-transfer-encoding:content-type\n :date:from:in-reply-to:message-id:mime-version:references\n :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender\n :x-sasl-enc; s=fm3; bh=IxRi00qvbJqnTstC7Yfl+6UCNa3gJUJwLAg3dNHSG\n Ys=; b=tx8TIlFPicqSdud29/fNWuZld/o75iBPHMB/62w9wgDiG1Gf85fKjC6l4\n CnPLmjRL66h+zca2qtsfxGAzEQmUwk9+V5HV7pr5nQYs+k2WGeuXDbFNi4Tt+3Eb\n /J13npxIuxiPfvTTKVXhdXDPIHc3p3cTz+qEWTidHHs9rH5Cdaww6GixfC00oMvq\n Ro9u+cmzKRVxwEt8jdk8BPvraUR91vmVTKuj0ee0NJzUH8D7HC3KuXxXFczKOaCm\n 8qVbYEuuMGj9R1smI1JXiAz4crIkCYd0v9VsCzT1jXpNK0tnpkD4/q+j/t5Ns4v0\n uf6h3Ngzn2rTKEFW4QPfiHEL86ELg==" ], "X-ME-Sender": "<xms:J5QEX4uwA6iaI5H5tFpBbbty4qxjaKd1T3E3XppfTWXwj_pd37UM7Q>", "X-ME-Proxy-Cause": "\n gggruggvucftvghtrhhoucdtuddrgeduiedrudehgdekfecutefuodetggdotefrodftvf\n curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu\n uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc\n fjughrpefhvffufffkjghfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhmrghs\n ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucggtf\n frrghtthgvrhhnpedugefgvdefudfftdefgeelgffhueekgfffhfeujedtteeutdejueei\n iedvffegheenucfkphepjeejrddufeegrddvtdefrddukeegnecuvehluhhsthgvrhfuih\n iivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhho\n nhdrnhgvth", "X-ME-Proxy": "<xmx:J5QEX1cpSWyhEtWh9_u0QKh7TO-V0kBUuq_o0E2tOJD2kJefUQ49JQ>\n <xmx:J5QEXzwc31v2YxynkQcozB4yS2-Tea1cN8B8JCwc_nHlWoMVhemUcg>\n <xmx:J5QEX7NZkOWGOQz0SswUWhP7VeQXNK5k0OJG-nnl1tuEK_gUJpLJmA>\n <xmx:KJQEXzZNi0wFYKrl1qXr-J-WBXvXDFX7PBlsNyyxR_wT44PpwPy5LQ>", "From": "Thomas Monjalon <thomas@monjalon.net>", "To": "Ray Kinsella <mdr@ashroe.eu>", "Cc": "dev@dpdk.org, fady@mellanox.com, 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>, david.marchand@redhat.com,\n nhorman@tuxdriver.com, bruce.richardson@intel.com", "Date": "Tue, 07 Jul 2020 17:26:29 +0200", "Message-ID": "<2116547.mo2HYodoZD@thomas>", "In-Reply-To": "<1594133126-2518-3-git-send-email-mdr@ashroe.eu>", "References": "<1594133126-2518-1-git-send-email-mdr@ashroe.eu>\n <1594133126-2518-3-git-send-email-mdr@ashroe.eu>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "7Bit", "Content-Type": "text/plain; charset=\"us-ascii\"", "Subject": "Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental\n\tperiod", "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>" }, "addressed": null } ]