<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/doc/Makefile.local, branch 0.18_rc0</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=0.18_rc0</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=0.18_rc0'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2014-04-22T05:24:04Z</updated>
<entry>
<title>doc: remove conf.pyc on clean</title>
<updated>2014-04-22T05:24:04Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-04-22T05:24:04Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=95aa988a06496027300f09d9db863a5cd89b201c'/>
<id>urn:sha1:95aa988a06496027300f09d9db863a5cd89b201c</id>
<content type='text'>
This build artifict messes up the packaging process for (at least)
Debian if not removed on clean.
</content>
</entry>
<entry>
<title>doc: Fix parallel build of roff files</title>
<updated>2014-04-18T20:55:30Z</updated>
<author>
<name>Austin Clements</name>
<email>amdragon@MIT.EDU</email>
</author>
<published>2014-04-17T20:34:57Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=59c6103e1c169c3b65e8d63dc2211c6ad0e24841'/>
<id>urn:sha1:59c6103e1c169c3b65e8d63dc2211c6ad0e24841</id>
<content type='text'>
The roff build rule builds all of the roff files in a single command.
Previously, this was expressed as a multi-target rule, but since this
is equivalent to specifying a copy of the rule for each target, make
-jN could start up to N parallel instances of this command.  Fix this
by bottlenecking this rule through a single stamp file.

This also removes the unused man.stamp from CLEAN.
</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: configure detection of sphinx and rst2man</title>
<updated>2014-03-18T10:39:32Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-03-13T03:21:16Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=beef0a8f5593eee0f84b2b0fa01017c1c9621659'/>
<id>urn:sha1:beef0a8f5593eee0f84b2b0fa01017c1c9621659</id>
<content type='text'>
Because sphinx-build does not provide a convenient way of listing
which builders exist, and some people actually have pre 1.0 sphinx, we
try loading a relevant python module.

Currently the assumption is that no python in path -&gt; no sphinx-build
in path.
</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>
<entry>
<title>doc: add target rst2man to build man pages using rst2man</title>
<updated>2014-03-09T13:41:09Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-01-28T16:12:38Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=df70fc4b4b7295f9f5c512c5e1e5c8c46a620944'/>
<id>urn:sha1:df70fc4b4b7295f9f5c512c5e1e5c8c46a620944</id>
<content type='text'>
Many people have docutils installed, but not sphinx. Allow these
people to build the man pages.
</content>
</entry>
<entry>
<title>doc: convert sphinx based docs</title>
<updated>2014-03-09T13:41:08Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2014-01-28T16:12:37Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=d736260385a689b5c77d8121f48e29440e3adfa4'/>
<id>urn:sha1:d736260385a689b5c77d8121f48e29440e3adfa4</id>
<content type='text'>
This is the output from sphinx-quickstart, massaged a bit, along with
our existing man pages converted to rst.

A skeleton notmuch-emacs manual is also included. It is not suitable
for end user use yet.
</content>
</entry>
</feed>
