about summary refs log tree commit diff
path: root/man/mthread.1
blob: 8947349557fec3012be6b00bd56b0900030f5cad (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
.Dd July 22, 2016
.Dt MTHREAD 1
.Os
.Sh NAME
.Nm mthread
.Nd thread mail messages
.Sh SYNOPSIS
.Nm
.Op Fl v
.Op Fl S Ar msg
.Op Ar msgs\ ...
.Sh DESCRIPTION
.Nm
groups messages together in parent/child relationships, based on
which messages are replies to which others.
See
.Xr mmsg 7
for the message argument syntax.
.Pp
If no messages are specified,
.Nm
will read filenames from the standard input,
or use the default sequence if used interactively.
.Pp
.Nm
prints the threaded messages one per line,
indented according to their depth in the message tree.
Unresolved Message-IDs are printed as-is.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl v
Do not prune unresolved Message-IDs at the top-level.
.It Fl S Ar msg
Treat
.Ar msg
as optional message(s) that will be added to threads only if they
are referenced.
Threads where all messages are optional are suppressed.
You can use
.Fl S
to add an outbox folder, for example,
completing threads where your replies were missing.
.El
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr mmsg 7
.Pp
.Lk https://www.jwz.org/doc/threading.html "Message threading"
.Sh AUTHORS
.An Leah Neukirchen Aq Mt leah@vuxu.org
.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/