Improving notmuch query documentation [was: Re: Partial words on notmuch search?]
authorAndrei Popescu <andreimpopescu@gmail.com>
Tue, 17 Jan 2012 22:14:35 +0000 (00:14 +0200)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:42:30 +0000 (09:42 -0800)
02/eb7cf10f31a7253a0ce9459b305549c84bd521 [new file with mode: 0644]

diff --git a/02/eb7cf10f31a7253a0ce9459b305549c84bd521 b/02/eb7cf10f31a7253a0ce9459b305549c84bd521
new file mode 100644 (file)
index 0000000..ae8f1f1
--- /dev/null
@@ -0,0 +1,126 @@
+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 5F36741ED71\r
+       for <notmuch@notmuchmail.org>; Tue, 17 Jan 2012 14:14:42 -0800 (PST)\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 TdfYOBYIHIsX for <notmuch@notmuchmail.org>;\r
+       Tue, 17 Jan 2012 14:14:40 -0800 (PST)\r
+Received: from mail-ee0-f53.google.com (mail-ee0-f53.google.com\r
+ [74.125.83.53])       (using TLSv1 with cipher RC4-SHA (128/128 bits))        (No client\r
+ certificate requested)        by olra.theworths.org (Postfix) with ESMTPS id\r
+ 0904F421192   for <notmuch@notmuchmail.org>; Tue, 17 Jan 2012 14:14:39 -0800\r
+ (PST)\r
+Received: by eeke51 with SMTP id e51so296837eek.26\r
+       for <notmuch@notmuchmail.org>; Tue, 17 Jan 2012 14:14:38 -0800 (PST)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;\r
+       h=date:from:to:cc:subject:message-id:references:mime-version\r
+       :content-type:content-disposition:in-reply-to:user-agent;\r
+       bh=sZhD9EIpl8v6fMKSt/iGMw2SPpwaYn4yG/IHZZnCFRc=;\r
+       b=WLvxvbG2fxCwT+Jzs/S6zaaN2/kbhXyU2bovq17GCJiEsN5rmNfA83wP0/XwtWk/kE\r
+       cznSH+08uq8KDvm3R8GsyB8pc84B64yr7Jdmt6rOxZmiH2cFmz+rnZy+68UzFS5oLS9n\r
+       pDTZUjulMbSrHY/J0f7VjilJ3ywBbM9GWI1HI=\r
+Received: by 10.213.17.207 with SMTP id t15mr3130636eba.96.1326838478593;\r
+       Tue, 17 Jan 2012 14:14:38 -0800 (PST)\r
+Received: from think.nuvreauspam ([92.86.142.199])\r
+       by mx.google.com with ESMTPS id a60sm91413253eeb.4.2012.01.17.14.14.36\r
+       (version=TLSv1/SSLv3 cipher=OTHER);\r
+       Tue, 17 Jan 2012 14:14:37 -0800 (PST)\r
+Received: by think.nuvreauspam (Postfix, from userid 1077)\r
+       id 728E75FDCC; Wed, 18 Jan 2012 00:14:35 +0200 (EET)\r
+Date: Wed, 18 Jan 2012 00:14:35 +0200\r
+From: Andrei Popescu <andreimpopescu@gmail.com>\r
+To: notmuch@notmuchmail.org\r
+Subject: Improving notmuch query documentation [was: Re: Partial words on\r
+       notmuch search?]\r
+Message-ID: <20120117221435.GN3272@think.nuvreauspam>\r
+References: <20120115220600.GO7037@think.nuvreauspam>\r
+       <877h0sa207.fsf@fester.com>\r
+       <20120116202103.GA14329@think.nuvreauspam>\r
+       <20120117023431.GF16740@mit.edu>\r
+MIME-Version: 1.0\r
+Content-Type: multipart/signed; micalg=pgp-sha256;\r
+       protocol="application/pgp-signature"; boundary="bCsyhTFzCvuiizWE"\r
+Content-Disposition: inline\r
+In-Reply-To: <20120117023431.GF16740@mit.edu>\r
+User-Agent: Mutt/1.5.21 (2010-09-15)\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: Tue, 17 Jan 2012 22:14:42 -0000\r
+\r
+\r
+--bCsyhTFzCvuiizWE\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+Content-Transfer-Encoding: quoted-printable\r
+\r
+On Lu, 16 ian 12, 21:34:31, Austin Clements wrote:\r
+> Quoth Andrei Popescu on Jan 16 at 10:21 pm:\r
+> > This is also interesting:\r
+> > $ notmuch count 'debian'\r
+> > 65888\r
+> > $ notmuch count 'dEbian'\r
+> > 65888\r
+> > $ notmuch count 'Debian'\r
+> > 65887\r
+>=20\r
+> The first two will match stemmed versions of "debian" such as\r
+> "debian's" and "debianed".  However, starting a term with a capital\r
+> letter suppresses stemming (because it suggests that it's a name,\r
+> which you wouldn't want to modify), so your last query matches only\r
+> the term "debian".  This is probably documented somewhere, though I\r
+> don't know where.\r
+\r
+Stemming is mentioned in the Xapian docs, but I didn't understand the=20\r
+meaning until I read your explanation, thanks :)\r
+\r
+> > Where can I read more about this? (except the source :)\r
+>=20\r
+> Most of this is in the Xapian query syntax document you found.  Really\r
+> we ought to beef-up Notmuch's query syntax documentation.\r
+\r
+If I get around to write something myself where do you suggest I should=20\r
+start, the wiki or the manpage?\r
+\r
+Thanks,\r
+Andrei\r
+--=20\r
+If you can't explain it simply, you don't understand it well enough.\r
+(Albert Einstein)\r
+\r
+--bCsyhTFzCvuiizWE\r
+Content-Type: application/pgp-signature; name="signature.asc"\r
+Content-Description: Digital signature\r
+\r
+-----BEGIN PGP SIGNATURE-----\r
+Version: GnuPG v1.4.10 (GNU/Linux)\r
+\r
+iQEcBAEBCAAGBQJPFfLLAAoJEHNWs3jeoi3p9QUH/A42AWuVbo9Cs0DpKEAbrvgy\r
+tzsBlnbUSGGU/Vd7F9MB3HVstoRjLUJMSxNpmvntpiSEJBuujtZeZUxVa5+ucTRj\r
+noGcVt/SehKjUvAtPue2UKFoMaayPhyVrcKxWdnxb/ac2IsiTHKDBjuiomfqFtLi\r
+mw30jSOtkfm1D5oQpGli9Yphlf57k9BjsdYag0lrC6MkAtJKwTHhiwy+Vc9IQjRn\r
+OGdYWZmLDBz6uky7w20b/qxVaQ7cH45CXoIF84x6ZGMsB+6PFHrFNV515nsHDQ+Y\r
+qW8FbNLBiCsmIr0lS3TbhhW7HGBwo/koy7HafaCfS9tiR44gedYYK+wcegNpkvI=\r
+=xUo5\r
+-----END PGP SIGNATURE-----\r
+\r
+--bCsyhTFzCvuiizWE--\r