From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 75311A00C4; Thu, 31 Oct 2019 16:02:35 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id D4C001C24A; Thu, 31 Oct 2019 16:02:34 +0100 (CET) Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by dpdk.org (Postfix) with ESMTP id 2E43D1C241 for ; Thu, 31 Oct 2019 16:02:33 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga106.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 31 Oct 2019 08:02:32 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.68,252,1569308400"; d="scan'208";a="400523976" Received: from irsmsx107.ger.corp.intel.com ([163.33.3.99]) by fmsmga005.fm.intel.com with ESMTP; 31 Oct 2019 08:02:30 -0700 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.139]) by IRSMSX107.ger.corp.intel.com ([169.254.10.18]) with mapi id 14.03.0439.000; Thu, 31 Oct 2019 15:02:29 +0000 From: "Mcnamara, John" To: Ray Kinsella , "dev@dpdk.org" CC: "thomas@monjalon.net" , "stephen@networkplumber.org" , "Richardson, Bruce" , "Yigit, Ferruh" , "Ananyev, Konstantin" , "jerinj@marvell.com" , "olivier.matz@6wind.com" , "nhorman@tuxdriver.com" , "maxime.coquelin@redhat.com" , "Kovacevic, Marko" , "hemant.agrawal@nxp.com" , "ktraynor@redhat.com" , "aconole@redhat.com" Thread-Topic: [PATCH v7 1/4] doc: separate versioning.rst into version and policy Thread-Index: AQHVi1FiAwV5/7daWk2gEx3WNkE6qKd04O3A Date: Thu, 31 Oct 2019 15:02:28 +0000 Message-ID: References: <1572020920-5700-1-git-send-email-mdr@ashroe.eu> <1572020920-5700-2-git-send-email-mdr@ashroe.eu> In-Reply-To: <1572020920-5700-2-git-send-email-mdr@ashroe.eu> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ctpclassification: CTP_NT x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiNGQyZjc5NmYtMGRkYy00NzZmLTgzODQtYjYwNTUwYzhlNjhkIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoiQThIYnR2ZitEUE8wQ3hyajNmRzNLRzY0MzJHN0lqN3VpM3FhSVF2UmdIQXptVDhnc2QwbFdzUG1HaUZrSDg2UyJ9 dlp-product: dlpe-windows dlp-version: 11.2.0.6 dlp-reaction: no-action x-originating-ip: [163.33.239.181] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH v7 1/4] doc: separate versioning.rst into version and policy X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" > -----Original Message----- > From: Ray Kinsella > Sent: Friday, October 25, 2019 5:29 PM > To: dev@dpdk.org > Cc: mdr@ashroe.eu; thomas@monjalon.net; stephen@networkplumber.org; > Richardson, Bruce ; Yigit, Ferruh > ; Ananyev, Konstantin > ; jerinj@marvell.com; > olivier.matz@6wind.com; nhorman@tuxdriver.com; > maxime.coquelin@redhat.com; Mcnamara, John ; > Kovacevic, Marko ; hemant.agrawal@nxp.com; > ktraynor@redhat.com; aconole@redhat.com > Subject: [PATCH v7 1/4] doc: separate versioning.rst into version and > policy >=20 > Separate versioning.rst into abi versioning and abi policy guidance, in > preparation for adding more detail to the abi policy. >=20 > Signed-off-by: Ray Kinsella > --- > doc/guides/contributing/abi_policy.rst | 167 ++++++++ > doc/guides/contributing/abi_versioning.rst | 427 +++++++++++++++++++++ > doc/guides/contributing/index.rst | 3 +- > doc/guides/contributing/versioning.rst | 591 ----------------------- I think the it would be better to "git mv" versioning.rst to abi_versioning= .rst first to maintain the history and then extract out the policy part. Also, there is a build warning after this patch: $ make doc-guides-html sphinx processing guides-html... /work/dpdk_docs/doc/guides/contributing/patches.rst:159:=20 WARNING: unknown document: /contributing/versioning /work/dpdk_docs/doc/guides/rel_notes/deprecation.rst:7:=20 WARNING: unknown document: /contributing/versioning John