From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id BB1B3C37C for ; Fri, 19 Jun 2015 13:08:11 +0200 (CEST) Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by orsmga103.jf.intel.com with ESMTP; 19 Jun 2015 04:08:10 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.13,643,1427785200"; d="scan'208";a="746440325" Received: from irsmsx153.ger.corp.intel.com ([163.33.192.75]) by fmsmga002.fm.intel.com with ESMTP; 19 Jun 2015 04:08:07 -0700 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.216]) by IRSMSX153.ger.corp.intel.com ([169.254.9.140]) with mapi id 14.03.0224.002; Fri, 19 Jun 2015 12:08:06 +0100 From: "Mcnamara, John" To: "Richardson, Bruce" , Neil Horman , Thomas Monjalon Thread-Topic: [dpdk-dev] [dpdk-announce] important design choices - statistics - ABI Thread-Index: AQHQqO3A1+EAKTD8z0GnXRMlVMFz1J2zq71Q Date: Fri, 19 Jun 2015 11:08:04 +0000 Message-ID: References: <9092314.MoyqUJ5VU2@xps13> <20150617103521.GB24677@hmsreliant.think-freely.org> <59AF69C657FD0841A61C55336867B5B034558F92@IRSMSX103.ger.corp.intel.com> In-Reply-To: <59AF69C657FD0841A61C55336867B5B034558F92@IRSMSX103.ger.corp.intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [163.33.239.180] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Cc: "dev@dpdk.org" Subject: Re: [dpdk-dev] [dpdk-announce] important design choices - statistics - ABI X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Jun 2015 11:08:12 -0000 > -----Original Message----- > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Richardson, Bruce > Sent: Wednesday, June 17, 2015 12:07 PM > To: Neil Horman; Thomas Monjalon > Cc: dev@dpdk.org > Subject: Re: [dpdk-dev] [dpdk-announce] important design choices - > statistics - ABI > Hi Neil, >=20 > on my end, some suggestions: >=20 > 1. the documentation on changing an API function provided in rte_compat.h > is really good, but I don't think this is present in our documentation in > the docs folder or on website is it (apologies if it is and I've missed > it)? This needs to go into programmers guide or some other doc (perhaps > the new doc that the coding style went into). >=20 > 2. The documentation also needs an example of: this is how you add a new > function and update the map file, and this is how you a) mark a function > as deprecated and b) remove it completely. That way we could have one > guide covering API versioning, how to add, modify and remove functions. >=20 > 3. This doc should also cover how to use the API checker tool, something = I > haven't had the chance to look at yet, but should do in the near future! > :-) +1 on all three. We need better documentation on how to work with the ABI i= n DPDK. A new document in doc/guides/guidelines/ would be good. John