From: Andrei POPESCU Date: Fri, 16 Mar 2012 00:30:53 +0000 (+0200) Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documen... X-Git-Url: http://git.tremily.us/gitweb.cgi?a=commitdiff_plain;h=a02b56cdad411d4511522f36e3dcc2e3fa4a817d;p=notmuch-archives.git Re: [RFC] notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation] --- diff --git a/7e/0e75b82e5ef977b8161e64b48726a6bbed52f1 b/7e/0e75b82e5ef977b8161e64b48726a6bbed52f1 new file mode 100644 index 000000000..276f23739 --- /dev/null +++ b/7e/0e75b82e5ef977b8161e64b48726a6bbed52f1 @@ -0,0 +1,173 @@ +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 8D175431FAF + for ; Thu, 15 Mar 2012 17:30:59 -0700 (PDT) +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 OxBAttQ6oPqx for ; + Thu, 15 Mar 2012 17:30:59 -0700 (PDT) +Received: from mail-wi0-f179.google.com (mail-wi0-f179.google.com + [209.85.212.179]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) + (No client certificate requested) + by olra.theworths.org (Postfix) with ESMTPS id BB780431FAE + for ; Thu, 15 Mar 2012 17:30:58 -0700 (PDT) +Received: by wibhn6 with SMTP id hn6so52919wib.2 + for ; Thu, 15 Mar 2012 17:30:57 -0700 (PDT) +DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; + h=date:from:to:subject:message-id:references:mime-version + :content-type:content-disposition:in-reply-to:user-agent; + bh=QZHW3N3ccQ1/Y9OqRgSnExjJOMff4H9NWlVQSEAf5Gc=; + b=dWsEfxzoUdQ1l9zMu3XWy/32huuTETZL2p8HDFYoj81U8yJp79iSvPVeZ5mfvczACi + hvInUDGX7tAZyAmr0EgfziIzwfjF9n4cUdtn5GZRHNE6eshVDGDtHnhZLSahUSK79CxQ + alDnQ2M6/0WUTBf7YUWPBpOA82l89nfluqqo/lllGqDVhfTN+9t1zVDqwTxafeIpAVHN + P82TbvROEtLGBXdiDF8mvbqJoeeRU/CzYkixJgvJgfLCb3tCnWAxuEm/kH2VsoI/humN + e0HvFfLeaQp5I/bjJWbGpG9yyrhhM3DOSMQyjgVE4Olc0AoueluQU1+g4uYy3qAfNMwM + veXw== +Received: by 10.180.97.41 with SMTP id dx9mr30673828wib.9.1331857857435; + Thu, 15 Mar 2012 17:30:57 -0700 (PDT) +Received: from sid.nuvreauspam ([92.86.142.199]) + by mx.google.com with ESMTPS id df3sm9338753wib.1.2012.03.15.17.30.55 + (version=TLSv1/SSLv3 cipher=OTHER); + Thu, 15 Mar 2012 17:30:56 -0700 (PDT) +Received: by sid.nuvreauspam (Postfix, from userid 1077) + id 24C35C04F8; Fri, 16 Mar 2012 02:30:53 +0200 (EET) +Date: Fri, 16 Mar 2012 02:30:53 +0200 +From: Andrei POPESCU +To: notmuch@notmuchmail.org +Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving + notmuch query documentation] +Message-ID: <20120316003053.GR2981@sid.nuvreauspam> +References: <20120115220600.GO7037@think.nuvreauspam> + <877h0sa207.fsf@fester.com> + <20120116202103.GA14329@think.nuvreauspam> + <20120117023431.GF16740@mit.edu> + <20120117221435.GN3272@think.nuvreauspam> + <20120117222923.GU16740@mit.edu> + <20120315093941.GK2981@sid.nuvreauspam> + <20120315211107.GA2670@mit.edu> +MIME-Version: 1.0 +Content-Type: multipart/signed; micalg=pgp-sha256; + protocol="application/pgp-signature"; boundary="+1d8mk/W7pQzMfc7" +Content-Disposition: inline +In-Reply-To: <20120315211107.GA2670@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: Fri, 16 Mar 2012 00:30:59 -0000 + + +--+1d8mk/W7pQzMfc7 +Content-Type: text/plain; charset=us-ascii +Content-Disposition: inline +Content-Transfer-Encoding: quoted-printable + +On Jo, 15 mar 12, 17:11:08, Austin Clements wrote: +>=20 +> I think having two divergent documents covering the same thing is less +> than ideal, but perhaps they could be merged in the near future. + +I want to have this page more or less complete and descriptive. Once=20 +this is done I should be able to rewrite it more like a reference. + +Regarding 'notmuch help search-terms': + +$ notmuch help search-terms | wc -l +88 + +IMHO that text is better suited for a manpage, the help should be just a=20 +(very short) reference to refresh ones memory. What do you think? +=20 +> A few comments: +>=20 +> The section on "Languages other than English" isn't quite correct. +> Xapian has no idea what language is being used, so it will still stem +> terms in other languages, but using English stemming rules. + +Then I think it's safe to assume the results are very much dependent on=20 +the language, so if the language has some similarities to English Xapian=20 +might do some stemming. + +> Notmuch doesn't use synonyms. + +Thanks. + +> It might be worth pointing out that "+term1" and "term1" are +> equivalent. + +Yes. + +> "notmuch search -term2" doesn't actually work. I've never looked in +> to why, but I've found that Xapian ignores '-' at the beginning of a +> query or a parenthesized expression. + +Not sure what you mean here. Does Xapian just ignore the '-' and=20 +searches as if it wasn't specified? I'm usually testing stuff with=20 +'notmuch count', but I get: + +$ notmuch count -Debian +Unrecognized option: -Debian + +With 'search' I get results, but right now I can't think of a query to=20 +test. + +> "notmuch search term1 -term2" will work. + +Does 'notmuch search -term1 term2' work? + +> In the brackets section, you'll need shell escaping for those queries +> to work. It might be worth pointing out the need for shell escaping +> at the beginning. + +Right, anything other than brackets and '*'? + +> XOR, NEAR, and ADJ were intentionally undocumented in +> notmuch-search-terms because they may go away some day and we don't +> want people thinking they can depend on them. + +In such case I think it's better to state so. + +I'll integrate all your comments (if somebody else doesn't beat me to=20 +it). + +Kind regards, +Andrei +--=20 +If you can't explain it simply, you don't understand it well enough. +(Albert Einstein) + +--+1d8mk/W7pQzMfc7 +Content-Type: application/pgp-signature; name="signature.asc" +Content-Description: Digital signature + +-----BEGIN PGP SIGNATURE----- +Version: GnuPG v1.4.12 (GNU/Linux) + +iQEcBAEBCAAGBQJPYom9AAoJEHNWs3jeoi3pugUH/1Edcx+tg7wA0ZNWff/7m3vH +KhmFI5Z77Z+zDI2WfbYFCetnucFRz8kwWZ6WA1kCRhTgMnBJaDhzOSXDSUQvuvfh +3oUUAYqiC6vGg6p+MRwZxsN/Gd5UOv2uEVSFrzKaTOBqGRi4dXC/Nh9BcpzqUXkU +NpaYXgsDDUcbxVlvVngLm6OezKCuLtxqCoAAWFNAb7/xce/vB56lYqvXInVQbYu4 +3tT77A0aX59mUzNtem9LZIgcwyV+VcfWxgwrasqc0ZPRxD4l6JvR4Q2M65dSftcw +CoJYyq2hJf+qvHUShxXN/l4IBRhHxRdyCtulcZHCiMBz6254puCDCCRE+9CpRqA= +=0Otw +-----END PGP SIGNATURE----- + +--+1d8mk/W7pQzMfc7--