mblaze/man/mthread.1

71 lines
1.5 KiB
Groff
Raw Normal View History

.Dd May 4, 2020
2016-07-22 19:36:46 +00:00
.Dt MTHREAD 1
.Os
.Sh NAME
.Nm mthread
.Nd arrange messages into discussions
2016-07-22 19:36:46 +00:00
.Sh SYNOPSIS
.Nm
.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
groups messages together in parent/child relationships, based on
2016-07-22 19:36:46 +00:00
which messages are replies to which others.
.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.
.Pc
2016-07-22 19:36:46 +00:00
.Pp
If no messages are specified,
2016-07-22 19:36:46 +00:00
.Nm
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
prints the threaded messages separated by newlines and
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.
.It Fl p
With
.Fl S ,
only add parents, not unrelated subthreads.
.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
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
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/