qapi/pragma.json: Improve the comment about the lists of QAPI rule exceptions

[mirror_qemu.git] / qapi / pragma.json

diff --git a/qapi/pragma.json b/qapi/pragma.json
index 3bc0335d1f9a4d7d6dd5337ddae65556f89b3e98..0aa4eeddd3893bee760fb28ab1d7222dfb3c13ed 100644 (file)
--- a/qapi/pragma.json
+++ b/qapi/pragma.json
@@ -1,9 +1,12 @@
+# -*- Mode: Python -*-
+# vim: filetype=python
+
 { 'pragma': { 'doc-required': true } }
 
-# Whitelists to permit QAPI rule violations; think twice before you
-# add to them!
+# Entries in these lists are allowed to violate the QAPI rules (for
+# historical reasons); think twice before you add to them!
 { 'pragma': {
-    # Commands allowed to return a non-dictionary:
+    # Command names containing '_'
     'command-name-exceptions': [
         'add_client',
         'block_resize',
@@ -21,6 +24,7 @@
         'system_powerdown',
         'system_reset',
         'system_wakeup' ],
+    # Commands allowed to return a non-dictionary
     'command-returns-exceptions': [
         'human-monitor-command',
         'qom-get',