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