summaryrefslogtreecommitdiff
path: root/doc/aerc-search.1.scd
blob: 75dc96adc333cacc74c3984b0810aa5820c021c7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
aerc-search(1)

# NAME

aerc-search - search and filter patterns and options for *aerc*(1)

# IMAP

*search* [-ruba] [-x <flag>] [-X <flag>] [-f <from>] [-t <to>] [-c <cc>] [terms...]
	Searches the current folder for messages matching the given set of
	conditions.

	Each space separated term of *terms*, if provided, is searched
	case-insensitively among subject lines unless *-b* or *-a* are
	provided.

	*-r*: Search for read messages

	*-u*: Search for unread messages

	*-x <flag>*, *-X <flag>*: Restrict search to messages with or without <flag>

	Use *-x* to search for messages with the flag set.
	Use *-X* to search for messages without the flag set.

	Possible values are:

	Seen
		Read messages

	Answered
		Replied messages

	Flagged
		Flagged messages

	*-b*: Search in the body of the messages

	*-a*: Search in the entire text of the messages

	*-f <from>*: Search for messages from <from>

	*-t <to>*: Search for messages to <to>

	*-c <cc>*: Search for messages cc'ed to <cc>

# MAILDIR

*search* [-ruba] [-x <flag>] [-X <flag>] [-f <from>] [-t <to>] [-c <cc>] [terms...]
	Searches the current folder for messages matching the given set of
	conditions.

	Each space separated term of *terms*, if provided, is searched
	case-insensitively among subject lines unless *-b* or *-a* are
	provided.

	*-r*: Search for read messages

	*-u*: Search for unread messages

	*-x <flag>*, *-X <flag>*: Restrict search to messages with or without <flag>

	Use *-x* to search for messages with the flag set.
	Use *-X* to search for messages without the flag set.

	Possible values are:

	Seen
		Read messages

	Answered
		Replied messages

	Flagged
		Flagged messages

	*-b*: Search in the body of the messages

	*-a*: Search in the entire text of the messages

	*-f <from>*: Search for messages from <from>

	*-t <to>*: Search for messages to <to>

	*-c <cc>*: Search for messages cc'ed to <cc>

# NOTMUCH

*search* <query...>
	You can use the full notmuch query language as described in
	*notmuch-search-terms*(7).

	The query will only apply on top of the active folder query.

	Example: jump to next unread `:search tag:unread`

# SEE ALSO

*aerc*(1) *aerc-config*(5)

# AUTHORS

Originally created by Drew DeVault <sir@cmpwn.com> and maintained by Robin
Jarry <robin@jarry.cc> who is assisted by other open source contributors. For
more information about aerc development, see https://sr.ht/~rjarry/aerc/.