.\"
.\" %nmhwarning%
.\"
.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
show \- show (display) messages
.PP
next \- show the next message
.PP
prev \- show the previous message
.SH SYNOPSIS
.HP 5
.na
.B show
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-showproc
.IR program ]
.RB [ \-showmimeproc
.IR program ]
.RB [ \-header " | " \-noheader ]
.RB [ \-checkmime " | " \-nocheckmime ]
[switches\ for
.I showproc
or
.IR showmimeproc ]
.RB [ \-version ]
.RB [ \-help ]
.PP
.HP 5
.B next
is equivalent to
.B show n
.PP
.HP 5
.B prev
is equivalent to
.B show p
.ad

.SH DESCRIPTION
.B Show
lists each of the specified messages to the standard output
(typically, the terminal).
.B Next
and
.B prev
perform a
.B show
on the next or previous message in the specified
(or current) folder, respectively.
.PP
By default, text (non-MIME) messages are filtered and displayed by
the
.B nmh
command
.BR mhl .
This command will display text
messages in a nice, uniform format.  It also allows you to configure
the format of the displayed messages and which headers fields are
shown.  See the
.BR mhl (1)
manual page for the details about this
command.  Any switches not recognized by
.B show
are
passed along to that program.  To override the default, use the
.B \-showproc
.I program
switch.  For example,
.B \-showproc
.I more
will cause the
.B more
program to list the messages with no reformatting.
.PP
By default, MIME messages are processed and displayed by the
.B nmh
command
.BR mhshow .
See the
.BR mhshow (1)
manual page for details
about this command.
Any switches not recognized
by
.B show
are passed along to that program.  To override this
default, use the
.B \-showmimeproc
.I program
switch.
.PP
Note that,
.B show
will invoke the
.I showmimeproc
even for textual contents if the message has a MIME-Version header.
.PP
The option
.B \-checkmime
(set by default) instructs
.B show
to check if any of the messages contains a MIME-Version header.
If so, they are displayed by the
.IR showmimeproc ,
else they are displayed by the
.BR showproc .
The option
.B \-nocheckmime
disables this test and instructs
.B show
to use
.IR showproc ,
regardless of whether
any of the messages are MIME messages.
.PP
The
.B \-header
switch tells
.B show
to display a one\-line
description of the message being shown.  This description includes
the folder and the message number.
.PP
If no `msgs' are specified, the current message is used.
.PP
If the standard output is a terminal, output will be piped through
a pager.
If the standard output is not a terminal, no queries are made, and
each file is listed with a one\-line header and two lines of
separation.
.PP
If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
non\-empty, then
.B show
will remove each of the messages shown
from each sequence named by the profile entry.

.SH FILES
.fc ^ ~
.nf
.ta \w'%etcdir%/ExtraBigFileName  'u
^$HOME/.mmh/profile~^The user profile
.fi

.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
.ta 2.4i
.ta \w'ExtraBigProfileName  'u
^Path:~^To determine the user's mail storage
^Current\-Folder:~^To find the default current folder
^Unseen\-Sequence:~^To name sequences denoting unseen messages
.fi

.SH "SEE ALSO"
mhl(1), mhshow(1), more(1), scan(1)

.SH DEFAULTS
.nf
.RB ` +folder "' defaults to the current folder"
.RB ` msgs "' defaults to cur"
.RB ` \-checkmime '
.RB ` \-header '
.fi

.SH CONTEXT
If a folder is given, it will become the current folder.  The last
message shown will become the current message.

.SH BUGS
The
.B \-header
switch doesn't work when `msgs' expands to more than
one message.  If the
.I showproc
is
.BR mhl ,
then this problem can
be circumvented by referencing the \*(lqmessagename\*(rq field in the
.B mhl
format file.
.PP
.B Show
updates the user's context before showing the message.
Hence
.B show
will mark messages as seen prior to the user actually
seeing them.  This is generally not a problem, unless the user relies
on the \*(lqunseen\*(rq messages mechanism, and interrupts
.B show
while it is showing \*(lqunseen\*(rq messages.
.PP
If your
.I showproc
is the pager
.BR more ,
then avoid running
.B show
in the background with only its standard output piped to
another process, as in
.PP
.RS 5
show | imprint &
.RE
.PP
Due to a bug in
.BR more ,
show will go into a \*(lqtty input\*(rq state.
To avoid this problem, re\-direct
.BR show 's
diagnostic output as well.
For users of
.BR csh :
.PP
.RS 5
show |& imprint &
.RE
.PP
For users of
.BR sh :
.PP
.RS 5
show 2>&1 | imprint &
.RE
.PP
.B Next
and
.B prev
are really links to the
.B show
program.  As a result, if
you make a link to
.B next
or
.B prev
and that link is not called
.B next
or
.BR prev ,
your link will act like
.B show
instead.  To circumvent this, add a
profile\-entry for the link to your
.B nmh
profile and add the argument
.I n
or
.I p
to the entry.