[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v2 16/16] qapi-schema: Improve section headings
From: |
Markus Armbruster |
Subject: |
[Qemu-devel] [PATCH v2 16/16] qapi-schema: Improve section headings |
Date: |
Thu, 24 Aug 2017 21:14:08 +0200 |
The generated QEMU QMP reference is now structured as follows:
1.1 Introduction
1.2 Stability Considerations
1.3 Common data types
1.4 Socket data types
1.5 VM run state
1.6 Cryptography
1.7 Block devices
1.7.1 Block core (VM unrelated)
1.7.2 QAPI block definitions (vm unrelated)
1.8 Character devices
1.9 Net devices
1.10 Rocker switch device
1.11 TPM (trusted platform module) devices
1.12 Remote desktop
1.12.1 Spice
1.12.2 VNC
1.13 Input
1.14 Migration
1.15 Transactions
1.16 Tracing
1.17 QMP introspection
1.18 Miscellanea
Section "1.18 Miscellanea" is still too big: it documents 134 symbols.
Section "1.7.1 Block core (VM unrelated)" is also rather big: 128
symbols. All the others are of reasonable size.
Signed-off-by: Markus Armbruster <address@hidden>
---
qapi-schema.json | 2 +-
qapi/block-core.json | 2 +-
qapi/block.json | 5 ++---
qapi/common.json | 2 +-
qapi/crypto.json | 2 +-
qapi/trace.json | 2 +-
6 files changed, 7 insertions(+), 8 deletions(-)
diff --git a/qapi-schema.json b/qapi-schema.json
index 7a393ec..f3af2cb 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -94,7 +94,7 @@
{ 'include': 'qapi/introspect.json' }
##
-# = QMP commands
+# = Miscellanea
##
##
diff --git a/qapi/block-core.json b/qapi/block-core.json
index f4caa5c..28abb9e 100644
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -1,7 +1,7 @@
# -*- Mode: Python -*-
##
-# == QAPI block core definitions (vm unrelated)
+# == Block core (VM unrelated)
##
{ 'include': 'common.json' }
diff --git a/qapi/block.json b/qapi/block.json
index 8ce3357..f093fa3 100644
--- a/qapi/block.json
+++ b/qapi/block.json
@@ -1,14 +1,13 @@
# -*- Mode: Python -*-
##
-# = QAPI block definitions
+# = Block devices
##
-# QAPI block core definitions
{ 'include': 'block-core.json' }
##
-# == QAPI block definitions (vm unrelated)
+# == Additional block stuff (VM related)
##
##
diff --git a/qapi/common.json b/qapi/common.json
index 0c67e4a..6eb0182 100644
--- a/qapi/common.json
+++ b/qapi/common.json
@@ -1,7 +1,7 @@
# -*- Mode: Python -*-
##
-# = QAPI common definitions
+# = Common data types
##
##
diff --git a/qapi/crypto.json b/qapi/crypto.json
index 6b6fde3..288bc05 100644
--- a/qapi/crypto.json
+++ b/qapi/crypto.json
@@ -2,7 +2,7 @@
#
##
-# = QAPI crypto definitions
+# = Cryptography
##
##
diff --git a/qapi/trace.json b/qapi/trace.json
index de6588d..799b254 100644
--- a/qapi/trace.json
+++ b/qapi/trace.json
@@ -6,7 +6,7 @@
# See the COPYING file in the top-level directory.
##
-# = Tracing commands
+# = Tracing
##
##
--
2.7.5
- [Qemu-devel] [PATCH v2 00/16] qapi-schema: Reorganize along maintenance boundaries, Markus Armbruster, 2017/08/24
- [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 <=
- [Qemu-devel] [PATCH v2 04/16] qapi-schema: Collect sockets stuff in qapi/sockets.json, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 15/16] qapi-schema: Move queries from common.json to qapi-schema.json, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 11/16] qapi-schema: Collect TPM stuff in qapi/tpm.json, Markus Armbruster, 2017/08/24
- [Qemu-devel] [PATCH v2 12/16] qapi-schema: Move block events from event.json to block.json, Markus Armbruster, 2017/08/24