[PULL,00/61] QAPI patches patches for 2025-03-11

Pull-request

https://repo.or.cz/qemu/armbru.git tags/pull-qapi-2025-03-11

Message

Markus Armbruster March 11, 2025, 11:30 a.m. UTC

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