<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/doc/Makefile.local, branch 0.25.1</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=0.25.1</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=0.25.1'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2016-11-17T12:42:23Z</updated>
<entry>
<title>build: only install known man pages</title>
<updated>2016-11-17T12:42:23Z</updated>
<author>
<name>Jani Nikula</name>
<email>jani@nikula.org</email>
</author>
<published>2016-11-05T20:18:18Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=ae97630dbfbfce2bc3394dafeea83441115eaaaf'/>
<id>urn:sha1:ae97630dbfbfce2bc3394dafeea83441115eaaaf</id>
<content type='text'>
Install man pages based on $(MAN_GZIP_FILES), which directly
corresponds to the man page source rst files. This way we can filter
the man pages to be installed as needed.
</content>
</entry>
<entry>
<title>build: generate man page list from source files, not conf.py</title>
<updated>2016-11-17T12:41:24Z</updated>
<author>
<name>Jani Nikula</name>
<email>jani@nikula.org</email>
</author>
<published>2016-11-05T20:18:17Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=76ab6e99625468b011723a6bd9d84be5fab15d02'/>
<id>urn:sha1:76ab6e99625468b011723a6bd9d84be5fab15d02</id>
<content type='text'>
Use $(wildcard ...) to generate the list of man pages based on the rst
source files present in the man page directories, instead of reading
conf.py. This has three main benefits:

1) This makes the man page build slightly less complicated and easier
   to understand. At least there are fewer moving parts.

2) This makes the build fail if we add a man page rst file, but fail
   to add it to conf.py.

3) We can use Sphinx constructs in conf.py that are not available when
   importing the file into a normal python program such as
   mkdocdeps.py.
</content>
</entry>
<entry>
<title>build: do not touch roff files after sphinx-build</title>
<updated>2016-11-17T12:40:07Z</updated>
<author>
<name>Jani Nikula</name>
<email>jani@nikula.org</email>
</author>
<published>2016-11-05T20:18:16Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=a7a683b120ea8be1fe619d12a7d8a201de0652e6'/>
<id>urn:sha1:a7a683b120ea8be1fe619d12a7d8a201de0652e6</id>
<content type='text'>
If Sphinx fails to create any of the roff files, having touch create
them hides the errors until someone realizes, possibly much later,
that the resulting files are empty. (Note that gzip doesn't fail on
empty input files.) Sphinx will change the timestamps of any files it
has written anyway.
</content>
</entry>
<entry>
<title>replace hardcoded "python" with configured python command</title>
<updated>2015-07-10T16:13:28Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2015-07-10T16:13:28Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=82d8d0b062148b0e26ed344189275421799b1095'/>
<id>urn:sha1:82d8d0b062148b0e26ed344189275421799b1095</id>
<content type='text'>
Thanks to FreeBSD port maintainer Mikhail for report and the original
the original patch.

This is the right thing (TM) and also apparently fixes the build on
FreeBSD.
</content>
</entry>
<entry>
<title>doc: gzipped notmuch.3 before trying to install notmuch.3.gz</title>
<updated>2015-01-25T14:04:51Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2015-01-25T14:04:51Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=b9e7b8e8f08e9abb18d8f0a9028b18932ff3e565'/>
<id>urn:sha1:b9e7b8e8f08e9abb18d8f0a9028b18932ff3e565</id>
<content type='text'>
If HAVE_SPHINX=0 but HAVE_DOXYGEN=1, then the previous version was
trying to install notmuch.3.gz but only got as far as creating
notmuch.3
</content>
</entry>
<entry>
<title>doc: remove support for rst2man</title>
<updated>2015-01-22T07:37:25Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2015-01-18T16:55:10Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=d241a486facf1002b29e499c2fb96a302bfd825b'/>
<id>urn:sha1:d241a486facf1002b29e499c2fb96a302bfd825b</id>
<content type='text'>
It was becoming increasingly complicated to support rst2man, and there
were apparently not many people that relied on it.
</content>
</entry>
<entry>
<title>doc: 'rm -f' potential doxygen temporary output file</title>
<updated>2014-09-02T15:43:20Z</updated>
<author>
<name>Tomi Ollila</name>
<email>tomi.ollila@iki.fi</email>
</author>
<published>2014-09-01T18:44:59Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=ef5e66ae8e84fce75154417dd51be72f78ec1f45'/>
<id>urn:sha1:ef5e66ae8e84fce75154417dd51be72f78ec1f45</id>
<content type='text'>
Some (older) Doxygen versions do not create such a temporary file.
</content>
</entry>
<entry>
<title>docs: remove spurious man page generated from doxygen</title>
<updated>2014-07-13T11:59:02Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-07-12T21:04:52Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=5694d72a8367931776890e3a8ffb23e5bf5b34b7'/>
<id>urn:sha1:5694d72a8367931776890e3a8ffb23e5bf5b34b7</id>
<content type='text'>
There is a doxygen bug about these odd files,

      https://bugzilla.gnome.org/show_bug.cgi?id=727796

But it isn't clear if / when a fix will be provided, so just delete it
to avoid e.g. confusing man-to-wiki.pl
</content>
</entry>
<entry>
<title>doc: postprocess notmuch.3</title>
<updated>2014-07-09T22:32:44Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-07-01T19:13:03Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=934e333a08e7f0ef24a3f139dd3d8738d28f1bd5'/>
<id>urn:sha1:934e333a08e7f0ef24a3f139dd3d8738d28f1bd5</id>
<content type='text'>
Remove excess italics from doxygen output. It seems to make no
sense (and is certainly ugly) to italicize the first argument to the
.RI macro.
</content>
</entry>
<entry>
<title>doc: build and install doxygen api docs</title>
<updated>2014-07-09T22:32:15Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-07-01T16:40:33Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=10224335514b70acc95f89ced4d900bd6c94990b'/>
<id>urn:sha1:10224335514b70acc95f89ced4d900bd6c94990b</id>
<content type='text'>
In order to support out of tree builds and avoid hardcoding version
number, generate `doc/config.dox` from configure.
</content>
</entry>
</feed>
