<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/doc/Makefile.local, branch 0.38.2</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=0.38.2</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=0.38.2'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2023-09-12T11:07:37Z</updated>
<entry>
<title>build: clean up __pycache__ directories</title>
<updated>2023-09-12T11:07:37Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2023-09-10T23:13:13Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=b21747e0c3b7e2a779f5fad10cef4c8fcf233ae4'/>
<id>urn:sha1:b21747e0c3b7e2a779f5fad10cef4c8fcf233ae4</id>
<content type='text'>
These are generated indirectly by certain uses of python in the build.
</content>
</entry>
<entry>
<title>doc: replace symlink with copies for nmbug, notmuch-setup</title>
<updated>2022-07-03T21:01:57Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2022-07-01T01:14:20Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=3cb936b7c458bc9b0f5cc6d7fb266307fd0224d8'/>
<id>urn:sha1:3cb936b7c458bc9b0f5cc6d7fb266307fd0224d8</id>
<content type='text'>
Previously only man page aliases were being added as symlinks.  The
addition to man_pages in conf.py automatically propagates to the list
of generated info pages.

Installation of the new pages is handled by existing recipes.
</content>
</entry>
<entry>
<title>CLI/git: change defaults for repo and prefix</title>
<updated>2022-06-17T11:40:19Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2022-05-07T13:32:18Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=8ed68c1bbe8c1b7bb69d7bea1e0c8919bfcb0d0a'/>
<id>urn:sha1:8ed68c1bbe8c1b7bb69d7bea1e0c8919bfcb0d0a</id>
<content type='text'>
The previous defaults were not suitable for personal (i.e. not
bugtracking for notmuch development) use.

Provide two ways for the user to select nmbug compatible defaults;
command line argument and checking the name of the script.
</content>
</entry>
<entry>
<title>doc: add dep. on stamp file for rebuilding gzipped man pages.</title>
<updated>2021-12-25T11:32:27Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2021-12-24T16:20:31Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=02d8ff376d77e5d96389c30576221a7ac5b4bea1'/>
<id>urn:sha1:02d8ff376d77e5d96389c30576221a7ac5b4bea1</id>
<content type='text'>
In [1] Daniel observed that the gzipped man pages were only being
rebuild every second time when building with `make -j4'. This may be
caused by a race condition between sphinx-build rebuilding the roff
files and the recipe to gzip them. This commit sequentializes these
two steps by making the stamp file a prerequisite for (all of) the
gzip files.

[1]: id:87tveotn1g.fsf@fifthhorseman.net
</content>
</entry>
<entry>
<title>doc: introduce stamp file for info build</title>
<updated>2021-12-23T12:01:28Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2021-12-04T23:47:51Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=b7e08901e8ab695fb75de0528871771009f49aa8'/>
<id>urn:sha1:b7e08901e8ab695fb75de0528871771009f49aa8</id>
<content type='text'>
This partially fixes (i.e. just for sphinx) the problem reported by
Daniel in id:87r29wwgq2.fsf@fifthhorseman.net.
</content>
</entry>
<entry>
<title>doc: replace phony target with variable</title>
<updated>2021-12-23T12:01:11Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2021-12-04T23:47:50Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=d825847b522f2b84abf087d90b57275502f37163'/>
<id>urn:sha1:d825847b522f2b84abf087d90b57275502f37163</id>
<content type='text'>
Depending on a phony target seems like a good way to always trigger a
recipe.
</content>
</entry>
<entry>
<title>doc/python-cffi: import from built bindings, not installed module</title>
<updated>2021-12-04T00:25:59Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2021-10-29T14:54:59Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=48b5263646bae2ce40e3ec17e0cfae26a7abc91f'/>
<id>urn:sha1:48b5263646bae2ce40e3ec17e0cfae26a7abc91f</id>
<content type='text'>
Previously the python-cffi bindings either failed to build, or built
for the wrong module by using the installed module.

The fix requires correction the module path, building the bindings
before docs, and helping python find the built libnotmuch.

Based on patch / discussion from Micheal Gruber [1]

[1]: id:cover.1634808719.git.git@grubix.eu
</content>
</entry>
<entry>
<title>build/docs: move docstring prereq to file targets</title>
<updated>2020-12-10T01:55:38Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2020-12-10T01:55:38Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=ed7ca948ae31ac0e1d3633a2f58fb3e4aecd03de'/>
<id>urn:sha1:ed7ca948ae31ac0e1d3633a2f58fb3e4aecd03de</id>
<content type='text'>
Under a sufficiently high level of parallelism [1] there seems to be a
a race condition that allows sphinx-build to start running before the
docstrings are extracted. This change moves the docstring stamp from
the phony targets sphinx-html and sphinx-info to the file targets that
they depend on. I'm not sure why this makes things better, but I am
fairly confident it does not make things worse, and experimentally it
seems to eliminate the race condition.

[1]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=976934
</content>
</entry>
<entry>
<title>emacs: Use makefile-gmake-mode in Makefile*s</title>
<updated>2020-08-10T00:14:36Z</updated>
<author>
<name>Jonas Bernoulli</name>
<email>jonas@bernoul.li</email>
</author>
<published>2020-08-08T11:49:49Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=c4541353765dec837c1c2f912b1bf6661827429c'/>
<id>urn:sha1:c4541353765dec837c1c2f912b1bf6661827429c</id>
<content type='text'>
Use `makefile-gmake-mode' instead of `makefile-mode' because the
former also highlights ifdef et al. while the latter does not.

"./Makefile.global" and one "Makefile.local" failed to specify any
major mode at all but doing so is necessary because Emacs does not
automatically figure out that these are Makefiles (of any flavor).
</content>
</entry>
<entry>
<title>doc: replace use of environment variables with a generated config</title>
<updated>2020-07-15T11:32:15Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2020-07-11T13:20:26Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=0e03e2d45e36edb635229f356bf41f153c30a70f'/>
<id>urn:sha1:0e03e2d45e36edb635229f356bf41f153c30a70f</id>
<content type='text'>
It is getting unwieldy to pass configuration options on the
sphinx-build command line, and I anticipate further use of
conditionals.

As far as I could tell, execing a string is the idiomatic way to
emulate include in Python.
</content>
</entry>
</feed>
