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
