Re: [PATCH v6 07/21] docs/sphinx: Add new qapi-doc Sphinx extension

2020-09-29 Thread Peter Maydell
On Tue, 29 Sep 2020 at 07:54, Markus Armbruster wrote: > > Peter Maydell writes: > > > 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 s

Re: [PATCH v6 07/21] docs/sphinx: Add new qapi-doc Sphinx extension

2020-09-28 Thread Markus Armbruster
Peter Maydell writes: > 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 insert

[PATCH v6 07/21] docs/sphinx: Add new qapi-doc Sphinx extension

2020-09-25 Thread Peter Maydell
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 b