doc build warnings when building out-of-tree

[David Bremner]

Daniel Kahn Gillmor <dkg at fifthhorseman.net> writes:

> When building out-of-tree, the documentation (both manpages and info
> files) are incomplete, but they do not explicitly fail.  build logs
> follow from doing "mkdir build && ../configure && make".
>
> If there's a way to make these warnings into hard failures, i think that
> would be good -- we don't want to accidentally ship the output they
> create.  And of course actually fixing it would be even better.
>
> I'm afraid i'm not proficient enough in sphinx to know how to do either,
> so i'm just reporting a bug for now.
>

I can't duplicate these errors with sphinx-doc 2.4.3-3 on Debian.

Are the rsti files actually being built before calling sphinx-build?

d