[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v2 00/16] qapi-schema: Reorganize along maintenance
From: |
Markus Armbruster |
Subject: |
[Qemu-devel] [PATCH v2 00/16] qapi-schema: Reorganize along maintenance boundaries |
Date: |
Thu, 24 Aug 2017 21:13:52 +0200 |
Cc: "Daniel P. Berrange" <address@hidden>
Cc: Alberto Garcia <address@hidden>
Cc: Dr. David Alan Gilbert <address@hidden>
Cc: Gerd Hoffmann <address@hidden>
Cc: Jason Wang <address@hidden>
Cc: Juan Quintela <address@hidden>
Cc: Marc-André Lureau <address@hidden>
Cc: Paolo Bonzini <address@hidden>
Much of the QAPI schema really belongs to a subsystem, but MAINTAINERS
can't tell when it's all in a big ball of mud (qapi-schema.json) with
a small ball of mud (event.json) on the side.
Create sub-schemas for the subsystems with the most substantial QAPI
footprint in the mud. The big ball shrinks by half, and the small
ball goes away.
Bonus: the generated documentation's structure makes more sense now.
It needs further improvement (see last patch), but it's a start.
I generally kept the order intact when moving source code. It may be
smarter to reorder it for improved legibility (both source and
generated doc). Subsystem maintainers, please tell me whether you'd
like things reordered.
v2:
* Title changed from "qapi-schema: Generated doc structure fixes"
* PATCH 01: say "source order" rather than "textual order"
* PATCH 02: no change
* PATCH 03: rocker.json included before event.json to reduce churn
* PATCH 04-16: new
Markus Armbruster (16):
qapi-schema: Document how generated documentation is ordered
qapi-schema: Introspection doc is in the wrong section, fix
qapi-schema: Rocker doc section contains unrelated stuff, fix
qapi-schema: Collect sockets stuff in qapi/sockets.json
qapi-schema: Collect run state stuff in qapi/run-state.json
qapi-schema: Collect char device stuff in qapi/char.json
qapi-schema: Collect net device stuff in qapi/net.json
qapi-schema: Collect UI stuff in qapi/ui.json
qapi-schema: Collect migration stuff in qapi/migration.json
qapi-schema: Collect transaction stuff in qapi/transaction.json
qapi-schema: Collect TPM stuff in qapi/tpm.json
qapi-schema: Move block events from event.json to block.json
qapi-schema: Fold event.json back into qapi-schema.json
qapi-schema: Make block-core.json self-contained
qapi-schema: Move queries from common.json to qapi-schema.json
qapi-schema: Improve section headings
MAINTAINERS | 16 +
Makefile | 15 +-
qapi-schema.json | 3866 +++----------------------------------------------
qapi/block-core.json | 5 +-
qapi/block.json | 73 +-
qapi/char.json | 538 +++++++
qapi/common.json | 132 +-
qapi/crypto.json | 2 +-
qapi/event.json | 646 ---------
qapi/introspect.json | 6 +-
qapi/migration.json | 1085 ++++++++++++++
qapi/net.json | 706 +++++++++
qapi/run-state.json | 352 +++++
qapi/sockets.json | 147 ++
qapi/tpm.json | 137 ++
qapi/trace.json | 2 +-
qapi/transaction.json | 158 ++
qapi/ui.json | 977 +++++++++++++
18 files changed, 4477 insertions(+), 4386 deletions(-)
create mode 100644 qapi/char.json
delete mode 100644 qapi/event.json
create mode 100644 qapi/migration.json
create mode 100644 qapi/net.json
create mode 100644 qapi/run-state.json
create mode 100644 qapi/sockets.json
create mode 100644 qapi/tpm.json
create mode 100644 qapi/transaction.json
create mode 100644 qapi/ui.json
--
2.7.5
- [Qemu-devel] [PATCH v2 00/16] qapi-schema: Reorganize along maintenance boundaries,
Markus Armbruster <=
- [Qemu-devel] [PATCH v2 02/16] qapi-schema: Introspection doc is in the wrong section, fix, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 03/16] qapi-schema: Rocker doc section contains unrelated stuff, fix, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 01/16] qapi-schema: Document how generated documentation is ordered, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 14/16] qapi-schema: Make block-core.json self-contained, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 13/16] qapi-schema: Fold event.json back into qapi-schema.json, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 16/16] qapi-schema: Improve section headings, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 04/16] qapi-schema: Collect sockets stuff in qapi/sockets.json, Markus Armbruster, 2017/08/24