On Mon, 5 Jul 2021 at 10:55, Peter Maydell <peter.mayd...@linaro.org> wrote: > > This patchset is an effort to fix something up which I promised > Markus I would do after we got the initial conversion to Sphinx > done. The old QAPI reference documentation noted the documentation > license in the texinfo source (but not in the generated HTML or > in the generated manpages); Sphinx generated docs currently don't.
> I'm open to suggestions on: > * name of the new top-level section > * text wording > * whether we need to have the version number in the footer > (it's already in the sidebar under the QEMU logo, but this > seemed a bit too inconspicious, so I added it to the footer > since I was messing with it anyway) > > You can find a built version of the docs at: > https://pm215.gitlab.io/-/qemu/-/jobs/1399259647/artifacts/public/index.html > > I had a look at getting our manpages to also state the license, > but this is tricky due to various deficiencies in Sphinx. > (We never have stated the license in our manpages, so this isn't > a regression compared to the old texinfo setup.) > > Markus: do you feel this series is sufficient that we can remove > the TODO lines in docs/interop/qemu-ga-ref.rst, > docs/interop/qemu-qmp-ref.rst and docs/interop/qemu-storage-daemon-qmp-ref.rst > as now being done? Ping for any further review/opinions, in particular from Markus. I'm intending to put this in for 6.1. thanks -- PMM
