@ -19,24 +19,33 @@ for the message argument syntax.
.Pp
.Pp
If no
If no
.Ar msgs
.Ar msgs
are pass ed,
are specifi ed,
.Nm
.Nm
reads filenames from standard input,
reads filenames from the standard input,
or uses the mails in the current sequence when used interactively
or scans the mails in the current sequence if used interactively.
(using a pager).
.Pp
.Pp
By default,
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
.Ar format
is
is
.Sq Li "%c%u%r %-3n %10d %17f %t %2i%s" ,
.Sq Li "%c%u%r %-3n %10d %17f %t %2i%s" ;
that is, for each message,
that is, for each message,
.Nm
.Nm
prints
prints relevant flags,
flags,
the sequence number (if applicable),
the sequence number (if applicable),
the date,
the date,
the originator,
the originator,
and the subject of the message (possibly indented).
and the subject of the message (possibly indented).
A default
.Nm
format may be specified in the user's
.Xr mblaze-profile 5 .
.Pp
.Pp
The options are as follows:
The options are as follows:
.Bl -tag -width Ds
.Bl -tag -width Ds
@ -53,14 +62,14 @@ Format according to the string
inspired by
inspired by
.Xr printf 3 .
.Xr printf 3 .
.Pp
.Pp
The following formatting codes can be used
The following formatting codes may be used
.Ar ( wd
.Ar ( wd
overrides the default width):
overrides the default width):
.Bl -tag -width Ds
.Bl -tag -width Ds
.It Cm \e n
.It Cm \e n
Newline
Newline.
.It Cm \e t
.It Cm \e t
Tab
Tab.
.It Cm \& %%
.It Cm \& %%
A plain
A plain
.Sq Li \& % .
.Sq Li \& % .
@ -68,25 +77,26 @@ A plain
Human-readable size of the message (in kilobytes).
Human-readable size of the message (in kilobytes).
.It Cm "%c"
.It Cm "%c"
A
A
.Sq Li \&
.Sq Li >
on the current message, else a blank.
on the current message,
otherwise a blank.
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "d"
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "d"
Adaptive date of the message.
Adaptive date of the message.
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "D"
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "D"
ISO date of the message (year, month, day).
ISO date of the message (year, month, day).
When
When
.Ar wd
.Ar wd
is greater or equal 16,
is greater or equal to 16,
the hour-minute timestamp will be shown, too .
the hour-minute timestamp will also be shown.
When
When
.Ar wd
.Ar wd
is greater or equal 19,
is greater or equal to 19,
seconds will be shown, too .
seconds will also be shown.
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "f"
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "f"
The
The
.Sq Li From
.Sq Li From :
(or
(or
.Sq Li To ,
.Sq Li To : ,
if the message is from us).
if the message is from us).
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "F"
.It Cm "%" Ns Oo Ar wd Oc Ns Cm "F"
The Maildir folder the message resides in.
The Maildir folder the message resides in.
@ -131,13 +141,13 @@ a
.Sq Li \& :
.Sq Li \& :
if you are in
if you are in
.Sq Li "Resent-To:" ,
.Sq Li "Resent-To:" ,
or a blank else .
or a blank.
.It Cm "%u"
.It Cm "%u"
A
An
.Sq Li \& *
.Sq Li \& *
on a flagged message, or a
on a flagged message, a
.Sq Li \& .
.Sq Li \& .
on an unseen message, or a
on an unseen message, an
.Sq Li x
.Sq Li x
on a trashed message, or a blank.
on a trashed message, or a blank.
.El
.El
@ -174,7 +184,7 @@ Any non-empty value of the environment variable
.Ev MBLAZE_PAGER
.Ev MBLAZE_PAGER
is used instead of the standard pagination program, specified in
is used instead of the standard pagination program, specified in
.Ev PAGER .
.Ev PAGER .
When empty or set to
When empty, or set to
.Sq Ic cat ,
.Sq Ic cat ,
no pager is spawned.
no pager is spawned.
.El
.El