From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 2258FB445 for ; Fri, 8 Jul 2016 21:52:56 +0200 (CEST) Received: from orsmga003.jf.intel.com ([10.7.209.27]) by orsmga101.jf.intel.com with ESMTP; 08 Jul 2016 12:52:57 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.28,331,1464678000"; d="scan'208";a="842955680" Received: from irsmsx105.ger.corp.intel.com ([163.33.3.28]) by orsmga003.jf.intel.com with ESMTP; 08 Jul 2016 12:52:54 -0700 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.240]) by irsmsx105.ger.corp.intel.com ([169.254.7.51]) with mapi id 14.03.0248.002; Fri, 8 Jul 2016 20:52:54 +0100 From: "Mcnamara, John" To: Thomas Monjalon CC: "dev@dpdk.org" Thread-Topic: [dpdk-dev] [PATCH v1] doc: autogenerate nic overview table from ini files Thread-Index: AQHR0vncxTBtkNeEJEChxvQOdnd3rqACQsUAgAy4/XA= Date: Fri, 8 Jul 2016 19:52:53 +0000 Message-ID: References: <1467309817-11739-1-git-send-email-john.mcnamara@intel.com> <1604656.XReoQ6n0NJ@xps13> In-Reply-To: <1604656.XReoQ6n0NJ@xps13> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ctpclassification: CTP_IC x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiYmNmMzZlNTAtNzJhNi00ZDkyLWE1MGMtMTRhNTMzNjNhZjg4IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE1LjkuNi42IiwiVHJ1c3RlZExhYmVsSGFzaCI6IkNDVW9sWnI0QjBIdUtzb2FLNFM0KzE5RTBIRHdEXC9SXC9Oa1hValFpRGxYVT0ifQ== x-originating-ip: [163.33.239.182] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH v1] doc: autogenerate nic overview table from ini files 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, 08 Jul 2016 19:52:58 -0000 > -----Original Message----- > From: Thomas Monjalon [mailto:thomas.monjalon@6wind.com] > Sent: Thursday, June 30, 2016 7:25 PM > To: Mcnamara, John > Cc: dev@dpdk.org > Subject: Re: [dpdk-dev] [PATCH v1] doc: autogenerate nic overview table > from ini files >=20 > 2016-06-30 19:03, John McNamara: > > This patch converts the NIC feature table in the overview doc into a > > set of ini files and adds some functions into the Sphinx conf.py file > > to convert them back into an RST table. > > > Would it be possible to make it a bit more generic and reusable to > generate other tables of this kind? It would be possible (in the technical sense) but probably not worth the effort. :-) > > * Blank entries in the PMD ini files are optional. They will get a > default > > blank entry in the RST table based on the entries in the default.ini > file. > > The ini files in this patch were generated programmatically from the > > original RST table. >=20 > I don't think there is a benefit to have blank entries in the .ini file. > And there would be less conflicts if the guideline was to avoid blank > entries when adding a new feature. I can generate a set of ini files without blank entries if that is the preference. For some PMDs that will mean that there are no entries in the file, apart from the heading, but I guess that is okay. I'll change that in v2. >=20 > PDF output is restrictive :) Yes, and the PDF infrastructure is a bit of a pain but we still get a lot of people in the field who like them and ask for them after releases. Maybe they read them on the beach, on holidays. John