Here's my argument for taking this into 10.0.
The changes can be divided into four parts:
1. Address deficiencies right at the beginning of the three QMP manuals:
* "QEMU QMP Reference Manual" section "Introduction" suffers from bit
rot: much of the contents is useless or misleading.
* The "QEMU Storage Daemon QMP Reference Manual" and the "QEMU Guest
Agent Protocol Reference" lack a proper introduction.
* "QEMU Guest Agent Protocol Reference" has a useless table of
contents.
* "QEMU QMP Reference Manual" and "QEMU Storage Daemon QMP Reference
Manual" both have a needlessly ugly table of contents.
2. Render the example notation in these introductions properly. This
involves changing *one* line of code in docs/sphinx/qmp_lexer.py.
This is the only code change, everything else is documentation.
3. Minor cleanup of rocker QMP documentation
4. Minor improvement of QAPI developer documentation