1 Return-Path: <david@tethera.net>
\r
2 X-Original-To: notmuch@notmuchmail.org
\r
3 Delivered-To: notmuch@notmuchmail.org
\r
4 Received: from localhost (localhost [127.0.0.1])
\r
5 by olra.theworths.org (Postfix) with ESMTP id 75919431FDB
\r
6 for <notmuch@notmuchmail.org>; Sun, 30 Jun 2013 20:08:04 -0700 (PDT)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\r
11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]
\r
13 Received: from olra.theworths.org ([127.0.0.1])
\r
14 by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
\r
15 with ESMTP id Uqnnn7u7XxD1 for <notmuch@notmuchmail.org>;
\r
16 Sun, 30 Jun 2013 20:07:58 -0700 (PDT)
\r
17 Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155])
\r
18 (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))
\r
19 (No client certificate requested)
\r
20 by olra.theworths.org (Postfix) with ESMTPS id 53646431FDA
\r
21 for <notmuch@notmuchmail.org>; Sun, 30 Jun 2013 20:07:58 -0700 (PDT)
\r
22 Received: from remotemail by yantan.tethera.net with local (Exim 4.80)
\r
23 (envelope-from <david@tethera.net>)
\r
24 id 1UtUT7-0005H2-II; Mon, 01 Jul 2013 00:07:57 -0300
\r
25 Received: (nullmailer pid 5842 invoked by uid 1000); Mon, 01 Jul 2013
\r
27 From: David Bremner <david@tethera.net>
\r
28 To: Mark Walters <markwalters1009@gmail.com>, notmuch@notmuchmail.org
\r
29 Subject: Re: [PATCH v2 2/3] contrib: pick: remove hack
\r
30 notmuch-pick-show-match-message-with-wait
\r
31 In-Reply-To: <87hagf5mi2.fsf@qmul.ac.uk>
\r
32 References: <1372582512-10777-1-git-send-email-markwalters1009@gmail.com>
\r
33 <1372582512-10777-3-git-send-email-markwalters1009@gmail.com>
\r
34 <87li5rtvbh.fsf@zancas.localnet> <87hagf5mi2.fsf@qmul.ac.uk>
\r
35 User-Agent: Notmuch/0.15.2+193~gb7df509 (http://notmuchmail.org) Emacs/24.3.1
\r
36 (x86_64-pc-linux-gnu)
\r
37 Date: Mon, 01 Jul 2013 00:07:53 -0300
\r
38 Message-ID: <877ghbt1ti.fsf@zancas.localnet>
\r
40 Content-Type: text/plain
\r
41 X-BeenThere: notmuch@notmuchmail.org
\r
42 X-Mailman-Version: 2.1.13
\r
44 List-Id: "Use and development of the notmuch mail system."
\r
45 <notmuch.notmuchmail.org>
\r
46 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
\r
47 <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
\r
48 List-Archive: <http://notmuchmail.org/pipermail/notmuch>
\r
49 List-Post: <mailto:notmuch@notmuchmail.org>
\r
50 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
\r
51 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
\r
52 <mailto:notmuch-request@notmuchmail.org?subject=subscribe>
\r
53 X-List-Received-Date: Mon, 01 Jul 2013 03:08:04 -0000
\r
55 Mark Walters <markwalters1009@gmail.com> writes:
\r
57 > I am not sure what the best way to document the variable is: there are
\r
58 > several variables that are essentially buffer local versions of the
\r
59 > arguments passed to notmuch-pick. Should these duplicate the
\r
60 > documentation? Exactly the same situation occurs with notmuch-show in
\r
61 > notmuch-show.el and notmuch-search in notmuch.el and in both those cases
\r
62 > the functions are well documented but the variables are not documented.
\r
64 what about just saying something like "this variable is a buffer local
\r
65 copy of argument FOO to function BAR" ?
\r