2020-05-04 12:45:07 +00:00
|
|
|
.Dd May 4, 2020
|
2016-07-22 19:36:46 +00:00
|
|
|
.Dt MTHREAD 1
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm mthread
|
2018-02-04 22:38:09 +00:00
|
|
|
.Nd arrange messages into discussions
|
2016-07-22 19:36:46 +00:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm
|
2020-05-04 12:58:58 +00:00
|
|
|
.Op Fl vpr
|
2017-06-30 11:28:05 +00:00
|
|
|
.Op Fl S Ar msg
|
2016-07-26 19:55:03 +00:00
|
|
|
.Op Ar msgs\ ...
|
2016-07-22 19:36:46 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm
|
2017-07-11 20:24:32 +00:00
|
|
|
groups messages together in parent/child relationships, based on
|
2016-07-22 19:36:46 +00:00
|
|
|
which messages are replies to which others.
|
2018-02-04 22:38:09 +00:00
|
|
|
.Po
|
2016-07-22 19:36:46 +00:00
|
|
|
See
|
2016-07-22 19:43:03 +00:00
|
|
|
.Xr mmsg 7
|
2016-07-22 19:36:46 +00:00
|
|
|
for the message argument syntax.
|
2018-02-04 22:38:09 +00:00
|
|
|
.Pc
|
2016-07-22 19:36:46 +00:00
|
|
|
.Pp
|
2017-07-11 20:24:32 +00:00
|
|
|
If no messages are specified,
|
2016-07-22 19:36:46 +00:00
|
|
|
.Nm
|
2017-07-11 20:24:32 +00:00
|
|
|
will read filenames from the standard input,
|
2016-07-22 19:36:46 +00:00
|
|
|
or use the default sequence if used interactively.
|
|
|
|
.Pp
|
|
|
|
.Nm
|
2018-02-04 22:38:09 +00:00
|
|
|
prints the threaded messages separated by newlines and
|
2017-07-11 20:24:32 +00:00
|
|
|
indented according to their depth in the message tree.
|
2016-07-22 19:36:46 +00:00
|
|
|
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.
|
2020-05-04 12:58:58 +00:00
|
|
|
.It Fl p
|
|
|
|
With
|
|
|
|
.Fl S ,
|
|
|
|
only add parents, not unrelated subthreads.
|
2020-05-04 12:45:07 +00:00
|
|
|
.It Fl r
|
|
|
|
Sort the top-level threads in reverse order (newest threads first).
|
2017-06-30 11:28:05 +00:00
|
|
|
.It Fl S Ar msg
|
|
|
|
Treat
|
|
|
|
.Ar msg
|
2017-07-11 20:24:32 +00:00
|
|
|
as optional message(s) that will be added to threads only if they
|
2017-06-30 11:28:05 +00:00
|
|
|
are referenced.
|
|
|
|
Threads where all messages are optional are suppressed.
|
|
|
|
You can use
|
|
|
|
.Fl S
|
2017-07-11 20:24:32 +00:00
|
|
|
to add an outbox folder, for example,
|
|
|
|
completing threads where your replies were missing.
|
2016-07-22 19:36:46 +00:00
|
|
|
.El
|
|
|
|
.Sh EXIT STATUS
|
|
|
|
.Ex -std
|
|
|
|
.Sh SEE ALSO
|
2016-07-22 19:43:03 +00:00
|
|
|
.Xr mmsg 7
|
2016-07-22 19:36:46 +00:00
|
|
|
.Pp
|
|
|
|
.Lk https://www.jwz.org/doc/threading.html "Message threading"
|
|
|
|
.Sh AUTHORS
|
2017-01-21 16:17:12 +00:00
|
|
|
.An Leah Neukirchen Aq Mt leah@vuxu.org
|
2016-07-22 19:36:46 +00:00
|
|
|
.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/
|