mirror of
https://github.com/leahneukirchen/mblaze
synced 2024-11-11 13:10:32 +00:00
0023602f7b
- passed -> specified - 'the' standard input - when -> if - Clarify pager usage and refer to ENVIRONMENT for details - Add note about default format in mblaze-profile - Put in a '>' for %c - else -> otherwise - greater or equal 'to' - Add ':' to 'From' and 'To' Closes: #62 [via git-merge-pr]
208 lines
3.9 KiB
Groff
208 lines
3.9 KiB
Groff
.Dd June 28, 2017
|
|
.Dt MSCAN 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm mscan
|
|
.Nd print a one line per message mail listing
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl n
|
|
.Op Fl f Ar format
|
|
.Op Fl I
|
|
.Ar msgs\ ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
prints a one line summary for each message.
|
|
See
|
|
.Xr mmsg 7
|
|
for the message argument syntax.
|
|
.Pp
|
|
If no
|
|
.Ar msgs
|
|
are specified,
|
|
.Nm
|
|
reads filenames from the standard input,
|
|
or scans the mails in the current sequence if used interactively.
|
|
.Pp
|
|
By default,
|
|
.Nm
|
|
will spawn a pager on its output when used interactively.
|
|
See
|
|
.Sx ENVIRONMENT
|
|
for details on how to control this behaviour.
|
|
.Pp
|
|
The default
|
|
.Ar format
|
|
is
|
|
.Sq Li "%c%u%r %-3n %10d %17f %t %2i%s" ;
|
|
that is, for each message,
|
|
.Nm
|
|
prints relevant flags,
|
|
the sequence number (if applicable),
|
|
the date,
|
|
the originator,
|
|
and the subject of the message (possibly indented).
|
|
A default
|
|
.Nm
|
|
format may be specified in the user's
|
|
.Xr mblaze-profile 5 .
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width Ds
|
|
.It Fl n
|
|
Only print message numbers
|
|
(or filenames, if the message is not in the current sequence).
|
|
.It Fl I
|
|
Force ISO date output,
|
|
even for
|
|
.Sq Cm "%d" .
|
|
.It Fl f Ar format
|
|
Format according to the string
|
|
.Ar format ,
|
|
inspired by
|
|
.Xr printf 3 .
|
|
.Pp
|
|
The following formatting codes may be used
|
|
.Ar ( wd
|
|
overrides the default width):
|
|
.Bl -tag -width Ds
|
|
.It Cm \en
|
|
Newline.
|
|
.It Cm \et
|
|
Tab.
|
|
.It Cm \&%%
|
|
A plain
|
|
.Sq Li \&% .
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "b"
|
|
Human-readable size of the message (in kilobytes).
|
|
.It Cm "%c"
|
|
A
|
|
.Sq Li >
|
|
on the current message,
|
|
otherwise a blank.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "d"
|
|
Adaptive date of the message.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "D"
|
|
ISO date of the message (year, month, day).
|
|
When
|
|
.Ar wd
|
|
is greater or equal to 16,
|
|
the hour-minute timestamp will also be shown.
|
|
When
|
|
.Ar wd
|
|
is greater or equal to 19,
|
|
seconds will also be shown.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "f"
|
|
The
|
|
.Sq Li From:
|
|
(or
|
|
.Sq Li To: ,
|
|
if the message is from us).
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "F"
|
|
The Maildir folder the message resides in.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "i"
|
|
.Ar wd
|
|
(default: 1)
|
|
spaces per indentation depth in the thread tree.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "I"
|
|
The
|
|
.Sq Li "Message-ID:"
|
|
of the message.
|
|
.It Cm "%M"
|
|
The raw Maildir flags of the message.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "n"
|
|
The number of the message in the current sequence.
|
|
.It Cm "%r"
|
|
A
|
|
.Sq Li \&-
|
|
on a replied-to message, or a
|
|
.Sq Li \&:
|
|
on a forwarded message, or a blank.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "R"
|
|
The filename of the message.
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "s"
|
|
The subject of the message (defaults to remaining width).
|
|
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "S"
|
|
The subject of the message (defaults to remaining width),
|
|
with leading
|
|
.Sq Li "Re:" ,
|
|
.Sq Li "Fwd:"
|
|
etc. stripped.
|
|
.It Cm "%t"
|
|
A
|
|
.Sq Li \&>
|
|
if you are in
|
|
.Sq Li "To:" ,
|
|
a
|
|
.Sq Li \&+
|
|
if you are in
|
|
.Sq Li "Cc:" ,
|
|
a
|
|
.Sq Li \&:
|
|
if you are in
|
|
.Sq Li "Resent-To:" ,
|
|
or a blank.
|
|
.It Cm "%u"
|
|
An
|
|
.Sq Li \&*
|
|
on a flagged message, a
|
|
.Sq Li \&.
|
|
on an unseen message, an
|
|
.Sq Li x
|
|
on a trashed message, or a blank.
|
|
.El
|
|
.El
|
|
.Sh MESSAGE FLAGS
|
|
.Bl -tag -width 2n -compact
|
|
.It Li \&>
|
|
The current message
|
|
.It Li \&.
|
|
An unseen message
|
|
.It Li x
|
|
A trashed message
|
|
.It Li \&*
|
|
A flagged message
|
|
.It Li \&-
|
|
A replied-to message
|
|
.El
|
|
.Sh SUBJECT FLAGS
|
|
.Bl -tag -width 2n -compact
|
|
.It Li \&>
|
|
You are in
|
|
.Sq Li "To:" .
|
|
.It Li \&+
|
|
You are in
|
|
.Sq Li "Cc:" .
|
|
.It Li \&:
|
|
You are in
|
|
.Sq Li "Resent-To:" .
|
|
.El
|
|
.Sh ENVIRONMENT
|
|
.Bl -tag -width MBLAZE_PAGER
|
|
.It Ev MBLAZE_PAGER
|
|
Any non-empty value of the environment variable
|
|
.Ev MBLAZE_PAGER
|
|
is used instead of the standard pagination program, specified in
|
|
.Ev PAGER .
|
|
When empty, or set to
|
|
.Sq Ic cat ,
|
|
no pager is spawned.
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Ex -std
|
|
.Sh SEE ALSO
|
|
.Xr mblaze-profile 5 ,
|
|
.Xr mmsg 7
|
|
.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/
|