Re: [PATCH 2/3] man: partial conversion to pod.

Subject: Re: [PATCH 2/3] man: partial conversion to pod.

Date: Tue, 14 Jan 2014 08:06:40 -0400

To: Tomi Ollila, notmuch@notmuchmail.org

Cc:

From: David Bremner


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

> IMHO it is good idea to have common format where to produce man, info &
> html files. If we're going to need pandoc then the question of source
> format explodes with choices...

Hi Tomi;

I'm not sure how to interpret this. Are you in favour of using pandoc to
produce documentation?  As you say we have more choice about source
format in that case. We could even try producing all of the
notmuch-emacs documentation from the common format (as opposed to just
part of it). On the other hand I guess the dependency would be a problem
for people using old linux distros, not to mention less common choices
like *BSD and OS X.

One thing I haven't tried is generating info/notmuch-emacs.texi from
pod. I guess that would make sense if people felt strongly that one
format for all the docs is a priority. I worry a bit about the two step
pod -> texi -> info conversion process, but it's only a hunch.

d

Thread: