Merged man pages next(1) and prev(1) into show(1).

[mmh] / man / show.man1

diff --git a/man/show.man1 b/man/show.man1
index 047baf5..b467122 100644 (file)
--- a/man/show.man1
+++ b/man/show.man1
@@ -4,6 +4,10 @@
 .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
@@ -22,11 +26,29 @@ 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
@@ -52,8 +74,7 @@ will cause the
 .B more
 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 .
@@ -70,31 +91,18 @@ default, use the
 .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
+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 .
@@ -105,7 +113,7 @@ 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
@@ -115,18 +123,10 @@ 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.  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.
@@ -155,7 +155,7 @@ from each sequence named by the profile entry.
 .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
@@ -224,3 +224,28 @@ For users of
 .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.