--- /dev/null
+Return-Path: <andreimpopescu@gmail.com>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+ by olra.theworths.org (Postfix) with ESMTP id 5451F431FAF\r
+ for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 07:40:16 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.799\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.799 tagged_above=-999 required=5\r
+ tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
+ FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+ by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+ with ESMTP id Hohky6EWYbZO for <notmuch@notmuchmail.org>;\r
+ Sat, 17 Mar 2012 07:40:14 -0700 (PDT)\r
+Received: from mail-we0-f181.google.com (mail-we0-f181.google.com\r
+ [74.125.82.181]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+ (No client certificate requested)\r
+ by olra.theworths.org (Postfix) with ESMTPS id A23FE431FAE\r
+ for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 07:40:14 -0700 (PDT)\r
+Received: by werm13 with SMTP id m13so5360088wer.26\r
+ for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 07:40:11 -0700 (PDT)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;\r
+ h=date:from:to:cc:subject:message-id:references:mime-version\r
+ :content-type:content-disposition:in-reply-to:user-agent;\r
+ bh=fohZB1uMO4t6IVzzU+5sFxidMca8TrMqnlJoSqJgaEY=;\r
+ b=ZAK/q6Es49nn8nHfyxxtGuBmywFNFTJW+qUyaT8P1at/KvJR/eLS2diOjWrMQ7ocwo\r
+ WQGWb/e7r4OVZDMsbWP7ScCt62gWhrfWQeTPIbZ7kI2E8XwwO171Uw4+dPbScZ5um7k/\r
+ y3RE97sVQ7Jx2YlAJdIxa9A6VrbUdrTReCl0SGizkjbyj4Jx4wqEyXPzPi9OBtVmpA2H\r
+ WyjMSVwpcGZEI3sSCpB/HeljqasPQmlUf2OiFBtdiz8qK18+3yotO5T+3BNPT0KngnVN\r
+ 4dNfv7E6cD0o3k/YroFrk1hVRk0ApA773WRdfBWtoxGuLhahoE1L8h224uC3yisbrHQ5\r
+ HY5g==\r
+Received: by 10.180.83.72 with SMTP id o8mr6704336wiy.5.1331995211918;\r
+ Sat, 17 Mar 2012 07:40:11 -0700 (PDT)\r
+Received: from sid.nuvreauspam ([92.86.142.199])\r
+ by mx.google.com with ESMTPS id l5sm8193961wia.11.2012.03.17.07.40.09\r
+ (version=TLSv1/SSLv3 cipher=OTHER);\r
+ Sat, 17 Mar 2012 07:40:10 -0700 (PDT)\r
+Received: by sid.nuvreauspam (Postfix, from userid 1077)\r
+ id B8F69C05C4; Sat, 17 Mar 2012 16:40:08 +0200 (EET)\r
+Date: Sat, 17 Mar 2012 16:40:08 +0200\r
+From: Andrei POPESCU <andreimpopescu@gmail.com>\r
+To: Austin Clements <amdragon@MIT.EDU>\r
+Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
+ notmuch query documentation]\r
+Message-ID: <20120317144008.GB4510@sid.nuvreauspam>\r
+References: <87r4wso5d8.fsf@convex-new.cs.unb.ca>\r
+ <20120316021124.GD2670@mit.edu>\r
+ <20120316222952.GA4510@sid.nuvreauspam>\r
+ <20120317002017.GG2670@mit.edu>\r
+MIME-Version: 1.0\r
+Content-Type: multipart/signed; micalg=pgp-sha256;\r
+ protocol="application/pgp-signature"; boundary="GID0FwUMdk1T2AWN"\r
+Content-Disposition: inline\r
+In-Reply-To: <20120317002017.GG2670@mit.edu>\r
+User-Agent: Mutt/1.5.21 (2010-09-15)\r
+Cc: notmuch@notmuchmail.org\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+ <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sat, 17 Mar 2012 14:40:16 -0000\r
+\r
+\r
+--GID0FwUMdk1T2AWN\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+Content-Transfer-Encoding: quoted-printable\r
+\r
+On Vi, 16 mar 12, 20:20:17, Austin Clements wrote:\r
+>=20\r
+> It is, quite literally, the manpage. notmuch execs man when you run\r
+> notmuch help.\r
+\r
+Aha.\r
+=20\r
+> This was an intentional change a few releases ago. Previously, we did\r
+> have separate manpages and internal help documentation and it didn't\r
+> work very well since they were perpetually out of sync. Hence the\r
+> general concern about documentation fragmentation.\r
+\r
+Of course, I understand.\r
+\r
+> > This opinion is based also on what I see around at other terminal=20\r
+> > applications. The '--help' is seldom longer than a few lines and just=\r
+=20\r
+> > lists the available options and parameters (more like a refresher). The=\r
+=20\r
+> > manpage then explains them in more detail.\r
+>=20\r
+> That's true of simple commands, but most commands with subcommands\r
+> follow a style like notmuch. In fact, notmuch's approach was modeled\r
+> directly off of git, and most modern VCSs do similar things.\r
+\r
+'git help' and 'man git' are quite different on my system, but I get the=20\r
+point.\r
+\r
+> > As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to=\r
+=20\r
+> > be expanded somewhat and 'help search-terms' shortened (a lot).\r
+>=20\r
+> What did you think of my suggestion that the first thing in man\r
+> search-terms be a short reference so that's what you see immediately\r
+> when you run notmuch help search-terms? That seems to accomplish what\r
+> you want without fragmenting the documentation and seems like a good\r
+> way to write the documentation anyway.\r
+\r
+I still have a question: where does the first part of\r
+'notmuch help search-terms' come from? I can't find the corresponding=20\r
+section in the manpage? How about expanding that part just a bit and not=20\r
+show the text that comes from the manpage?\r
+\r
+Kind regards,\r
+Andrei\r
+--=20\r
+If you can't explain it simply, you don't understand it well enough.\r
+(Albert Einstein)\r
+\r
+--GID0FwUMdk1T2AWN\r
+Content-Type: application/pgp-signature; name="signature.asc"\r
+Content-Description: Digital signature\r
+\r
+-----BEGIN PGP SIGNATURE-----\r
+Version: GnuPG v1.4.12 (GNU/Linux)\r
+\r
+iQEcBAEBCAAGBQJPZKJIAAoJEHNWs3jeoi3p654H/0OQezTzMtxDJlu4tPdw+KP1\r
+SJXPsZqkMGZncPXhasrPpIMLRIUL4Jqn0F5CEbOusHKNFv9ZoMtMTrTXV1Gt1tIb\r
+Hj8Jer7K6/mXc0u/vOa3p0iHwLwMSoueICzMwK2w4ZebOVvI1RfNqsMLmLl2ONzt\r
+uSfPwxtiX1HoFAygIGp+cyZ0wflEbXGgwwoDQxDwTEk8HVPASLPS2QlYi5pJ8NZQ\r
+FmuGys0Vl/lP31K+XMTUtHDOY/02oLllbZRPo5AFauFj4feshqbTi1KB6YODJ9dj\r
+8VyohcKrD/E1REojydM6Js9hJrrMMLxss7yMjHNsI6qs1rOO+2sQFDkI3oMcrAw=\r
+=0hY6\r
+-----END PGP SIGNATURE-----\r
+\r
+--GID0FwUMdk1T2AWN--\r
projects / notmuch-archives.git / commitdiff