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