Add a qapi2texi script to generate the documentation from the qapi schemas.
The 13th patch in this series is a squashed version of the documentation move from qmp-commands.txt to the schemas. The whole version (not sent on the ML to avoid spamming) is in the following git branch: https://github.com/elmarco/qemu/commits/qapi-doc v3: - many improvements to the doc parser: - throws an error in various malformated conditions - allows multiple meta-sections, except for "Since:" and "Return:" - build a list of docs, instead of attaching docs to expressions - accept() breaks on new doc block, and get_doc() returns a QAPIDoc - fix more documentation to fit the new parser - use a master texi file that includes the generated file, instead of templated texi file - texi fixes after Markus review - only build and install html and man pages by default - fix .gitignore v2: - change licence to be lgpl2+ - fix some comments & commit message - add more code comments - improve the doc parsing to treat only "Since" as a special case not requiring ":" (common notation in the doc) - include some early schema doc fixes (to fix generated doc) - include the squashed version of the doc move - include the man page and installation build changes Marc-André Lureau (14): qapi: add missing 'bus' argument in device_add qga/schema: fix double-return in doc qga/schema: improve guest-set-vcpus Returns: section qapi: fix schema symbol sections qapi: fix missing symbol @prefix qapi: fix various symbols mismatch in documentation qapi: use one symbol per line qapi: add missing colon-ending for section name qapi: add some sections in docs docs: add master qapi texi files qapi: add qapi2texi script texi2pod: learn quotation, deftp and deftypefn qmp-commands: (SQUASHED) move doc to schema build-sys: add qapi doc generation targets Makefile | 57 +- scripts/qapi.py | 175 +- scripts/qapi2texi.py | 316 ++++ scripts/texi2pod.pl | 44 +- .gitignore | 11 +- docs/qapi-code-gen.txt | 44 +- docs/qemu-ga-ref.texi | 65 + docs/qemu-qmp-ref.texi | 156 ++ docs/qmp-commands.txt | 3824 ----------------------------------------- docs/qmp-events.txt | 731 -------- docs/qmp-intro.txt | 87 - docs/writing-qmp-commands.txt | 2 +- qapi-schema.json | 1621 +++++++++++++++-- qapi/block-core.json | 894 ++++++++-- qapi/block.json | 82 +- qapi/common.json | 52 +- qapi/crypto.json | 41 +- qapi/event.json | 304 +++- qapi/introspect.json | 28 +- qapi/rocker.json | 63 +- qapi/trace.json | 25 +- qga/qapi-schema.json | 64 +- 22 files changed, 3583 insertions(+), 5103 deletions(-) create mode 100755 scripts/qapi2texi.py create mode 100644 docs/qemu-ga-ref.texi create mode 100644 docs/qemu-qmp-ref.texi delete mode 100644 docs/qmp-commands.txt delete mode 100644 docs/qmp-events.txt delete mode 100644 docs/qmp-intro.txt -- 2.10.0