The following changes since commit 792f77f376adef944f9a03e601f6ad90c2f891b2:

  Merge tag 'pull-loongarch-20230506' of https://gitlab.com/gaosong/qemu into staging (2023-05-06 08:11:52 +0100)

are available in the Git repository at:

  https://repo.or.cz/qemu/armbru.git tags/pull-qapi-2023-05-09

for you to fetch changes up to ddd37ae995acacfd858d2ee090c3fa61e33b986b:

  qapi: Reformat doc comments to conform to current conventions (2023-05-09 09:57:15 +0200)

----------------------------------------------------------------
QAPI patches patches for 2023-05-09

----------------------------------------------------------------
Markus Armbruster (17):
      docs/devel/qapi-code-gen: Clean up use of quotes a bit
      docs/devel/qapi-code-gen: Turn FIXME admonitions into comments
      qapi: Fix crash on stray double quote character
      meson: Fix to make QAPI generator output depend on main.py
      Revert "qapi: BlockExportRemoveMode: move comments to TODO"
      sphinx/qapidoc: Do not emit TODO sections into user manuals
      qapi: Tidy up a slightly awkward TODO comment
      qapi/dump: Indent bulleted lists consistently
      tests/qapi-schema/doc-good: Improve a comment
      tests/qapi-schema/doc-good: Improve argument description tests
      qapi: Fix argument description indentation stripping
      qapi: Rewrite parsing of doc comment section symbols and tags
      qapi: Relax doc string @name: description indentation rules
      qapi: Section parameter @indent is no longer used, drop
      docs/devel/qapi-code-gen: Update doc comment conventions
      qga/qapi-schema: Reformat doc comments to conform to current conventions
      qapi: Reformat doc comments to conform to current conventions

 docs/devel/qapi-code-gen.rst          |   74 +-
 docs/sphinx/qapidoc.py                |    3 +
 meson.build                           |    2 +-
 qapi/acpi.json                        |   50 +-
 qapi/audio.json                       |   93 +-
 qapi/authz.json                       |   29 +-
 qapi/block-core.json                  | 2801 +++++++++++++++++----------------
 qapi/block-export.json                |  244 +--
 qapi/block.json                       |  214 +--
 qapi/char.json                        |  134 +-
 qapi/common.json                      |   19 +-
 qapi/compat.json                      |   13 +-
 qapi/control.json                     |   59 +-
 qapi/crypto.json                      |  261 +--
 qapi/cryptodev.json                   |    3 +
 qapi/cxl.json                         |   74 +-
 qapi/dump.json                        |   78 +-
 qapi/error.json                       |    6 +-
 qapi/introspect.json                  |   89 +-
 qapi/job.json                         |  139 +-
 qapi/machine-target.json              |  303 ++--
 qapi/machine.json                     |  389 ++---
 qapi/migration.json                   | 1120 +++++++------
 qapi/misc-target.json                 |   67 +-
 qapi/misc.json                        |  180 +--
 qapi/net.json                         |  260 ++-
 qapi/pci.json                         |   35 +-
 qapi/qapi-schema.json                 |   25 +-
 qapi/qdev.json                        |   63 +-
 qapi/qom.json                         |  404 ++---
 qapi/rdma.json                        |    1 -
 qapi/replay.json                      |   48 +-
 qapi/rocker.json                      |   20 +-
 qapi/run-state.json                   |  227 +--
 qapi/sockets.json                     |   50 +-
 qapi/stats.json                       |   83 +-
 qapi/tpm.json                         |   20 +-
 qapi/trace.json                       |   34 +-
 qapi/transaction.json                 |   87 +-
 qapi/ui.json                          |  435 ++---
 qapi/virtio.json                      |   84 +-
 qapi/yank.json                        |   42 +-
 qga/qapi-schema.json                  |  668 ++++----
 scripts/qapi/parser.py                |  137 +-
 tests/qapi-schema/doc-bad-indent.err  |    2 +-
 tests/qapi-schema/doc-bad-indent.json |    3 +-
 tests/qapi-schema/doc-good.json       |   20 +-
 tests/qapi-schema/doc-good.out        |   19 +-
 48 files changed, 4833 insertions(+), 4378 deletions(-)

-- 
2.39.2

On 5/9/23 08:59, Markus Armbruster wrote:
> The following changes since commit 792f77f376adef944f9a03e601f6ad90c2f891b2:
> 
>    Merge tag 'pull-loongarch-20230506' of https://gitlab.com/gaosong/qemu into staging (2023-05-06 08:11:52 +0100)
> 
> are available in the Git repository at:
> 
>    https://repo.or.cz/qemu/armbru.git tags/pull-qapi-2023-05-09
> 
> for you to fetch changes up to ddd37ae995acacfd858d2ee090c3fa61e33b986b:
> 
>    qapi: Reformat doc comments to conform to current conventions (2023-05-09 09:57:15 +0200)
> 
> ----------------------------------------------------------------
> QAPI patches patches for 2023-05-09
> 
> ----------------------------------------------------------------
> Markus Armbruster (17):
>        docs/devel/qapi-code-gen: Clean up use of quotes a bit
>        docs/devel/qapi-code-gen: Turn FIXME admonitions into comments
>        qapi: Fix crash on stray double quote character
>        meson: Fix to make QAPI generator output depend on main.py
>        Revert "qapi: BlockExportRemoveMode: move comments to TODO"
>        sphinx/qapidoc: Do not emit TODO sections into user manuals
>        qapi: Tidy up a slightly awkward TODO comment
>        qapi/dump: Indent bulleted lists consistently
>        tests/qapi-schema/doc-good: Improve a comment
>        tests/qapi-schema/doc-good: Improve argument description tests
>        qapi: Fix argument description indentation stripping
>        qapi: Rewrite parsing of doc comment section symbols and tags
>        qapi: Relax doc string @name: description indentation rules
>        qapi: Section parameter @indent is no longer used, drop
>        docs/devel/qapi-code-gen: Update doc comment conventions
>        qga/qapi-schema: Reformat doc comments to conform to current conventions
>        qapi: Reformat doc comments to conform to current conventions

This has a number of CI failures, including

https://gitlab.com/qemu-project/qemu/-/jobs/4252925621#L4673
../docs/meson.build:27:6: ERROR: Problem encountered: Install a Python 3 version of 
python-sphinx and the readthedoc theme


r~

On 5/9/23 18:20, Richard Henderson wrote:
> 
> This has a number of CI failures, including
> 
> https://gitlab.com/qemu-project/qemu/-/jobs/4252925621#L4673
> ../docs/meson.build:27:6: ERROR: Problem encountered: Install a Python 3 
> version of python-sphinx and the readthedoc theme
> 

No Python 3.8 yet (needed for assignment expressions aka the walrus 
operator).  The plan was to require that either as soon as Debian 11 
comes out, which would be in a couple months right before 8.1 freeze, or 
for 8.2.

Paolo