Re: [PATCH v3 00/33] Convert qemu-doc to rST

[Peter Maydell]

On Fri, 28 Feb 2020 at 21:20, Stefan Weil <address@hidden> wrote:
> Maybe it is sufficient to update qemu.nsi after that series was merged.

If you're happy to do it that way round I think that would certainly
make life easier in trying to get this series merged without too
much delay.

> Do you think that all documentation should be part of the Windows
> installer, although it is also available online? Too much documentation
> can be confusing, because it makes it more difficult to find the right
> entry.

I don't have a strong opinion here, but:
 * the contents that were in qemu-doc.html will now be in the
   various Sphinx manuals, so if we want to install any
   docs locally at all then installing at least the system/
   manual would be the equivalent of the old qemu-doc
 * is there a strong reason for the Windows installer not
   to just install the same set of HTML docs that the Linux
   'make install' does?

Three possible choices:
 (1) don't install any docs locally at all (rely on the online docs)
 (2) install just the 'system' manual (this will catch most of the
   documentation relevant for Windows, but misses a few bits
   like the guest-agent docs which might still matter for Windows users)
 (3) install all the manuals (this will include some manuals or sections
    definitely not of interest for Windows, like the linux-user manual)

thanks
-- PMM