Re: Improving notmuch query documentation [was: Re: Partial words on notmuch search?]

diff --git a/7c/423776184d77065a2e7213e8b293971612dcce b/7c/423776184d77065a2e7213e8b293971612dcce
new file mode 100644 (file)
index 0000000..1aadd78
--- /dev/null
+++ b/7c/423776184d77065a2e7213e8b293971612dcce
@@ -0,0 +1,94 @@
+Return-Path: <amdragon@mit.edu>\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 504AF42119E\r
+       for <notmuch@notmuchmail.org>; Tue, 17 Jan 2012 14:29:38 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[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 ymiLPJ31DRqN for <notmuch@notmuchmail.org>;\r
+       Tue, 17 Jan 2012 14:29:37 -0800 (PST)\r
+Received: from dmz-mailsec-scanner-8.mit.edu (DMZ-MAILSEC-SCANNER-8.MIT.EDU\r
+       [18.7.68.37])\r
+       by olra.theworths.org (Postfix) with ESMTP id BCF9E421192\r
+       for <notmuch@notmuchmail.org>; Tue, 17 Jan 2012 14:29:37 -0800 (PST)\r
+X-AuditID: 12074425-b7f4a6d0000008e0-d7-4f15f6511e0c\r
+Received: from mailhub-auth-1.mit.edu ( [18.9.21.35])\r
+       by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP\r
+       id AF.27.02272.156F51F4; Tue, 17 Jan 2012 17:29:37 -0500 (EST)\r
+Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
+       by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id q0HMTaiK013776; \r
+       Tue, 17 Jan 2012 17:29:37 -0500\r
+Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
+       (authenticated bits=0)\r
+       (User authenticated as amdragon@ATHENA.MIT.EDU)\r
+       by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q0HMTZVK027940\r
+       (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
+       Tue, 17 Jan 2012 17:29:36 -0500 (EST)\r
+Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77)\r
+       (envelope-from <amdragon@mit.edu>)\r
+       id 1RnHWt-0008C4-W6; Tue, 17 Jan 2012 17:29:24 -0500\r
+Date: Tue, 17 Jan 2012 17:29:23 -0500\r
+From: Austin Clements <amdragon@MIT.EDU>\r
+To: Andrei Popescu <andreimpopescu@gmail.com>\r
+Subject: Re: Improving notmuch query documentation [was: Re: Partial words on\r
+       notmuch search?]\r
+Message-ID: <20120117222923.GU16740@mit.edu>\r
+References: <20120115220600.GO7037@think.nuvreauspam>\r
+       <877h0sa207.fsf@fester.com>\r
+       <20120116202103.GA14329@think.nuvreauspam>\r
+       <20120117023431.GF16740@mit.edu>\r
+       <20120117221435.GN3272@think.nuvreauspam>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+In-Reply-To: <20120117221435.GN3272@think.nuvreauspam>\r
+User-Agent: Mutt/1.5.21 (2010-09-15)\r
+X-Brightmail-Tracker:\r
+ H4sIAAAAAAAAA+NgFmpileLIzCtJLcpLzFFi42IR4hRV1g38JupvcK9FwmLVBGmL6zdnMjsw\r
+       eeycdZfd49mqW8wBTFFcNimpOZllqUX6dglcGes2HmUsWMZSsXLiQ9YGxrXMXYycHBICJhLb\r
+       pj9nh7DFJC7cW8/WxcjFISSwj1Fi8/PDYEVCAhsYJZ7vSoVInGSSWHvjEhOEs4RR4tapp6wg\r
+       VSwCqhLX9s4Bs9kENCS27V/OCGKLCOhKrPvaAhZnFpCW+Pa7mQnEFhZIkDgzeTNYDa+AjsSm\r
+       W4eZILadZ5S4stoLIi4ocXLmExaIXi2JG/9eAtVwgM1Z/o8DJMwpYCYx4+0xsA9EBVQkppzc\r
+       xjaBUWgWku5ZSLpnIXQvYGRexSibklulm5uYmVOcmqxbnJyYl5dapGuhl5tZopeaUrqJERTU\r
+       7C6qOxgnHFI6xCjAwajEw1uwSdRfiDWxrLgy9xCjJAeTkihv9VegEF9SfkplRmJxRnxRaU5q\r
+       8SFGCQ5mJRHeS5eBcrwpiZVVqUX5MClpDhYlcV5NrXd+QgLpiSWp2ampBalFMFkZDg4lCd4d\r
+       IEMFi1LTUyvSMnNKENJMHJwgw3mAhq8FqeEtLkjMLc5Mh8ifYlSUEuftB0kIgCQySvPgemFJ\r
+       5xWjONArwrybQap4gAkLrvsV0GAmoME5rUIgg0sSEVJSDYzGTp/VpFtP3tTrKEvd8+fdhDSb\r
+       0wonWP494A2Qf+vMruJy7wFrrfGy212z5SS+/sroO3B5xp5Dwdo1KlwJHeevL5VqvqP0ZvWh\r
+       vLmv7WQPf5r67dY+xpuhD7fvf7jnxNZ2P56C2vZb5X/uP+CVTfa1//BX8IrmYcGWvmUvWZf7\r
+       LGpMUN765fNzJZbijERDLeai4kQAViYdtBUDAAA=\r
+Cc: notmuch@notmuchmail.org\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:29:38 -0000\r
+\r
+Quoth Andrei Popescu on Jan 18 at 12:14 am:\r
+> On Lu, 16 ian 12, 21:34:31, Austin Clements wrote:\r
+> > Quoth Andrei Popescu on Jan 16 at 10:21 pm:\r
+> > > Where can I read more about this? (except the source :)\r
+> > \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 \r
+> start, the wiki or the manpage?\r
+\r
+Probably expanding man/man7/notmuch-search-terms.7 would be the way to\r
+go.\r