Re: doc build warnings when building out-of-tree

Subject: Re: doc build warnings when building out-of-tree

Date: Sat, 30 May 2020 13:28:47 -0300

To: Daniel Kahn Gillmor, Notmuch Mail


From: David Bremner

Daniel Kahn Gillmor <> 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?


notmuch mailing list