6b/839334b3302cf028bfa8b77aaafb487bce3cf5

   1 Return-Path: <bremner@unb.ca>\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 72FE9431FAF\r
   6         for <notmuch@notmuchmail.org>; Fri, 16 Mar 2012 09:52:49 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: 0\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
  12         autolearn=disabled\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 mxXeGuh0n6LV for <notmuch@notmuchmail.org>;\r
  16         Fri, 16 Mar 2012 09:52:48 -0700 (PDT)\r
  17 Received: from tesseract.cs.unb.ca (tesseract.cs.unb.ca [131.202.240.238])\r
  18         (using TLSv1 with cipher AES256-SHA (256/256 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id CE7A5431FAE\r
  21         for <notmuch@notmuchmail.org>; Fri, 16 Mar 2012 09:52:48 -0700 (PDT)\r
  22 Received: from [131.202.13.154] (helo=convex-new.cs.unb.ca)\r
  23         by tesseract.cs.unb.ca with esmtpsa (TLS1.0:RSA_AES_256_CBC_SHA1:32)\r
  24         (Exim 4.72) (envelope-from <bremner@unb.ca>)\r
  25         id 1S8aOO-00051W-SR; Fri, 16 Mar 2012 13:52:45 -0300\r
  26 Received: from bremner by convex-new.cs.unb.ca with local (Exim 4.72)\r
  27         (envelope-from <bremner@unb.ca>)\r
  28         id 1S8aOJ-0007ch-Os; Fri, 16 Mar 2012 13:52:35 -0300\r
  29 From: David Bremner <david@tethera.net>\r
  30 To: Andrei POPESCU <andreimpopescu@gmail.com>, notmuch@notmuchmail.org\r
  31 Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
  32         notmuch query documentation]\r
  33 In-Reply-To: <20120316003053.GR2981@sid.nuvreauspam>\r
  34 References: <20120115220600.GO7037@think.nuvreauspam>\r
  35         <877h0sa207.fsf@fester.com>\r
  36         <20120116202103.GA14329@think.nuvreauspam>\r
  37         <20120117023431.GF16740@mit.edu>\r
  38         <20120117221435.GN3272@think.nuvreauspam>\r
  39         <20120117222923.GU16740@mit.edu>\r
  40         <20120315093941.GK2981@sid.nuvreauspam>\r
  41         <20120315211107.GA2670@mit.edu>\r
  42         <20120316003053.GR2981@sid.nuvreauspam>\r
  43 User-Agent: Notmuch/0.11.1+276~g1aa4abe (http://notmuchmail.org) Emacs/23.3.1\r
  44         (x86_64-pc-linux-gnu)\r
  45 Date: Fri, 16 Mar 2012 13:52:35 -0300\r
  46 Message-ID: <87r4wso5d8.fsf@convex-new.cs.unb.ca>\r
  47 MIME-Version: 1.0\r
  48 Content-Type: text/plain; charset=us-ascii\r
  49 X-Spam_bar: -\r
  50 X-BeenThere: notmuch@notmuchmail.org\r
  51 X-Mailman-Version: 2.1.13\r
  52 Precedence: list\r
  53 List-Id: "Use and development of the notmuch mail system."\r
  54         <notmuch.notmuchmail.org>\r
  55 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  56         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  57 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  58 List-Post: <mailto:notmuch@notmuchmail.org>\r
  59 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  60 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  61         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  62 X-List-Received-Date: Fri, 16 Mar 2012 16:52:49 -0000\r
  63 \r
  64 On Fri, 16 Mar 2012 02:30:53 +0200, Andrei POPESCU <andreimpopescu@gmail.com> wrote:\r
  65 \r
  66 > \r
  67 > Regarding 'notmuch help search-terms':\r
  68 > \r
  69 > $ notmuch help search-terms | wc -l\r
  70 > 88\r
  71 > \r
  72 > IMHO that text is better suited for a manpage, the help should be just a \r
  73 > (very short) reference to refresh ones memory. What do you think?\r
  74 >  \r
  75 \r
  76 I'm less worried about the length of the documentation than about\r
  77 fragmentation. So I think if something is reference material, it should\r
  78 go in the man pages, or at least ship with notmuch.\r
  79 \r
  80 d\r