.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
+.RB [ \-showproc
.IR program ]
.RB [ \-showmimeproc
.IR program ]
.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
shown. See the
.BR mhl (1)
manual page for the details about this
-command. This default can be changed by defining the
-.I showproc
-profile component. Any switches not recognized by
+command. Any switches not recognized by
.B show
are
-passed along to that program. To override the default and the
-.I showproc
-profile component, use the
+passed along to that program. To override the default, use the
.B \-showproc
.I program
switch. For example,
.I more
will cause the
.B more
-program to list the messages with no reformatting. Normally, this
-program is specified as the
-.I showproc
-in the user's profile,
-rather than using a command line switch.
+program to list the messages with no reformatting.
.PP
-By default, non-text messages (MIME messages with multi-media
-contents) are processed and displayed by the
+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. This default can changed by defining the
-.I showmimeproc
-profile component. Any switches not recognized
+about this command.
+Any switches not recognized
by
.B show
are passed along to that program. To override this
-default and the
-.B showmimeproc
-profile component, use the
+default, use the
.B \-showmimeproc
.I program
switch.
.PP
-Note that in some cases,
+Note that,
.B show
-may invoke the
+will invoke the
.I showmimeproc
-even for textual contents. This will happen for text messages that
-specify a transfer encoding (such as MIME quoted-printable or
-base64) or specify a character set that
-.B show
-doesn't believe
-can be displayed natively. The environment variable
-.B $MM_CHARSET
-should be set to the terminal's native character set to avoid
-gratuitous invocations of the
-.IR showmimeproc .
-See the
-.BR mh-profile (5)
-man page for details about this environment variable.
+even for textual contents if the message has a MIME-Version header.
.PP
The option
.B \-checkmime
(set by default) instructs
.B show
-to
-test if any of the messages to be displayed are non-text (MIME)
-messages. If any are non-text, they are displayed by the program
+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 program
-.IR showproc .
+else they are displayed by the
+.BR showproc .
The option
.B \-nocheckmime
disables this test and instructs
to use
.IR showproc ,
regardless of whether
-any of the messages are non-text (MIME) messages.
+any of the messages are MIME messages.
.PP
The
.B \-header
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. Although
-it depends on the specific
-.I showproc
-or
-.IR showmimeproc ,
-in the default setup when more than one message is specified, you
-will be prompted for a <RETURN> prior to listing each message.
-Each message will be listed a page at a time, and when the end of
-page is reached, the program will wait for a <SPACE> or <RETURN>.
-If a <RETURN> is entered, it will print the next line, whereas
-<SPACE> will print the next screenful.
+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.
^Path:~^To determine the user's mail storage
^Current\-Folder:~^To find the default current folder
^Unseen\-Sequence:~^To name sequences denoting unseen messages
-^showproc:~^Program to show text (non-MIME) messages
-^showmimeproc:~^Program to show non-text (MIME) messages
.fi
.SH "SEE ALSO"
-mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
+mhl(1), mhshow(1), more(1), scan(1)
.SH DEFAULTS
.nf
.PP
If your
.I showproc
-is
-.B mhl
-(the default), then
-.B show
-uses
-a built\-in
-.BR mhl :
-it does not actually run the
-.B mhl
-program.
-Hence, if you define your own
-.B showproc ,
-don't call it
-.B mhl
-since
-.B show
-won't run it.
-.PP
-If your
-.I showproc
is the pager
.BR more ,
then avoid running
.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.