[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 16/16] qapi storage-daemon/qapi: Fix documentation section st
From: |
Markus Armbruster |
Subject: |
Re: [PATCH 16/16] qapi storage-daemon/qapi: Fix documentation section structure |
Date: |
Tue, 25 Apr 2023 06:59:41 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) |
Eric Blake <eblake@redhat.com> writes:
> On Tue, Apr 04, 2023 at 01:59:12PM +0200, Markus Armbruster wrote:
>> In the QEMU QMP Reference Manual, subsection "Block core (VM
>> unrelated)" is empty. Its contents is at the end of subsection
>> "Background jobs" instead. That's because qapi/job.json is includeded
>
> included
Fixing...
>> first from qapi/block-core.json, which makes qapi/job.json's
>> documentation go between qapi/block-core.json's subsection heading and
>> contents.
>>
>> In the QEMU Storage Daemon QMP Reference Manual, section "Block
>> Devices" contains nothing but an empty subsection "Block core (VM
>> unrelated)". The latter's contents is at the end section "Socket data
>> types", along with subsection "Block device exports". Subsection
>> "Background jobs" is at the end of section "Cryptography". All this
>> is because storage-daemon/qapi/qapi-schema.json includes modules in a
>> confused order.
>>
>> Fix both as follows.
>>
>> Turn subsection "Background jobs" into a section.
>>
>> Move it before section "Block devices" in the QEMU QMP Reference
>> Manual, by including qapi/jobs.json right before qapi/block.json.
>>
>> Reorder include directives in storage-daemon/qapi/qapi-schema.json to
>> match the order in qapi/qapi-schema.json, so that the QEMU Storage
>> Daemon QMP Reference Manual's section structure the QEMU QMP Reference
>> Manual's.
>>
>> In the QEMU QMP Reference Manual, qapi/cryptodev.json's documentation
>> is at the end of section "Virtio devices". That's because it lacks a
>> section heading, and therefore gets squashed into whatever section
>> happens to precede it.
>>
>> Add section heading so it's in section "Cryptography devices".
>>
>> Signed-off-by: Markus Armbruster <armbru@redhat.com>
>> ---
>> qapi/cryptodev.json | 4 ++++
>> qapi/job.json | 2 +-
>> qapi/qapi-schema.json | 2 +-
>> storage-daemon/qapi/qapi-schema.json | 22 +++++++++++++++-------
>> 4 files changed, 21 insertions(+), 9 deletions(-)
>
> Reviewed-by: Eric Blake <eblake@redhat.com>
Thanks!
- [PATCH 08/16] qapi: Delete largely misleading "Stability Considerations", (continued)
- [PATCH 08/16] qapi: Delete largely misleading "Stability Considerations", Markus Armbruster, 2023/04/04
- [PATCH 13/16] qapi: Replace ad hoc "since" documentation by member documentation, Markus Armbruster, 2023/04/04
- [PATCH 05/16] qapi/block-core: Clean up after removal of dirty bitmap @status, Markus Armbruster, 2023/04/04
- [PATCH 09/16] qapi: Fix bullet list markup in documentation, Markus Armbruster, 2023/04/04
- [PATCH 12/16] qapi: Fix argument documentation markup, Markus Armbruster, 2023/04/04
- [PATCH 10/16] qapi: Fix unintended definition lists in documentation, Markus Armbruster, 2023/04/04
- [PATCH 16/16] qapi storage-daemon/qapi: Fix documentation section structure, Markus Armbruster, 2023/04/04
- [PATCH 11/16] qga/qapi-schema: Fix member documentation markup, Markus Armbruster, 2023/04/04
- [PATCH 14/16] qapi: Fix misspelled section tags in doc comments, Markus Armbruster, 2023/04/04
- [PATCH 15/16] qapi: Format since information the conventional way: (since X.Y), Markus Armbruster, 2023/04/04
- Re: [PATCH 00/16] qapi qga/qapi-schema: Doc fixes, Vladimir Sementsov-Ogievskiy, 2023/04/04
- Re: [PATCH 00/16] qapi qga/qapi-schema: Doc fixes, Marc-André Lureau, 2023/04/04