Re: [RFC Patch v3 2/3] doc: add target rst2man to build man pages using rst2man

Subject: Re: [RFC Patch v3 2/3] doc: add target rst2man to build man pages using rst2man

Date: Sun, 23 Feb 2014 19:57:11 -0400

To: Tomi Ollila, notmuch@notmuchmail.org

Cc:

From: David Bremner


Tomi Ollila <tomi.ollila@iki.fi> writes:

> Anyway, I tried to build manual pages using 'make man' and got this:
>
>   $ make man
>   sphinx-build -b man -d doc/_build/doctrees -q -c doc doc doc/_build/man
>   Sphinx error:
>   Builder name man not registered

It seems you need sphinx version 1.0, from July 2010 for the man
builder.

> No fallback to use rst2man...

I don't really plan on an automatic fallback. There is currently a
separate target rst2man.  I'm open to better names for the targets.

> Comments regarding prerst2man.py inline below:

Yeah, I'm sure there's lots that could be improved with that script. But
I'll wait until I see if the general approach is acceptable.

d

Thread: