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

[Tomi Ollila]

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

> Tomi Ollila <tomi.ollila at 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