--- /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 8D9B7431FAF\r
+ for <notmuch@notmuchmail.org>; Fri, 16 Mar 2012 15:30:00 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.798\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.798 tagged_above=-999 required=5\r
+ tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
+ FAKE_REPLY_C=0.001, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7]\r
+ 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 ATkBsrpkyCsm for <notmuch@notmuchmail.org>;\r
+ Fri, 16 Mar 2012 15:29:58 -0700 (PDT)\r
+Received: from mail-wi0-f179.google.com (mail-wi0-f179.google.com\r
+ [209.85.212.179]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+ (No client certificate requested)\r
+ by olra.theworths.org (Postfix) with ESMTPS id 539CB431FAE\r
+ for <notmuch@notmuchmail.org>; Fri, 16 Mar 2012 15:29:58 -0700 (PDT)\r
+Received: by wibhn6 with SMTP id hn6so1212008wib.2\r
+ for <notmuch@notmuchmail.org>; Fri, 16 Mar 2012 15:29:55 -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:mime-version:content-type\r
+ :content-disposition:in-reply-to:user-agent;\r
+ bh=Q6/SBm0bUlgxQmez8TeE16jCQJUeN80HjUCfmY3YMGQ=;\r
+ b=c3R9G3P/6EyMVIGag9gMgR8MXA00cTLxxC5FgqZRi8uhO+95ti1cOC9UpTAyjDD3zT\r
+ SiYnusHaWqphsh2vwf32YK/RxKOlcI8pqxP9Wg6zrJIUl6VJ5RgiAiqRwkuqPUHxhHCp\r
+ UbZSqIcPZ6022GJFAOhXCKfYzCPyoWXWR3oG7+ilALF7+qRwpxHwcb3mQ8QFVHHreH0F\r
+ +6KsCa+CKpgWXwbPLqjT6nX376IEmSmefk6qW89Bu9eprTn7FH5GJpb0eeQvRRjXiSLM\r
+ pZIdJYEcdvpZME3o8ZBbNdJ4584fbfXLf+gS2jz3lARy4PlbLO4xgrqW20+jm34CK43V\r
+ /pZw==\r
+Received: by 10.180.93.4 with SMTP id cq4mr1948907wib.21.1331936995808;\r
+ Fri, 16 Mar 2012 15:29:55 -0700 (PDT)\r
+Received: from sid.nuvreauspam ([92.86.142.199])\r
+ by mx.google.com with ESMTPS id ff2sm3576533wib.9.2012.03.16.15.29.53\r
+ (version=TLSv1/SSLv3 cipher=OTHER);\r
+ Fri, 16 Mar 2012 15:29:54 -0700 (PDT)\r
+Received: by sid.nuvreauspam (Postfix, from userid 1077)\r
+ id 64014C02EE; Sat, 17 Mar 2012 00:29:52 +0200 (EET)\r
+Date: Sat, 17 Mar 2012 00:29:52 +0200\r
+From: Andrei POPESCU <andreimpopescu@gmail.com>\r
+To: Austin Clements <amdragon@MIT.EDU>, David Bremner <david@tethera.net>\r
+Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
+ notmuch query documentation]\r
+Message-ID: <20120316222952.GA4510@sid.nuvreauspam>\r
+MIME-Version: 1.0\r
+Content-Type: multipart/signed; micalg=pgp-sha256;\r
+ protocol="application/pgp-signature"; boundary="xHFwDpU9dbj6ez1V"\r
+Content-Disposition: inline\r
+In-Reply-To: <87r4wso5d8.fsf@convex-new.cs.unb.ca>\r
+ <20120316021124.GD2670@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: Fri, 16 Mar 2012 22:30:00 -0000\r
+\r
+\r
+--xHFwDpU9dbj6ez1V\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+Content-Transfer-Encoding: quoted-printable\r
+\r
+On Jo, 15 mar 12, 22:11:24, Austin Clements wrote:\r
+> Quoth Andrei POPESCU on Mar 16 at 2:30 am:\r
+> >=20\r
+> > $ notmuch help search-terms | wc -l\r
+> > 88\r
+> >=20\r
+> > IMHO that text is better suited for a manpage, the help should be just =\r
+a=20\r
+> > (very short) reference to refresh ones memory. What do you think?\r
+>=20\r
+> I'm not quite sure what you mean. That text is the man page. Though\r
+> it sounds like a great idea to have a quick syntax reference at the\r
+> top of the manpage so it's the first thing people see when they run\r
+> 'notmuch help search-terms' (and they can still scroll down to get the\r
+> details if they want).\r
+\r
+On Vi, 16 mar 12, 13:52:35, David Bremner wrote:\r
+> On Fri, 16 Mar 2012 02:30:53 +0200, Andrei POPESCU <andreimpopescu@gmail.=\r
+com> wrote:\r
+>=20\r
+> I'm less worried about the length of the documentation than about\r
+> fragmentation. So I think if something is reference material, it should\r
+> go in the man pages, or at least ship with notmuch.\r
+\r
+What I mean is that 'notmuch help search-terms' is too verbose. IMHO=20\r
+there should be very good reasons to have it longer than 20 lines or so.=20\r
+Instead it's the entire section 'SEARCH SYNTAX' from the manpage.\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=20\r
+lists the available options and parameters (more like a refresher). The=20\r
+manpage then explains them in more detail.\r
+\r
+As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to=20\r
+be expanded somewhat and 'help search-terms' shortened (a lot).\r
+\r
+Does this make sense?\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
+--xHFwDpU9dbj6ez1V\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
+iQEcBAEBCAAGBQJPY77gAAoJEHNWs3jeoi3pHeEIAJXTx2q7Hi04Amibtq2VaRqS\r
+J6fDpTUVab8YJ3Ou8HFVDxN4KreCo+tOC9AD0ravVo/6qSzXG1U4vAmRNLbWkVRL\r
+yrY3BTrGOBUrFwMSsj3X2yY7BrCzkWp0vL/JcnnN/5D2wo5gUv7OU/B5k7vDlh4S\r
+G+YcwNy1KoGZaCPaFn1eDjYER9P0yzbyCFQMxc4ZlZbtfJBaY/UQU8F9/HaDXkX4\r
++lwVOUVdkiX1JJedXevrI/NmlWer8QAeoptLavxTvWOaa/TrsuyRfppPPR3+Gexj\r
+eLmbSdM6fOy+lytumG7EakQ87m6+Q7vn6PerCcCmhPlxZ44ZQRdN43Jlz6V4EkQ=\r
+=0rRx\r
+-----END PGP SIGNATURE-----\r
+\r
+--xHFwDpU9dbj6ez1V--\r
projects / notmuch-archives.git / commitdiff