summary refs log tree commit diff
path: root/man/mthread.1
blob: 6ff349543cd443480639dfd51f3fc4c7b62a7ec7 (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
.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 passed,
.Nm
will read file names from standard input,
or use the default sequence if used interactively.
.Pp
.Nm
prints the threaded messages line by 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 in case they
are referenced.
Threads where all messages are optional are suppressed.
You can use
.Fl S
to add outbox folders and complete 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/