<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/doc/Makefile.local, branch 0.29.3</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=0.29.3</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=0.29.3'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2019-06-11T00:48:03Z</updated>
<entry>
<title>doc: Don't install emacs docs when they are not built</title>
<updated>2019-06-11T00:48:03Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-06-10T10:11:50Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=3ec47e1165064d4937044c02e882612a3e3a7671'/>
<id>urn:sha1:3ec47e1165064d4937044c02e882612a3e3a7671</id>
<content type='text'>
In 40b025 we stopped building the notmuch-emacs documentation if
HAVE_EMACS=0 (i.e. no emacs was detected by configure). Unfortunately
we continued to try to install the (non-existent) documentation, which
causes build/install failures.

As a bonus, we also avoid installing the documentation if the user
configures --without-emacs.

Thanks to Ralph Seichter for reporting the problem, and testing
previous versions of this fix.
</content>
</entry>
<entry>
<title>doc: don't build notmuch-emacs.info for configure --without-emacs</title>
<updated>2019-06-11T00:46:55Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-06-11T00:06:57Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=71bf459596c72cf72b89c6ae2f47b1f5cf7548db'/>
<id>urn:sha1:71bf459596c72cf72b89c6ae2f47b1f5cf7548db</id>
<content type='text'>
Since the docstrings are not built in the case of --without-emacs,
even if emacs is detected, don't let sphinx build the emacs docs. This
avoids a large number of error messages due to missing includes. It's
actually a bit surprising sphinx doesn't generate an error for the
missing include files.
</content>
</entry>
<entry>
<title>doc: use separate doctrees for distinct builders</title>
<updated>2019-06-03T10:35:30Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-06-01T02:24:52Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=6edc073e4496b71d24e339f4d0cca41c2e4ac3e1'/>
<id>urn:sha1:6edc073e4496b71d24e339f4d0cca41c2e4ac3e1</id>
<content type='text'>
It seems our previous attempt with order-only targets was not
sufficient to avoid problems with sphinx-builds doctree cache [0].
Looking around at other people's approaches [1], using separate
doctrees was suggested. I guess there might be a slight loss of
efficiency, but it seems more robust.

[0]: build failures were first noticed in Debian experimental, but I was able to duplicate it in
     my usual build environment about 1 in 8 builds.

[1]: in particular
     https://salsa.debian.org/mpd-team/mpc/commit/9e3fc1657d043d75755993846c93f7700b97f907
</content>
</entry>
<entry>
<title>doc: exclude notmuch-emacs.rst if emacs is not present.</title>
<updated>2019-04-24T09:53:13Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-04-21T23:41:34Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=40b025c5f1cc3dafe4c30cd6005fdb2ba32e0c95'/>
<id>urn:sha1:40b025c5f1cc3dafe4c30cd6005fdb2ba32e0c95</id>
<content type='text'>
This will still generate a warning about an excluded document in the
toctree, but it cuts down on the noise quite a lot.
</content>
</entry>
<entry>
<title>doc: use stamp file for html docs</title>
<updated>2019-04-24T09:53:13Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-04-21T17:00:18Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=4f0fe36c47a43950f6f4df82630ef062976ebceb'/>
<id>urn:sha1:4f0fe36c47a43950f6f4df82630ef062976ebceb</id>
<content type='text'>
These are less time consuming than the texi docs to rebuild (because
the texi rebuild triggers info rebuild), but still take noticable time.
</content>
</entry>
<entry>
<title>doc: use stamp file to control rebuilding texi</title>
<updated>2019-04-24T09:53:07Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-04-21T16:53:03Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=f0399db513ce2f12b94cd8aefe54be408d39fb62'/>
<id>urn:sha1:f0399db513ce2f12b94cd8aefe54be408d39fb62</id>
<content type='text'>
Apparently the sphinx-doc texinfo builder is not smart enough to only
rebuild those files where the source has changed.
</content>
</entry>
<entry>
<title>doc/build: use $(MAKE) instead of make</title>
<updated>2019-03-19T23:54:15Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-03-19T23:50:28Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=0557c5a0333b971188c02c961dec88496f2eed0c'/>
<id>urn:sha1:0557c5a0333b971188c02c961dec88496f2eed0c</id>
<content type='text'>
This should silence some warnings about the jobserver, but also make
it easier to build the docs where GNU make is called something other
than make.

Based on a patch from aidecoe.
</content>
</entry>
<entry>
<title>Merge branch 'release'</title>
<updated>2019-03-06T12:53:26Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-03-06T12:53:26Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=71eaa19350883b30bafe885ea083c2e3f1621e10'/>
<id>urn:sha1:71eaa19350883b30bafe885ea083c2e3f1621e10</id>
<content type='text'>
Changes from 0.28.3
</content>
</entry>
<entry>
<title>doc: sequentialize calls to sphinx-build</title>
<updated>2019-03-06T01:46:41Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2019-03-03T03:30:59Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=dcf7fca2d9f87fc4d412dbbba8e441d9ff204ffc'/>
<id>urn:sha1:dcf7fca2d9f87fc4d412dbbba8e441d9ff204ffc</id>
<content type='text'>
In certain conditions the parallel calls to sphinx-build could
collide, yielding a crash like

Exception occurred:
  File "/usr/lib/python3/dist-packages/sphinx/environment.py", line 1261, in get_doctree
    doctree = pickle.load(f)
EOFError: Ran out of input
</content>
</entry>
<entry>
<title>doc: make man pages depend on emacs docstrings</title>
<updated>2018-12-20T08:30:11Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2018-12-20T08:30:11Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=e52535029b3976589e2817da515fd98120718947'/>
<id>urn:sha1:e52535029b3976589e2817da515fd98120718947</id>
<content type='text'>
This is nonsensical on the face of it, but is needed (for now) because
the notmuch-emacs page is unconditionally included in index.rst.
</content>
</entry>
</feed>
