<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/doc/mkdocdeps.py, branch master</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=master</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=master'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2016-11-17T12:41:24Z</updated>
<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>doc/mkdocdeps.py: Use "with" statement for the output file</title>
<updated>2014-04-21T12:31:45Z</updated>
<author>
<name>W. Trevor King</name>
<email>wking@tremily.us</email>
</author>
<published>2014-04-05T17:31:06Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=427b3db243626916d739e2709c5a91212afb5084'/>
<id>urn:sha1:427b3db243626916d739e2709c5a91212afb5084</id>
<content type='text'>
Before this patch, the open was unnecessarily early and relied on the
process cleanup to close.  Neither one of these was a real problem,
but PEP 343's context managers (which landed in Python 2.5) make
proper cleanup very easy.

[1]: http://legacy.python.org/dev/peps/pep-0343/
</content>
</entry>
<entry>
<title>doc/mkdocdeps.py: Convert execfile to import</title>
<updated>2014-04-21T12:31:36Z</updated>
<author>
<name>W. Trevor King</name>
<email>wking@tremily.us</email>
</author>
<published>2014-04-05T17:31:05Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=b10b12da890d31819e411aec5158dca99359e830'/>
<id>urn:sha1:b10b12da890d31819e411aec5158dca99359e830</id>
<content type='text'>
excefile is gone in Python 3 [1].  Instead of exec-ing the
configuration, it's easier to insert the source directory in Python's
path [2], and just import the configuration.  With this change,
mkdocdeps.py is compatible with both Python 2 and 3.

[1]: https://docs.python.org/3.0/whatsnew/3.0.html#builtins
[2]: https://docs.python.org/3/library/sys.html#sys.path
</content>
</entry>
<entry>
<title>doc: fix out-of-tree build</title>
<updated>2014-03-25T11:32:10Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-03-20T00:48:03Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=57b4ef6f30d41cd14aa570b329841fc2082260ff'/>
<id>urn:sha1:57b4ef6f30d41cd14aa570b329841fc2082260ff</id>
<content type='text'>
The subtle part is adding .rst and .py files to vpath so they can be
used as dependencies without prefixing with $(srcdir)

We also change the interface to mkbuildeps.py: rather than getting the
containing directory from the conf file path, we go the other way.
</content>
</entry>
<entry>
<title>doc: build man pages into hierarchy, fix help test.</title>
<updated>2014-03-18T10:39:12Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-03-13T03:21:15Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=533639b143202d333eb964aa0c6a860db0809344'/>
<id>urn:sha1:533639b143202d333eb964aa0c6a860db0809344</id>
<content type='text'>
It turns out there was a reason the old man pages were stored in a man
compatible hierarchy, namely so that we could run man on them before
installing.

Hardcode doc build location into test suite.  This isn't ideal, but
let's unbreak the test suite for now.
</content>
</entry>
<entry>
<title>doc: build man pages at build time; introduce HAVE_SPHINX, HAVE_RST2MAN</title>
<updated>2014-03-18T10:38:57Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-03-13T03:21:14Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=9d9a700f1de6352b4f51a00ab80f2fcd70da050d'/>
<id>urn:sha1:9d9a700f1de6352b4f51a00ab80f2fcd70da050d</id>
<content type='text'>
This helps avoid build artifacts (namely, nroff and gzipped-nroff man
pages) owned by root.

The variables allow choosing which generator to use for the man page.
These will be hooked to configure in a following commit.
</content>
</entry>
<entry>
<title>doc: install sphinx version of man pages</title>
<updated>2014-03-09T13:41:09Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-03-05T13:34:10Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=6f8daa39895c600180530618abc0eb86d56500d0'/>
<id>urn:sha1:6f8daa39895c600180530618abc0eb86d56500d0</id>
<content type='text'>
The python script mkdocdeps.py is used to import the list of man pages
from the sphinx configuration to make.

This will delete the (release only) target update-man-versions. This
will be replaced in a followup commit.
</content>
</entry>
</feed>
