From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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--