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

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

Date: Tue, 14 Jan 2014 14:27:48 +0200

To: David Bremner, notmuch@notmuchmail.org

Cc:

From: Tomi Ollila


On Tue, Jan 14 2014, David Bremner <david@tethera.net> wrote:

> 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?

No if we can avoid it :D

>  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.

For emacs-only docs IMHO texi/info would suffice. But I quess some docs
should be shipped both in info & man formats. for that we'd need such
a conversion tools anyway...


> d


Tomi

Thread: