about summary refs log tree commit diff
path: root/contrib/msearch.1
blob: c2c7fd5fca82f3e05b443f8981329af899a2c2c0 (plain) (blame)
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
.Dd September 27, 2018
.Dt MSEARCH 1
.Os
.Sh NAME
.Nm msearch
.Nd search messages
.Sh SYNOPSIS
.Nm
.Op Fl n | Fl m | Fl x
.Op Fl -
.Op Ar query
.Sh DESCRIPTION
.Nm
searches for messages matching
.Ar query ,
using an external search engine, and prints file names separated by newlines.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl n
Search using
.Xr notmuch-search 1 .
.It Fl m
Search using
.Xr mu-find 1 .
.It Fl x
Search using
.Xr mairix 1 .
.It Fl -
Stop scanning for arguments.
.It Ar query
The search query, whose interpretation is up to the search engine.
This can also contain additional arguments for them
.El
.Pp
If no search engine is specified as an argument,
.Sq Li Search-Engine\&:
from
.Pa "${MBLAZE:-$HOME/.mblaze}/profile"
is used.
Valid values for this setting are
.Sq notmuch ,
.Sq mairix ,
and
.Sq mu .
If that is unset,
.Xr notmuch-search 1
is used.
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev MBLAZE
Directory containing mblaze configuration files.
(Default:
.Pa $HOME/.mblaze )
.El
.Sh EXIT STATUS
.Ex -std
Note that the called programs may have their own exit values.
.Sh SEE ALSO
.Xr mairix 1 ,
.Xr mu-find 1 ,
.Xr notmuch-search 1 ,
.Xr mblaze-profile 5
.Sh AUTHORS
.An Thomas Schneider Aq Mt qsx@chaotikum.eu
.Sh LICENSE
.Nm
is in the public domain.
.Pp
To the extent possible under law,
the creator of this work
has waived all copyright and related or
neighboring rights to this work.
.Pp
.Lk http://creativecommons.org/publicdomain/zero/1.0/