From: Tomi Ollila Date: Tue, 14 Jan 2014 12:27:48 +0000 (+0200) Subject: Re: [PATCH 2/3] man: partial conversion to pod. X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=9ec7f91692023b969657bab2fa88a4e08e640c87;p=notmuch-archives.git Re: [PATCH 2/3] man: partial conversion to pod. --- diff --git a/2b/90e22a5a3f16070c4fb42d6c65989b924dbba4 b/2b/90e22a5a3f16070c4fb42d6c65989b924dbba4 new file mode 100644 index 000000000..63f82cd77 --- /dev/null +++ b/2b/90e22a5a3f16070c4fb42d6c65989b924dbba4 @@ -0,0 +1,90 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by olra.theworths.org (Postfix) with ESMTP id AC799431FAF + for ; Tue, 14 Jan 2014 04:28:05 -0800 (PST) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: 0 +X-Spam-Level: +X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none] + autolearn=disabled +Received: from olra.theworths.org ([127.0.0.1]) + by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id e3crumKbfKVW for ; + Tue, 14 Jan 2014 04:27:56 -0800 (PST) +Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34]) + by olra.theworths.org (Postfix) with ESMTP id B4FAE431FAE + for ; Tue, 14 Jan 2014 04:27:56 -0800 (PST) +Received: from guru.guru-group.fi (localhost [IPv6:::1]) + by guru.guru-group.fi (Postfix) with ESMTP id D96BD100086; + Tue, 14 Jan 2014 14:27:48 +0200 (EET) +From: Tomi Ollila +To: David Bremner , notmuch@notmuchmail.org +Subject: Re: [PATCH 2/3] man: partial conversion to pod. +In-Reply-To: <87d2jukbsf.fsf@zancas.localnet> +References: <1366852752-3584-1-git-send-email-david@tethera.net> + <1388921950-5017-1-git-send-email-david@tethera.net> + <1388921950-5017-3-git-send-email-david@tethera.net> + + <87d2jukbsf.fsf@zancas.localnet> +User-Agent: Notmuch/0.17+34~g98b959f (http://notmuchmail.org) Emacs/24.3.1 + (x86_64-unknown-linux-gnu) +X-Face: HhBM'cA~ +MIME-Version: 1.0 +Content-Type: text/plain +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.13 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Tue, 14 Jan 2014 12:28:05 -0000 + +On Tue, Jan 14 2014, David Bremner wrote: + +> Tomi Ollila 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