Date: Fri, 16 Mar 2012 02:30:53 +0200
From: Andrei POPESCU <andreimpopescu@gmail.com>
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)
Precedence: list


--+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--