1 Return-Path: <jani@nikula.org>
\r
2 X-Original-To: notmuch@notmuchmail.org
\r
3 Delivered-To: notmuch@notmuchmail.org
\r
4 Received: from localhost (localhost [127.0.0.1])
\r
5 by olra.theworths.org (Postfix) with ESMTP id 2CF48431FBF
\r
6 for <notmuch@notmuchmail.org>; Sun, 9 Mar 2014 23:25:53 -0700 (PDT)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\r
11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5
\r
12 tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled
\r
13 Received: from olra.theworths.org ([127.0.0.1])
\r
14 by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
\r
15 with ESMTP id oV3xokSFmfHC for <notmuch@notmuchmail.org>;
\r
16 Sun, 9 Mar 2014 23:25:47 -0700 (PDT)
\r
17 Received: from mail-ee0-f48.google.com (mail-ee0-f48.google.com
\r
18 [74.125.83.48]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client
\r
19 certificate requested) by olra.theworths.org (Postfix) with ESMTPS id
\r
20 7CAEC431FBD for <notmuch@notmuchmail.org>; Sun, 9 Mar 2014 23:25:47 -0700
\r
22 Received: by mail-ee0-f48.google.com with SMTP id e51so2880414eek.7
\r
23 for <notmuch@notmuchmail.org>; Sun, 09 Mar 2014 23:25:46 -0700 (PDT)
\r
24 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
\r
25 d=1e100.net; s=20130820;
\r
26 h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to
\r
28 bh=HygLmH+8KJLELkTShvSszvxOEyRKq+mIMLehAMe0at8=;
\r
29 b=gzvk5XJlvGB4DFzOZ8iZpoBEwyf/KsFYA/9+W0i6Cs4WR/oLKMWXsJnUUYuvP2sRF/
\r
30 Rb92MT5vaOHpnLSo6wE30MGSwgztEP7JziyerJ+1Y8/SJntZ2FHFZZjs0SCb3Zdxmkd/
\r
31 AVaDqLZCeFtLVMFD0zMLRUzSHPyWSgyAue+eackeNf0Z/Y98Iu9uC276TEgfFDyp5Fkv
\r
32 9vbOhvt+nj7oRWEWHC8TlGqZbKViK64/kNSWbW9bzBqNM5iIH7ygQhypdxSfo5aWM8dI
\r
33 0rLrgN7eCuPAhjhJnlVLQw2pzQHmbiEAsPT+pnj5ygSQGsQs+S81JNY8VHwTXKHPKcG/
\r
36 ALoCoQnSG3DraDLnmGDCE0mmNRMnmVyjfcELblPBEJMdOR0jC1UFvzIxVC0Vnk98wzVH9S7FKJhU
\r
37 X-Received: by 10.14.251.5 with SMTP id a5mr115131ees.108.1394432746271;
\r
38 Sun, 09 Mar 2014 23:25:46 -0700 (PDT)
\r
39 Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi.
\r
41 by mx.google.com with ESMTPSA id m8sm41198444eef.14.2014.03.09.23.25.44
\r
42 for <multiple recipients>
\r
43 (version=TLSv1.2 cipher=RC4-SHA bits=128/128);
\r
44 Sun, 09 Mar 2014 23:25:45 -0700 (PDT)
\r
45 From: Jani Nikula <jani@nikula.org>
\r
46 To: notmuch@notmuchmail.org
\r
47 Subject: [PATCH v5] man: update man pages for folder: and path: search terms
\r
48 Date: Mon, 10 Mar 2014 08:25:44 +0200
\r
49 Message-Id: <1394432744-3404-1-git-send-email-jani@nikula.org>
\r
50 X-Mailer: git-send-email 1.9.0
\r
52 <ab386522dfd5acc6db6fe6ff23238ed8c56d02dd.1394400503.git.jani@nikula.org>
\r
54 <ab386522dfd5acc6db6fe6ff23238ed8c56d02dd.1394400503.git.jani@nikula.org>
\r
55 X-BeenThere: notmuch@notmuchmail.org
\r
56 X-Mailman-Version: 2.1.13
\r
58 List-Id: "Use and development of the notmuch mail system."
\r
59 <notmuch.notmuchmail.org>
\r
60 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
\r
61 <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
\r
62 List-Archive: <http://notmuchmail.org/pipermail/notmuch>
\r
63 List-Post: <mailto:notmuch@notmuchmail.org>
\r
64 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
\r
65 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
\r
66 <mailto:notmuch-request@notmuchmail.org?subject=subscribe>
\r
67 X-List-Received-Date: Mon, 10 Mar 2014 06:25:53 -0000
\r
69 Text from review by Austin Clements <amdragon@MIT.EDU>.
\r
71 doc/man7/notmuch-search-terms.rst | 32 +++++++++++++++++++++++++-------
\r
72 1 file changed, 25 insertions(+), 7 deletions(-)
\r
74 diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst
\r
75 index 20bc6f1e1488..1acdaa0b38de 100644
\r
76 --- a/doc/man7/notmuch-search-terms.rst
\r
77 +++ b/doc/man7/notmuch-search-terms.rst
\r
78 @@ -46,7 +46,9 @@ indicate user-supplied values):
\r
80 - thread:<thread-id>
\r
82 -- folder:<directory-path>
\r
83 +- folder:<maildir-folder>
\r
85 +- path:<directory-path> or path:<directory-path>/**
\r
87 - date:<since>..<until>
\r
89 @@ -77,12 +79,28 @@ generated internally by notmuch (and do not appear in email messages).
\r
90 These thread ID values can be seen in the first column of output from
\r
93 -The **folder:** prefix can be used to search for email message files
\r
94 -that are contained within particular directories within the mail store.
\r
95 -If the same email message has multiple message files associated with it,
\r
96 -it's sufficient for a match that at least one of the files is contained
\r
97 -within a matching directory. Only the directory components below the
\r
98 -top-level mail database path are available to be searched.
\r
99 +The **path:** prefix searches for email messages that are in
\r
100 +particular directories within the mail store. The directory must be
\r
101 +specified relative to the top-level maildir (and without the leading
\r
102 +slash). By default, **path:** matches messages in the specified
\r
103 +directory only. The "/\*\*" suffix can be used to match messages in
\r
104 +the specified directory and all its subdirectories recursively.
\r
105 +**path:""** matches messages in the root of the mail store and,
\r
106 +likewise, **path:\*\*** matches all messages.
\r
108 +The **folder:** prefix searches for email messages by maildir or MH
\r
109 +folder. For MH-style folders, this is equivalent to **path:**. For
\r
110 +maildir, this includes messages in the "new" and "cur"
\r
111 +subdirectories. The exact syntax for maildir folders depends on your
\r
112 +mail configuration. For maildir++, **folder:""** matches the inbox
\r
113 +folder (which is the root in maildir++), other folder names always
\r
114 +start with ".", and nested folders are separated by "."s, such as
\r
115 +**folder:.classes.topology**. For "file system" maildir, the inbox is
\r
116 +typically **folder:INBOX** and nested folders are separated by
\r
117 +slashes, such as **folder:classes/topology**.
\r
119 +Both **path:** and **folder:** will find a message if *any* copy of
\r
120 +that message is in the specific directory/folder.
\r
122 The **date:** prefix can be used to restrict the results to only
\r
123 messages within a particular time range (based on the Date: header) with
\r