[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2 1/3] docs: generate qemu-storage-daemon-qmp-ref(7) man pag
From: |
Kevin Wolf |
Subject: |
Re: [PATCH v2 1/3] docs: generate qemu-storage-daemon-qmp-ref(7) man page |
Date: |
Tue, 6 Oct 2020 12:22:55 +0200 |
Am 10.09.2020 um 16:43 hat Stefan Hajnoczi geschrieben:
> Although qemu-storage-daemon QMP commands are identical to QEMU QMP
> commands they are a subset. Generate a manual page of just the commands
> supported by qemu-storage-daemon so that users know exactly what is
> available in qemu-storage-daemon.
>
> Add an h1 heading in storage-daemon/qapi/qapi-schema.json so that
> block-core.json is at the h2 heading level.
>
> Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
As the series doesn't apply any more, I can't actually try it out
easily, but is the order of includes in the schema right now?
I seem to remember that in v1 we discussed that nested includes result
in an unexpected section structure in the documentation in some cases
(such as generic jobs being documented in a subsection of block
devices), and that we need to reorder includes in qapi-schema.json to
fix this because a more clever doc generator wasn't considered worth the
effort.
Kevin
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- Re: [PATCH v2 1/3] docs: generate qemu-storage-daemon-qmp-ref(7) man page,
Kevin Wolf <=