Ok, I've got a script that generates a table similar to http://docs.faucet.nz/en/latest/configuration.html#dp from whatever files is given to it.

Basically it looks for 'defaults' and 'defaults_types' and uses the comment below it as the description.
And converts everything to a csv.

Was thinking the 'default' could be overridden with a comment on the same line. e.g. dp_id

See attached html dp, vlan & interface

Script: https://github.com/Bairdo/faucet/blob/doc-script/docs/docs_parser.py

On 18/01/18 14:54, Josh Bailey wrote:
They're manually generated at the moment.

Documentation fixes always welcome (as are scripts to generate doc/snippets from code!).


On Thu, Jan 18, 2018 at 2:51 PM, Michael Baird <Michael.Baird@ecs.vuw.ac.nz> wrote:
Are the configuration tables in https://faucet.readthedocs.io/en/latest/configuration.html generated via script from the codebase or manually?

There is a couple of options that look wrong or are missing (in particular hairpin & loop_protection). If its manual I'll update them.

Faucet-dev mailing list