Updated man page of mhshow(1) to recent changes.

[mmh] / man / show.man1

diff --git a/man/show.man1 b/man/show.man1
index 93ab455..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
 .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
 .SH SYNOPSIS
 .HP 5
 .na

@@ -22,11 +26,29 @@ or
 .IR showmimeproc ]
 .RB [ \-version ]
 .RB [ \-help ]
 .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
 .ad

+

 .SH DESCRIPTION
 .B Show
 lists each of the specified messages to the standard output
 (typically, the terminal).
 .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
 .PP
 By default, text (non-MIME) messages are filtered and displayed by
 the

@@ -39,14 +61,10 @@ the format of the displayed messages and which headers fields are
 shown.  See the
 .BR mhl (1)
 manual page for the details about this
 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
 .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,
 .B \-showproc
 .I program
 switch.  For example,

@@ -54,61 +72,40 @@ switch.  For example,
 .I more
 will cause the
 .B more
 .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
 .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
 .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
 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
 .B \-showmimeproc
 .I program
 switch.
 .PP

-Note that in some cases,
+Note that,

 .B show
 .B show

-may invoke the
+will invoke the

 .I showmimeproc
 .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
 .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 ,
 .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
 The option
 .B \-nocheckmime
 disables this test and instructs

@@ -116,7 +113,7 @@ disables this test and instructs
 to use
 .IR showproc ,
 regardless of whether
 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
 .PP
 The
 .B \-header

@@ -126,18 +123,10 @@ to display a one\-line
 description of the message being shown.  This description includes
 the folder and the message number.
 .PP
 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
 .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.
 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.

@@ -163,12 +152,10 @@ from each sequence named by the profile entry.
 ^Path:~^To determine the user's mail storage
 ^Current\-Folder:~^To find the default current folder
 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
 ^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"
 .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
 
 .SH DEFAULTS
 .nf

@@ -207,26 +194,6 @@ while it is showing \*(lqunseen\*(rq messages.
 .PP
 If your
 .I showproc
 .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
 is the pager
 .BR more ,
 then avoid running

@@ -257,3 +224,28 @@ For users of
 .RS 5
 show 2>&1 | imprint &
 .RE
 .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.