[dpdk-dev] [PATCH v1] doc: autogenerate nic overview table from ini files
Thomas Monjalon
thomas.monjalon at 6wind.com
Thu Jun 30 20:25:14 CEST 2016
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!
Would it be possible to make it a bit more generic and reusable to
generate other tables of this kind?
> * In order to avoid the merge conflict issue noted above the RST table is now
> in an external RST include file and excluded from the repo via .gitignore.
It would be better to generate the rst file in the build directory.
But I guess it makes sphinx build more difficult.
> * 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.
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 would like to extend this to produce a pure Html table with rotated column
> headers like this: https://css-tricks.com/rotated-table-column-headers/
> I tried to get this to work within the current RST + CSS preamble but
> failed.
Nice
> * I would also like to extend this to produce a table, or more likely a number
> of tables, that would display the same information in the PDF document
> without going off the page.
PDF output is restrictive :)
More information about the dev
mailing list