a4/90260144ce4e29b5f40bde31278bbfab853b3b

   1 Return-Path: <andreimpopescu@gmail.com>\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 5451F431FAF\r
   6         for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 07:40:16 -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.799\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.799 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id Hohky6EWYbZO for <notmuch@notmuchmail.org>;\r
  17         Sat, 17 Mar 2012 07:40:14 -0700 (PDT)\r
  18 Received: from mail-we0-f181.google.com (mail-we0-f181.google.com\r
  19         [74.125.82.181]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  20         (No client certificate requested)\r
  21         by olra.theworths.org (Postfix) with ESMTPS id A23FE431FAE\r
  22         for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 07:40:14 -0700 (PDT)\r
  23 Received: by werm13 with SMTP id m13so5360088wer.26\r
  24         for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 07:40:11 -0700 (PDT)\r
  25 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;\r
  26         h=date:from:to:cc:subject:message-id:references:mime-version\r
  27         :content-type:content-disposition:in-reply-to:user-agent;\r
  28         bh=fohZB1uMO4t6IVzzU+5sFxidMca8TrMqnlJoSqJgaEY=;\r
  29         b=ZAK/q6Es49nn8nHfyxxtGuBmywFNFTJW+qUyaT8P1at/KvJR/eLS2diOjWrMQ7ocwo\r
  30         WQGWb/e7r4OVZDMsbWP7ScCt62gWhrfWQeTPIbZ7kI2E8XwwO171Uw4+dPbScZ5um7k/\r
  31         y3RE97sVQ7Jx2YlAJdIxa9A6VrbUdrTReCl0SGizkjbyj4Jx4wqEyXPzPi9OBtVmpA2H\r
  32         WyjMSVwpcGZEI3sSCpB/HeljqasPQmlUf2OiFBtdiz8qK18+3yotO5T+3BNPT0KngnVN\r
  33         4dNfv7E6cD0o3k/YroFrk1hVRk0ApA773WRdfBWtoxGuLhahoE1L8h224uC3yisbrHQ5\r
  34         HY5g==\r
  35 Received: by 10.180.83.72 with SMTP id o8mr6704336wiy.5.1331995211918;\r
  36         Sat, 17 Mar 2012 07:40:11 -0700 (PDT)\r
  37 Received: from sid.nuvreauspam ([92.86.142.199])\r
  38         by mx.google.com with ESMTPS id l5sm8193961wia.11.2012.03.17.07.40.09\r
  39         (version=TLSv1/SSLv3 cipher=OTHER);\r
  40         Sat, 17 Mar 2012 07:40:10 -0700 (PDT)\r
  41 Received: by sid.nuvreauspam (Postfix, from userid 1077)\r
  42         id B8F69C05C4; Sat, 17 Mar 2012 16:40:08 +0200 (EET)\r
  43 Date: Sat, 17 Mar 2012 16:40:08 +0200\r
  44 From: Andrei POPESCU <andreimpopescu@gmail.com>\r
  45 To: Austin Clements <amdragon@MIT.EDU>\r
  46 Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
  47         notmuch query documentation]\r
  48 Message-ID: <20120317144008.GB4510@sid.nuvreauspam>\r
  49 References: <87r4wso5d8.fsf@convex-new.cs.unb.ca>\r
  50         <20120316021124.GD2670@mit.edu>\r
  51         <20120316222952.GA4510@sid.nuvreauspam>\r
  52         <20120317002017.GG2670@mit.edu>\r
  53 MIME-Version: 1.0\r
  54 Content-Type: multipart/signed; micalg=pgp-sha256;\r
  55         protocol="application/pgp-signature"; boundary="GID0FwUMdk1T2AWN"\r
  56 Content-Disposition: inline\r
  57 In-Reply-To: <20120317002017.GG2670@mit.edu>\r
  58 User-Agent: Mutt/1.5.21 (2010-09-15)\r
  59 Cc: notmuch@notmuchmail.org\r
  60 X-BeenThere: notmuch@notmuchmail.org\r
  61 X-Mailman-Version: 2.1.13\r
  62 Precedence: list\r
  63 List-Id: "Use and development of the notmuch mail system."\r
  64         <notmuch.notmuchmail.org>\r
  65 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  66         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  67 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  68 List-Post: <mailto:notmuch@notmuchmail.org>\r
  69 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  70 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  71         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  72 X-List-Received-Date: Sat, 17 Mar 2012 14:40:16 -0000\r
  73 \r
  74 \r
  75 --GID0FwUMdk1T2AWN\r
  76 Content-Type: text/plain; charset=us-ascii\r
  77 Content-Disposition: inline\r
  78 Content-Transfer-Encoding: quoted-printable\r
  79 \r
  80 On Vi, 16 mar 12, 20:20:17, Austin Clements wrote:\r
  81 >=20\r
  82 > It is, quite literally, the manpage.  notmuch execs man when you run\r
  83 > notmuch help.\r
  84 \r
  85 Aha.\r
  86 =20\r
  87 > This was an intentional change a few releases ago.  Previously, we did\r
  88 > have separate manpages and internal help documentation and it didn't\r
  89 > work very well since they were perpetually out of sync.  Hence the\r
  90 > general concern about documentation fragmentation.\r
  91 \r
  92 Of course, I understand.\r
  93 \r
  94 > > This opinion is based also on what I see around at other terminal=20\r
  95 > > applications. The '--help' is seldom longer than a few lines and just=\r
  96 =20\r
  97 > > lists the available options and parameters (more like a refresher). The=\r
  98 =20\r
  99 > > manpage then explains them in more detail.\r
 100 >=20\r
 101 > That's true of simple commands, but most commands with subcommands\r
 102 > follow a style like notmuch.  In fact, notmuch's approach was modeled\r
 103 > directly off of git, and most modern VCSs do similar things.\r
 104 \r
 105 'git help' and 'man git' are quite different on my system, but I get the=20\r
 106 point.\r
 107 \r
 108 > > As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to=\r
 109 =20\r
 110 > > be expanded somewhat and 'help search-terms' shortened (a lot).\r
 111 >=20\r
 112 > What did you think of my suggestion that the first thing in man\r
 113 > search-terms be a short reference so that's what you see immediately\r
 114 > when you run notmuch help search-terms?  That seems to accomplish what\r
 115 > you want without fragmenting the documentation and seems like a good\r
 116 > way to write the documentation anyway.\r
 117 \r
 118 I still have a question: where does the first part of\r
 119 'notmuch help search-terms' come from? I can't find the corresponding=20\r
 120 section in the manpage? How about expanding that part just a bit and not=20\r
 121 show the text that comes from the manpage?\r
 122 \r
 123 Kind regards,\r
 124 Andrei\r
 125 --=20\r
 126 If you can't explain it simply, you don't understand it well enough.\r
 127 (Albert Einstein)\r
 128 \r
 129 --GID0FwUMdk1T2AWN\r
 130 Content-Type: application/pgp-signature; name="signature.asc"\r
 131 Content-Description: Digital signature\r
 132 \r
 133 -----BEGIN PGP SIGNATURE-----\r
 134 Version: GnuPG v1.4.12 (GNU/Linux)\r
 135 \r
 136 iQEcBAEBCAAGBQJPZKJIAAoJEHNWs3jeoi3p654H/0OQezTzMtxDJlu4tPdw+KP1\r
 137 SJXPsZqkMGZncPXhasrPpIMLRIUL4Jqn0F5CEbOusHKNFv9ZoMtMTrTXV1Gt1tIb\r
 138 Hj8Jer7K6/mXc0u/vOa3p0iHwLwMSoueICzMwK2w4ZebOVvI1RfNqsMLmLl2ONzt\r
 139 uSfPwxtiX1HoFAygIGp+cyZ0wflEbXGgwwoDQxDwTEk8HVPASLPS2QlYi5pJ8NZQ\r
 140 FmuGys0Vl/lP31K+XMTUtHDOY/02oLllbZRPo5AFauFj4feshqbTi1KB6YODJ9dj\r
 141 8VyohcKrD/E1REojydM6Js9hJrrMMLxss7yMjHNsI6qs1rOO+2sQFDkI3oMcrAw=\r
 142 =0hY6\r
 143 -----END PGP SIGNATURE-----\r
 144 \r
 145 --GID0FwUMdk1T2AWN--\r