debian/notmuch
1
0
Fork 0
mirror of https://git.notmuchmail.org/git/notmuch synced 2024-11-22 02:48:08 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

man: update man pages for folder: and path: search terms

Browse source 
Text from review by Austin Clements <amdragon@MIT.EDU>.
This commit is contained in:
Jani Nikula 2014-03-09 23:03:06 +02:00 committed by David Bremner
parent 8413582b6e
commit 0969c8be09
1 changed files with 25 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
doc/man7/notmuch-search-terms.rst
View file

@ -46,7 +46,9 @@ indicate user-supplied values):
- thread:<thread-id> - thread:<thread-id>
- folder:<directory-path> - folder:<maildir-folder>
- path:<directory-path> or path:<directory-path>/**
- date:<since>..<until> - date:<since>..<until>
@ -77,12 +79,28 @@ generated internally by notmuch (and do not appear in email messages).
These thread ID values can be seen in the first column of output from These thread ID values can be seen in the first column of output from
**notmuch search** **notmuch search**
The **folder:** prefix can be used to search for email message files The **path:** prefix searches for email messages that are in
that are contained within particular directories within the mail store. particular directories within the mail store. The directory must be
If the same email message has multiple message files associated with it, specified relative to the top-level maildir (and without the leading
it's sufficient for a match that at least one of the files is contained slash). By default, **path:** matches messages in the specified
within a matching directory. Only the directory components below the directory only. The "/\*\*" suffix can be used to match messages in
top-level mail database path are available to be searched. the specified directory and all its subdirectories recursively.
**path:""** matches messages in the root of the mail store and,
likewise, **path:\*\*** matches all messages.
The **folder:** prefix searches for email messages by maildir or MH
folder. For MH-style folders, this is equivalent to **path:**. For
maildir, this includes messages in the "new" and "cur"
subdirectories. The exact syntax for maildir folders depends on your
mail configuration. For maildir++, **folder:""** matches the inbox
folder (which is the root in maildir++), other folder names always
start with ".", and nested folders are separated by "."s, such as
**folder:.classes.topology**. For "file system" maildir, the inbox is
typically **folder:INBOX** and nested folders are separated by
slashes, such as **folder:classes/topology**.
Both **path:** and **folder:** will find a message if *any* copy of
that message is in the specific directory/folder.
The **date:** prefix can be used to restrict the results to only The **date:** prefix can be used to restrict the results to only
messages within a particular time range (based on the Date: header) with messages within a particular time range (based on the Date: header) with