qapi: Reformat doc comments
Get series with b4
b4 am [email protected]Versions newest first
- v1 Latest17 patches 30 repliesIn review
Patches in v1 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/17 | docs/devel/qapi-code-gen: Clean up use of quotes a bitdocs/ | +6 | 1 reply | |
| 2/17 | docs/devel/qapi-code-gen: Turn FIXME admonitions into commentsdocs/ | +2 | 1 reply | |
| 3/17 | qapi: Fix crash on stray double quote characterscripts/ | +1 | 2 replies | |
| 4/17 | meson: Fix to make QAPI generator output depend on main.pymeson.build | +1 | 2 replies | |
| 5/17 | Revert "qapi: BlockExportRemoveMode: move comments to TODO"qapi/ | +5 | 1 reply | |
| 6/17 | sphinx/qapidoc: Do not emit TODO sections into user manualsdocs/ docs/ | +6 | 2 replies | |
| 7/17 | qapi: Tidy up a slightly awkward TODO commentqapi/ | +3 | 3 replies | |
| 8/17 | qapi/dump: Indent bulleted lists consistentlyqapi/ | +6 | 1 reply | |
| 9/17 | tests/qapi-schema/doc-good: Improve a commenttests/ tests/ | +5 | 1 reply | |
| 10/17 | tests/qapi-schema/doc-good: Improve argument description teststests/ tests/ | +18 | 3 replies | |
| 11/17 | qapi: Fix argument description indentation strippingscripts/ tests/ | +12 | 1 reply | |
| 12/17 | qapi: Rewrite parsing of doc comment section symbols and tagsscripts/ | +23 | 3 replies | |
| 13/17 | qapi: Relax doc string @name: description indentation rulesdocs/ scripts/ tests/ +3 more | +32 | 3 replies | |
| 14/17 | qapi: Section parameter @indent is no longer used, dropscripts/ | +14 | 1 reply | |
| 15/17 | docs/devel/qapi-code-gen: Update doc comment conventionsdocs/ | +22 | 1 reply | |
| 16/17 | qga/qapi-schema: Reformat doc comments to conform to current conventionsqga/ | +382 | 1 reply | |
| 17/17 | qapi: Reformat doc comments to conform to current conventionsqapi/ qapi/ qapi/ +36 more | +4322 | 2 replies |
Reviews trailers per patch
All 17 patches have a Reviewed-by or Acked-by.
| Patch | Juan Quintela | Ani Sinha | Lukas Straub | Philippe Mathieu-Daudé |
|---|---|---|---|---|
| 1/17 | R-b | |||
| 2/17 | R-b | |||
| 3/17 | R-b | |||
| 4/17 | R-b | |||
| 5/17 | R-b | |||
| 6/17 | R-b | R-b | ||
| 7/17 | R-b | R-b | ||
| 8/17 | R-b | |||
| 9/17 | R-b | |||
| 10/17 | R-b | |||
| 11/17 | R-b | |||
| 12/17 | R-b | |||
| 13/17 | R-b | R-b | ||
| 14/17 | R-b | |||
| 15/17 | R-b | |||
| 16/17 | R-b | |||
| 17/17 | R-b | A-b |
Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes. Scroll the table sideways for all 4 reviewers.
Cover letter [PATCH 00/17] qapi: Reformat doc comments
This series improves the doc comment formatting rules, then reformats doc comments to conform to them.
I don't like reformatting code. But I'm tired of looking at ugly doc comments. People imitate them in new work (not blaming them for that), which leads to tiresome arguments about style. I've come to the conclusion that reformatting them is the lesser evil.
Prior discussion:
qapi: [RFC] Doc comment convention for @arg: sections
Message-ID: <[email protected]>
https://lists.gnu.org/archive/html/qemu-devel/2023-03/msg05921.htmlPATCH 01-12 are preliminary fixes, cleanups and test improvements, ranging from losely related to not related at all.
PATCH 13-14 improve the QAPI generator to support the style I want.
PATCH 15 writes it down.
PATCH 16-17 reformat the doc comments to conform to it.
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 | 85 +- 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 | 215 +- 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, 4822 insertions(+), 4369 deletions(-)
Signature · 1 line
2.39.2