1 Return-Path: <nelhage@mit.edu>
\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 7C42A40DAE9
\r
6 for <notmuch@notmuchmail.org>; Mon, 8 Nov 2010 09:59:34 -0800 (PST)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\r
11 X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5
\r
12 tests=[BAYES_00=-1.9] autolearn=unavailable
\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 gwrZ4PZ-Y-FO for <notmuch@notmuchmail.org>;
\r
16 Mon, 8 Nov 2010 09:59:21 -0800 (PST)
\r
17 Received: from dmz-mailsec-scanner-4.mit.edu (DMZ-MAILSEC-SCANNER-4.MIT.EDU
\r
19 by olra.theworths.org (Postfix) with ESMTP id 1EA7840DAEA
\r
20 for <notmuch@notmuchmail.org>; Mon, 8 Nov 2010 09:59:21 -0800 (PST)
\r
21 X-AuditID: 1209190f-b7c1dae000000a2b-c0-4cd83a78bf9b
\r
22 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36])
\r
23 by dmz-mailsec-scanner-4.mit.edu (Symantec Brightmail Gateway) with
\r
24 SMTP id D2.C9.02603.87A38DC4; Mon, 8 Nov 2010 12:59:20 -0500 (EST)
\r
25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])
\r
26 by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id oA8HxKVu018650;
\r
27 Mon, 8 Nov 2010 12:59:20 -0500
\r
28 Received: from PHANATIQUE.MIT.EDU (c-71-192-162-193.hsd1.nh.comcast.net
\r
29 [71.192.162.193]) (authenticated bits=0)
\r
30 (User authenticated as nelhage@ATHENA.MIT.EDU)
\r
31 by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id oA8HxIgl008493
\r
32 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT);
\r
33 Mon, 8 Nov 2010 12:59:19 -0500 (EST)
\r
34 From: Nelson Elhage <nelhage@MIT.EDU>
\r
35 To: Carl Worth <cworth@cworth.org>, notmuch@notmuchmail.org
\r
36 Subject: Re: [PATCH 2/2] emacs: notmuch-search-mode: wrap the documentation
\r
38 In-Reply-To: <87pqufbt5v.fsf@mit.edu>
\r
39 References: <1273869727-32740-1-git-send-email-nelhage@mit.edu>
\r
40 <1273869727-32740-3-git-send-email-nelhage@mit.edu>
\r
41 <871v6vogzw.fsf@yoom.home.cworth.org> <87pqufbt5v.fsf@mit.edu>
\r
42 User-Agent: Notmuch/0.4-19-g38c7247 (http://notmuchmail.org) Emacs/23.1.1
\r
43 (x86_64-pc-linux-gnu)
\r
44 Date: Mon, 08 Nov 2010 12:59:18 -0500
\r
45 Message-ID: <87k4knbssp.fsf@mit.edu>
\r
47 Content-Type: text/plain; charset=us-ascii
\r
48 X-Brightmail-Tracker: AAAAARaQIa0=
\r
49 X-BeenThere: notmuch@notmuchmail.org
\r
50 X-Mailman-Version: 2.1.13
\r
52 List-Id: "Use and development of the notmuch mail system."
\r
53 <notmuch.notmuchmail.org>
\r
54 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
\r
55 <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
\r
56 List-Archive: <http://notmuchmail.org/pipermail/notmuch>
\r
57 List-Post: <mailto:notmuch@notmuchmail.org>
\r
58 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
\r
59 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
\r
60 <mailto:notmuch-request@notmuchmail.org?subject=subscribe>
\r
61 X-List-Received-Date: Mon, 08 Nov 2010 17:59:34 -0000
\r
63 Oh, I see the problem. I wasn't paying attention -- the problem is that
\r
64 C-h f substitutes "M-x <command-name>" for those keybindings, instead of
\r
65 a keystroke, which is why it looks weird. That's annoying, but I'm not
\r
66 sure what we can do, so I guess let's drop this patch in favor of it
\r
67 looking good in the builtin help.
\r
71 On Mon, 08 Nov 2010 12:51:24 -0500, Nelson Elhage <nelhage@MIT.EDU> wrote:
\r
72 > Hm. I was looking at the result of C-h f notmuch-search-mode RET, which
\r
73 > is how I'm used to looking at emacs documentation inside emacs. Having
\r
74 > just checked with an 'emacs -q', it looks like the notmuch "?" buffer
\r
75 > does wrap the docstring, but C-h f does not.
\r
77 > I feel like the right answer here is probably to make notmuch-help do
\r
78 > the right thing with manually-wrapped text, since that's the standard
\r
79 > thing for emacs documentation, and what emacs' built-in documentation
\r
80 > expects. I can try to come up with a patch that does that if you agree.
\r
84 > On Mon, 08 Nov 2010 09:35:47 -0800, Carl Worth <cworth@cworth.org> wrote:
\r
85 > > On Fri, 14 May 2010 16:42:07 -0400, Nelson Elhage <nelhage@MIT.EDU> wrote:
\r
86 > > > This makes for easier reading in the *help* window.
\r
88 > > How are you getting unpleasant results here?
\r
90 > > I intentionally implemented manual, "incorrect" wrapping in the
\r
91 > > source. The idea is that once the text is actually displayed (whether
\r
92 > > view `notmuch-help' or `describe-mode') those long command names should
\r
93 > > be substituted by shorter keybindings and the final result should be
\r
96 > > For example, what I currently get after pressing "?" in a notmuch-search
\r
97 > > buffer is as follows:
\r
100 > > Pressing RET on any line displays that thread. The '+' and '-'
\r
101 > > keys can be used to add or remove tags from a thread. The 'a' key
\r
102 > > is a convenience for archiving a thread (removing the "inbox"
\r
103 > > tag). The '*' key can be used to add or remove a tag from all
\r
104 > > threads in the current buffer.
\r
106 > > Other useful commands are 'f' for filtering the current search
\r
107 > > based on an additional query string, 't' for filtering to include
\r
108 > > only messages with a given tag, and 's' to execute a new, global
\r
112 > > And I think your wrapping change would make that displayed result
\r
115 > > Is there something different about your environment that's making this
\r
116 > > not work as desired?
\r
121 > > carl.d.worth@intel.com
\r
122 > Non-text part: application/pgp-signature
\r
123 > _______________________________________________
\r
124 > notmuch mailing list
\r
125 > notmuch@notmuchmail.org
\r
126 > http://notmuchmail.org/mailman/listinfo/notmuch
\r