[PATCH] doc: fix for out-of-tree builds of notmuch-emacs docs
David Bremner
david at tethera.net
Mon Jun 1 05:12:27 PDT 2020
Tomi Ollila <tomi.ollila at iki.fi> writes:
> On Sun, May 31 2020, David Bremner wrote:
>
>> The sphinx-doc include directive does not have the ability to include
>> files from the build tree, so we replace the include with reading the
>> files in conf.py. The non-trivial downside of this is that the emacs
>> docstrings are now defined for every rst source file. They are
>> namespaced with docstring::, so hopefully there will not be any
>> surprises. One thing that is noticable is a small (absolute) time
>> penalty in running sphinx-doc.
>
> IMO good enough tolerable hack to get this done for no (read: I don't
> know alternatives).
>
> Some comments below...
Pushed a version with most of Tomi's comments applied (and
s/append/extend/)
d
More information about the notmuch
mailing list