qapi-schema: Improve section headings

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 <armbru@redhat.com>
Message-Id: <1503602048-12268-17-git-send-email-armbru@redhat.com>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>

diff --git a/qapi-schema.json b/qapi-schema.json
index 7a393ec3e99ff9c4454e64d5d47b137cbf7e8c90..f3af2cb851cdcac2efdeff63c8183a03b06e853b 100644 (file)
--- 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 f4caa5c21b7f65fa387ef0f0c5e13a2ff9882501..28abb9e6cf38720e99af1f93a2859de8c4d9f0e2 100644 (file)
--- 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 8ce335739f3bd65b3614dd997a516d06237f21b9..f093fa3f27641625fbb9151e59863cd316f114c4 100644 (file)
--- 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 0c67e4acf5269d315987f07bf7f401fc7ebc2d85..6eb01821ef59ee0531945214be4ae2b71d13f697 100644 (file)
--- 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 6b6fde367aad59f8ddadcf30e763f311d3566bd5..288bc056ef46e1cd393881a34655aac1d9d95f9f 100644 (file)
--- 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 de6588d9f731c58ec1dba2eb070036c6d12e3f02..799b254a186a219a21bb87eaffbf55d06830c6b0 100644 (file)
--- a/qapi/trace.json
+++ b/qapi/trace.json
@@ -6,7 +6,7 @@
 # See the COPYING file in the top-level directory.
 
 ##
-# = Tracing commands
+# = Tracing
 ##
 
 ##