3b/3696216e9563998e215865da00afa2d5d16daf

   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 71F1840DAE6\r
   6         for <notmuch@notmuchmail.org>; Mon,  8 Nov 2010 09:51:45 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -1.9\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5\r
  12         tests=[BAYES_00=-1.9] autolearn=ham\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 LNRWjT13gB3B for <notmuch@notmuchmail.org>;\r
  16         Mon,  8 Nov 2010 09:51:33 -0800 (PST)\r
  17 Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU\r
  18         [18.9.25.12])\r
  19         by olra.theworths.org (Postfix) with ESMTP id C937A40DAC2\r
  20         for <notmuch@notmuchmail.org>; Mon,  8 Nov 2010 09:51:33 -0800 (PST)\r
  21 X-AuditID: 1209190c-b7ba9ae0000009f8-48-4cd838a57c16\r
  22 Received: from mailhub-auth-4.mit.edu ( [18.7.62.39])\r
  23         by dmz-mailsec-scanner-1.mit.edu (Symantec Brightmail Gateway) with\r
  24         SMTP id 40.24.02552.5A838DC4; Mon,  8 Nov 2010 12:51:33 -0500 (EST)\r
  25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
  26         by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id oA8HpW8H027545; \r
  27         Mon, 8 Nov 2010 12:51:33 -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 oA8HpOX4005702\r
  32         (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT);\r
  33         Mon, 8 Nov 2010 12:51:31 -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
  37         string\r
  38 In-Reply-To: <871v6vogzw.fsf@yoom.home.cworth.org>\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>\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:51:24 -0500\r
  45 Message-ID: <87pqufbt5v.fsf@mit.edu>\r
  46 MIME-Version: 1.0\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
  51 Precedence: list\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:51:45 -0000\r
  62 \r
  63 Hm. I was looking at the result of C-h f notmuch-search-mode RET, which\r
  64 is how I'm used to looking at emacs documentation inside emacs. Having\r
  65 just checked with an 'emacs -q', it looks like the notmuch "?" buffer\r
  66 does wrap the docstring, but C-h f does not.\r
  67 \r
  68 I feel like the right answer here is probably to make notmuch-help do\r
  69 the right thing with manually-wrapped text, since that's the standard\r
  70 thing for emacs documentation, and what emacs' built-in documentation\r
  71 expects. I can try to come up with a patch that does that if you agree.\r
  72 \r
  73 - Nelson\r
  74 \r
  75 On Mon, 08 Nov 2010 09:35:47 -0800, Carl Worth <cworth@cworth.org> wrote:\r
  76 > On Fri, 14 May 2010 16:42:07 -0400, Nelson Elhage <nelhage@MIT.EDU> wrote:\r
  77 > > This makes for easier reading in the *help* window.\r
  78 > \r
  79 > How are you getting unpleasant results here?\r
  80 > \r
  81 > I intentionally implemented manual, "incorrect" wrapping in the\r
  82 > source. The idea is that once the text is actually displayed (whether\r
  83 > view `notmuch-help' or `describe-mode') those long command names should\r
  84 > be substituted by shorter keybindings and the final result should be\r
  85 > wrapped nicely.\r
  86 > \r
  87 > For example, what I currently get after pressing "?" in a notmuch-search\r
  88 > buffer is as follows:\r
  89 > \r
  90 > ---\r
  91 > Pressing RET on any line displays that thread. The '+' and '-'\r
  92 > keys can be used to add or remove tags from a thread. The 'a' key\r
  93 > is a convenience for archiving a thread (removing the "inbox"\r
  94 > tag). The '*' key can be used to add or remove a tag from all\r
  95 > threads in the current buffer.\r
  96 > \r
  97 > Other useful commands are 'f' for filtering the current search\r
  98 > based on an additional query string, 't' for filtering to include\r
  99 > only messages with a given tag, and 's' to execute a new, global\r
 100 > search.\r
 101 > ---\r
 102 > \r
 103 > And I think your wrapping change would make that displayed result\r
 104 > incorrect.\r
 105 > \r
 106 > Is there something different about your environment that's making this\r
 107 > not work as desired?\r
 108 > \r
 109 > -Carl\r
 110 > \r
 111 > -- \r
 112 > carl.d.worth@intel.com\r
 113 Non-text part: application/pgp-signature\r