Re: [Qemu-devel] [PATCH v3] qemu-ga: Convert invocation documentation to rST

[Peter Maydell]

On Fri, 20 Sep 2019 at 09:57, Miroslav Rezanina <address@hidden> wrote:
>
> On Thu, Sep 05, 2019 at 02:10:40PM +0100, Peter Maydell wrote:
> > The qemu-ga documentation is currently in qemu-ga.texi in
> > Texinfo format, which we present to the user as:
> >  * a qemu-ga manpage
> >  * a section of the main qemu-doc HTML documentation
> >
> > Convert the documentation to rST format, and present it to
> > the user as:
> >  * a qemu-ga manpage
> >  * part of the interop/ Sphinx manual
> >
> > Signed-off-by: Peter Maydell <address@hidden>
> > Reviewed-by: Michael Roth <address@hidden>
> > Tested-by: Michael Roth <address@hidden


> This patch is breaking build for me. It fails on:
>
>     perl -Ww -- /builddir/build/BUILD/qemu-4.1.0/scripts/texi2pod.pl -I docs 
> -I scripts -I docs/interop -DVERSION="4.1.50" -DCONFDIR="/etc/qemu-kvm" 
> scripts/texi2pod.pl docs/interop/qemu-ga.8.pod && pod2man --utf8 --section=8 
> --center=" " --release=" " docs/interop/qemu-ga.8.pod > docs/interop/qemu-ga.8
>
> with:
>
>    No filename or title
>
> Not sure why this is happening.

Yes, it's a bug in the handling of in-tree builds (out-of-tree
builds work fine and we generally recommend those as better anyway).
I have a patch on list which should fix the in-tree build case:

https://patchew.org/QEMU/address@hidden/

thanks
-- PMM