[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 0/7] docs: State QEMU version and license in all HTML footers
From: |
Peter Maydell |
Subject: |
Re: [PATCH 0/7] docs: State QEMU version and license in all HTML footers |
Date: |
Tue, 13 Jul 2021 15:31:47 +0100 |
On Mon, 5 Jul 2021 at 10:55, Peter Maydell <peter.maydell@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
- Re: [PATCH 5/7] docs: Add some actual About text to about/index.rst, (continued)
- [PATCH 3/7] docs: Remove "Contents:" lines from top-level subsections, Peter Maydell, 2021/07/05
- [PATCH 7/7] docs: Add QEMU version information to HTML footer, Peter Maydell, 2021/07/05
- [PATCH 2/7] docs: Stop calling the top level subsections of our manual 'manuals', Peter Maydell, 2021/07/05
- [PATCH 6/7] docs: Add license note to the HTML page footer, Peter Maydell, 2021/07/05
- Re: [PATCH 0/7] docs: State QEMU version and license in all HTML footers,
Peter Maydell <=
- Re: [PATCH 0/7] docs: State QEMU version and license in all HTML footers, Markus Armbruster, 2021/07/14