[Qemu-devel] [PATCH v3 09/12] Makefile, configure: Support building rST documentation

[Eric Blake]

On 3/5/19 11:21 AM, Peter Maydell wrote:
> Add support to our configure and makefile machinery for building
> our rST docs into HTML files.
> 
> Building the documentation now requires that sphinx-build is
> available; this seems better than allowing half the docs to
> be built if it is not present but having half of them missing.
> (In particular it means that assuming that distros configured with
> --enable-docs they'll get a helpful error from configure telling
> them the new build dependency.)
> 
> Signed-off-by: Peter Maydell <address@hidden>
> Reviewed-by: Philippe Mathieu-Daudé <address@hidden>
> Tested-by: Philippe Mathieu-Daudé <address@hidden>
> Acked-by: Aleksandar Markovic <address@hidden>
> Message-id: address@hidden

Rich told me that qemu-nbd.8 was not being built, and I confirmed that
it failed to build for me. git bisect points to this commit as the
reason that 'touch qemu-nbd.texi; make' no longer rebuilds qemu-nbd.8
automatically. Is it merely because I don't have enough stuff installed,
or is it an actual broken dependency?

/me goes and runs 'dnf install "*/sphinx-build"...

Nope, even with that installed, qemu-nbd.8 is still not getting built by
'make'; but 'make qemu-nbd.8' is working. We lost a dependency :(

-- 
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3226
Virtualization:  qemu.org | libvirt.org

signature.asc
Description: OpenPGP digital signature