+++ /dev/null
-.\"
-.\" %nmhwarning%
-.\"
-.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.SH NAME
-show \- show (display) messages
-.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 ]
-.ad
-.SH DESCRIPTION
-.B Show
-lists each of the specified messages to the standard output
-(typically, the terminal).
-.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. This default can be changed by defining the
-.I showproc
-profile component. 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
-.B \-showproc
-.I program
-switch. For example,
-.B \-showproc
-.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.
-.PP
-By default, non-text messages (MIME messages with multi-media
-contents) 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
-by
-.B show
-are passed along to that program. To override this
-default and the
-.B showmimeproc
-profile component, use the
-.B \-showmimeproc
-.I program
-switch.
-.PP
-Note that in some cases,
-.B show
-may 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.
-.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
-.IR showmimeproc ,
-else they are displayed by the program
-.IR showproc .
-The option
-.B \-nocheckmime
-disables this test and instructs
-.B show
-to use
-.IR showproc ,
-regardless of whether
-any of the messages are non-text (MIME) messages.
-.P
-The
-.B \-noshowproc
-switch will disable any formatting or paging of
-messages. It is equivalent to
-.B \-nocheckmime
-.B \-showproc
-.IR cat .
-It is still accepted, but should be considered (somewhat) obsolete.
-.PP
-If the environment variable
-.B $NOMHNPROC
-is set, the test for
-non-text (MIME) messages will be disabled. This method is obsolete.
-Use the
-.B \-nocheckmime
-switch instead.
-.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. 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.
-.PP
-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
-^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)
-
-.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
-.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
-.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
projects / mmh / blobdiff