The following changes since commit 825b96dbcee23d134b691fc75618b59c5f53da32:
Merge tag 'migration-20250310-pull-request' of https://gitlab.com/farosas/qemu into staging (2025-03-11 09:32:07 +0800) are available in the Git repository at: https://repo.or.cz/qemu/armbru.git tags/pull-qapi-2025-03-11 for you to fetch changes up to 93db9c84fc40b82d6bc3a944cb8eb8443980824c: scripts/qapi/backend: Clean up create_backend()'s failure mode (2025-03-11 10:26:52 +0100) ---------------------------------------------------------------- QAPI patches patches for 2025-03-11 ---------------------------------------------------------------- John Snow (60): docs/sphinx: create QAPI domain extension stub docs/sphinx: add compat.py module and nested_parse helper docs/qapi-domain: add QAPI domain object registry docs/qapi-domain: add QAPI index docs/qapi-domain: add resolve_any_xref() docs/qapi-domain: add QAPI xref roles docs/qapi-domain: add compatibility node classes docs/qapi-domain: Add QAPIDescription abstract class docs/qapi-domain: add qapi:module directive docs/qapi-domain: add QAPIObject class docs/qapi-domain: add qapi:command directive docs/qapi-domain: add :since: directive option docs/qapi-domain: add "Arguments:" field lists docs/qapi-domain: add "Features:" field lists docs/qapi-domain: add "Errors:" field lists docs/qapi-domain: add "Return:" field lists docs/qapi-domain: add qapi:enum directive docs/qapi-domain: add qapi:alternate directive docs/qapi-domain: add qapi:event directive docs/qapi-domain: add qapi:object directive docs/qapi-domain: add :deprecated: directive option docs/qapi-domain: add :unstable: directive option docs/qapi-domain: add :ifcond: directive option docs/qapi-domain: add warnings for malformed field lists docs/qapi-domain: add type cross-refs to field lists docs/qapi-domain: add CSS styling docs/qapi-domain: add XREF compatibility goop for Sphinx < 4.1 docs/qapi-domain: warn when QAPI domain xrefs fail to resolve docs/qapi-domain: Fix error context reporting in Sphinx 5.x and 6.x qapi/parser: adjust info location for doc body section qapi: clean up encoding of section kinds qapi/schema: add __repr__ to QAPIDoc.Section docs/qapidoc: add transmogrifier stub docs/qapidoc: split old implementation into qapidoc_legacy.py docs/qapidoc: Fix static typing on qapidoc.py docs/qapidoc: add transmogrifier class stub docs/qapidoc: add visit_module() method qapi/source: allow multi-line QAPISourceInfo advancing docs/qapidoc: add visit_freeform() method docs/qapidoc: add preamble() method docs/qapidoc: add visit_paragraph() method docs/qapidoc: add visit_errors() method docs/qapidoc: add format_type() method docs/qapidoc: add add_field() and generate_field() helper methods docs/qapidoc: add visit_feature() method docs/qapidoc: prepare to record entity being transmogrified docs/qapidoc: add visit_returns() method docs/qapidoc: add visit_member() method docs/qapidoc: add visit_sections() method docs/qapidoc: add visit_entity() docs/qapidoc: implement transmogrify() method docs/qapidoc: process @foo into ``foo`` docs/qapidoc: add intermediate output debugger docs/qapidoc: Add "the members of" pointers docs/qapidoc: generate entries for undocumented members qapi/parser: add undocumented stub members to all_sections docs: disambiguate cross-references docs: enable qapidoc transmogrifier for QEMU QMP Reference docs: add qapi-domain syntax documentation MAINTAINERS: Add jsnow as maintainer for Sphinx documentation Markus Armbruster (1): scripts/qapi/backend: Clean up create_backend()'s failure mode MAINTAINERS | 1 + docs/conf.py | 18 +- docs/devel/codebase.rst | 6 +- docs/devel/index-build.rst | 1 + docs/devel/qapi-domain.rst | 670 ++++++++++++++++++++++++ docs/glossary.rst | 10 +- docs/interop/qemu-qmp-ref.rst | 1 + docs/sphinx-static/theme_overrides.css | 98 +++- docs/sphinx/compat.py | 230 ++++++++ docs/sphinx/qapi_domain.py | 931 +++++++++++++++++++++++++++++++++ docs/sphinx/qapidoc.py | 907 +++++++++++++++++--------------- docs/sphinx/qapidoc_legacy.py | 440 ++++++++++++++++ qapi/qapi-schema.json | 2 + scripts/qapi/main.py | 24 +- scripts/qapi/parser.py | 123 ++++- scripts/qapi/source.py | 4 +- tests/qapi-schema/doc-good.out | 10 +- tests/qapi-schema/test-qapi.py | 2 +- 18 files changed, 3000 insertions(+), 478 deletions(-) create mode 100644 docs/devel/qapi-domain.rst create mode 100644 docs/sphinx/compat.py create mode 100644 docs/sphinx/qapi_domain.py create mode 100644 docs/sphinx/qapidoc_legacy.py -- 2.48.1
