On 8/10/20 12:50 PM, Peter Maydell wrote: > Some of our documentation is auto-generated from documentation > comments in the JSON schema. > > For Sphinx, rather than creating a file to include, the most natural > way to handle this is to have a small custom Sphinx extension which > processes the JSON file and inserts documentation into the rST > file being processed. > > This is the same approach that kerneldoc and hxtool use. > > Signed-off-by: Peter Maydell <peter.mayd...@linaro.org> > --- > Changes v4->v5: match the changes in parameters to the > various visit_* methods from commit 7b3bc9e28f366 > --- > docs/conf.py | 6 +- > docs/sphinx/qapidoc.py | 504 +++++++++++++++++++++++++++++++++++++++++ > MAINTAINERS | 1 + > 3 files changed, 510 insertions(+), 1 deletion(-) > create mode 100644 docs/sphinx/qapidoc.py
Reviewed-by: Richard Henderson <richard.hender...@linaro.org> r~