[Qemu-devel] [PATCH v2 00/16] qapi-schema: Reorganize along maintenance boundaries

[Markus Armbruster]

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