]> git.notmuchmail.org Git - notmuch/commit
doc: fix for out-of-tree builds of notmuch-emacs docs
authorDavid Bremner <david@tethera.net>
Sun, 31 May 2020 16:15:03 +0000 (13:15 -0300)
committerDavid Bremner <david@tethera.net>
Mon, 1 Jun 2020 12:07:50 +0000 (09:07 -0300)
commitee8dba1c3013a00c0d1185583ea084f8ce3699b7
tree2c54906711a63e16845a34b02cb27cb191b517d0
parent16d073ebe8fe062bb733165bdb10d7d2937616b5
doc: fix for out-of-tree builds of notmuch-emacs docs

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.
doc/Makefile.local
doc/conf.py
doc/notmuch-emacs.rst