about summary refs log tree commit diff
path: root/man/mmsg.7
blob: 775e5033a345cb7f787aefa78c22b3e35c570e19 (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
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
.Dd July 22, 2016
.Dt MMSG 7
.Os
.Sh NAME
.Nm mmsg
.Nd mblaze message argument syntax
.Sh DESCRIPTION
This document outlines the message syntax used by many
of the utilities in the
.Xr mblaze 7
message system.
.Pp
In general, you can always specify a filename as a message,
if it contains a
.Sq Li \&/
character.
.Po
Use
.Sq Li \&./
to prefix messages in the current directory.
.Pc
You can also specify a maildir folder, which will be expanded
to all messages in the
.Pa cur/
directory.
.Pp
Ranges have the format
.Sq Ar start Ns Cm \&: Ns Ar stop ,
where
.Ar start
and
.Ar stop
are one-based indexes into the sequence.
Negative numbers count from the end.
If
.Ar start
is the empty string,
.Li 1
will be used instead.
If
.Ar stop
is the empty string,
.Li \&-1
will be used instead.
Thus,
.Sq Cm \&:
represents the whole sequence.
If the range does not contain a
.Sq Cm \&: ,
it is considered to be a single message, equivalent to the range
.Sq Ar start Ns Cm \&: Ns Ar start
of size one.
The special notation
.Sq Ar start Ns Cm \&:+ Ns Ar n ,
selects
.Ar start
and the next
.Ar n
messages.
.Pp
If the sequence is threaded, the following
syntax may be used:
.Sq Ar msg Ns Cm \&=
refers to the whole thread that contains
.Ar msg .
.Sq Ar msg Ns Cm \&^
refers to the parent of the message
.Ar msg
and may be repeated to refer to grandparents.
.Sq Ar msg Ns Cm \&_
refers to the subthread headed by
.Ar msg
.Po
i.e. all messages below
.Ar msg ,
with more indentation
.Pc .
.Pp
The following special shortcuts may be used:
.Bl -tag -width 3n
.It Sq Li \&.
refers to the current message.
Additionally, the syntax
.Sq Li \&.+ Ns Ar N
and
.Sq Li \&.- Ns Ar N
can be used to refer to messages relative to the current message.
.It Sq Li \&+
refers to the next message
.Po
like
.Sq Li \&.+1
.Pc
.It Sq Li \&-
refers to the previous message
.Po
like
.Sq Li \&.-1
.Pc
.It Sq Li \&$
refers to the last message
.Po
like
.Sq Li -1
.Pc
.It Sq Li \&^
refers to the current parent message
.Po
like
.Sq Li \&.^
.Pc
.It Sq Li \&=
refers to the current thread
.Po
like
.Sq Li \&.=
.Pc
.It Sq Li \&_
refers to the current subthread
.Po
like
.Sq Li \&._
.Pc
.El
.Sh SEE ALSO
.Xr mblaze 7
.Sh AUTHORS
.An Leah Neukirchen Aq Mt leah@vuxu.org