[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: |
Stefan Hajnoczi |
Subject: |
Re: [PATCH v2 1/3] docs: generate qemu-storage-daemon-qmp-ref(7) man page |
Date: |
Wed, 9 Dec 2020 10:21:55 +0000 |
On Tue, Oct 06, 2020 at 12:22:55PM +0200, Kevin Wolf wrote:
> 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.
v2 onwards takes a different approach and leaves the header where it is.
Stefan
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- Re: [PATCH v2 1/3] docs: generate qemu-storage-daemon-qmp-ref(7) man page,
Stefan Hajnoczi <=