Re: [PATCH 135/147] meson: sphinx-build

[Peter Maydell]

On Mon, 10 Aug 2020 at 20:31, Paolo Bonzini <pbonzini@redhat.com> wrote:
>
> On 10/08/20 21:21, Peter Maydell wrote:
> >> Yes, because the Makefile's approach is not maintainable in my opinion;
> >> *.rst.inc files were already not included in the Makefile.  I'll look
> >> into using a Sphinx extension to produce a dependency file.
> >
> > Yeah, agreed that the makefile approach isn't great. (It lists
> > some .rst.inc files but we added more without updating the
> > dependencies, I think.)
> >
> > If Sphinx can be persuaded to output a dependency file that
> > would certainly be the nicest approach; I hadn't thought
> > of trying that.
>
> It should be possible and probably not too hard once I figure out how
> Sphinx events work.  It's a fair request since build_always_stale is
> inferior and Meson requires no particular magic to include the depfile.
>  Maybe that will win you over. :)
>
> I can also leave out sphinx from the initial conversion.

If we have a working-but-build-always conversion for Sphinx
I'd be happy to take that and then upgrade it to processing
the dependencies properly later.

(The thing I'm not really looking forward to is updating
the qapi-doc-to-rst patchset to Meson...)

thanks
-- PMM