From: David Bremner Date: Tue, 14 Jan 2014 12:06:40 +0000 (+2000) Subject: Re: [PATCH 2/3] man: partial conversion to pod. X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=d0d235d1d340a80c6503b5c5a230f306c456a78f;p=notmuch-archives.git Re: [PATCH 2/3] man: partial conversion to pod. --- diff --git a/86/443118ead95dbca7cff853dafb1be35f7b5cde b/86/443118ead95dbca7cff853dafb1be35f7b5cde new file mode 100644 index 000000000..815dc3296 --- /dev/null +++ b/86/443118ead95dbca7cff853dafb1be35f7b5cde @@ -0,0 +1,76 @@ +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 1D0CF431FAF + for ; Tue, 14 Jan 2014 04:06:59 -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 AexC04aEUCJa for ; + Tue, 14 Jan 2014 04:06:51 -0800 (PST) +Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155]) + (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) + (No client certificate requested) + by olra.theworths.org (Postfix) with ESMTPS id 5251A431FAE + for ; Tue, 14 Jan 2014 04:06:51 -0800 (PST) +Received: from remotemail by yantan.tethera.net with local (Exim 4.80) + (envelope-from ) + id 1W32lY-0006Vk-L5; Tue, 14 Jan 2014 08:06:44 -0400 +Received: (nullmailer pid 21160 invoked by uid 1000); Tue, 14 Jan 2014 + 12:06:40 -0000 +From: David Bremner +To: Tomi Ollila , notmuch@notmuchmail.org +Subject: Re: [PATCH 2/3] man: partial conversion to pod. +In-Reply-To: +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> + +User-Agent: Notmuch/0.17 (http://notmuchmail.org) Emacs/24.3.1 + (x86_64-pc-linux-gnu) +Date: Tue, 14 Jan 2014 08:06:40 -0400 +Message-ID: <87d2jukbsf.fsf@zancas.localnet> +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:06:59 -0000 + +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? 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