[dpdk-dev] [PATCH v1] doc: autogenerate nic overview table from ini files

Yuanhan Liu yuanhan.liu at linux.intel.com
Fri Jul 1 03:40:22 CEST 2016


On Thu, Jun 30, 2016 at 08:25:14PM +0200, Thomas Monjalon wrote:
> 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.
> > 
> > The reason for doing this is to make it easier for PMD maintainers to update
> > the feature matrix that makes up the table and to avoid frequent and hard to
> > resolve conflicts in doc/guides/nics/overview.rst.
> 
> Great idea!

Yes, indeed!

The old formats also make the review hard (due to the long/messy diff).
I was also kidding/wishing before that it'd be great if we could have a
column-based diff file. With your proposal, we don't need it any more :)

	--yliu


More information about the dev mailing list