]> diplodocus.org Git - nmh/blobdiff - man/show.man
Close temp file.
[nmh] / man / show.man
index cf3db8060b2e493ddf9655dc5191d3a966e235cf..89a5719e1c7d9b23bb2a87f83c45560d5e494579 100644 (file)
@@ -1,13 +1,15 @@
+.TH SHOW %manext1% "March 24, 2016" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 show \- show (display) messages
 .SH SYNOPSIS
 .HP 5
+.na
 .B show
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-draft ]
@@ -17,14 +19,14 @@ show \- show (display) messages
 .IR program ]
 .RB [ \-header " | " \-noheader ]
 .RB [ \-checkmime " | " \-nocheckmime ]
+.RB [ \-concat " | " \-noconcat ]
 [switches\ for
 .I showproc
 or
 .IR showmimeproc ]
-.RB [ \-version ]
-.RB [ \-help ]
+.ad
 .SH DESCRIPTION
-.B Show
+.B show
 lists each of the specified messages to the standard output
 (typically, the terminal).
 .PP
@@ -37,12 +39,16 @@ 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)
+.IR 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
+.BR show ,
+as well as
+.B \-header
+and
+.BR \-noheader ,
 are
 passed along to that program.  To override the default and the
 .I showproc
@@ -67,7 +73,7 @@ contents) are processed and displayed by the
 command
 .BR mhshow .
 See the
-.BR mhshow (1)
+.IR mhshow (1)
 manual page for details
 about this command.  This default can changed by defining the
 .I showmimeproc
@@ -91,14 +97,15 @@ 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
+can be displayed natively.  The appropriate
+.IR locale (1)
+environment variables
 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.
+.IR locale (1)
+man page for details about these environment variables.
 .PP
 The option
 .B \-checkmime
@@ -128,14 +135,6 @@ messages.  It is equivalent to
 .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
@@ -144,6 +143,12 @@ to display a one\-line
 description of the message being shown.  This description includes
 the folder and the message number.
 .PP
+By default
+.B show
+will concatenate all content under one pager.  If you want each part to
+displayed separately, you can override the default behavior with
+.B \-noconcat.
+.PP
 If no `msgs' are specified, the current message is used.  Although
 it depends on the specific
 .I showproc
@@ -169,14 +174,12 @@ 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'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -188,22 +191,23 @@ from each sequence named by the profile entry.
 ^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)
-
+.IR mhl (1),
+.IR mhshow (1),
+.IR next (1),
+.IR prev (1),
+.IR scan (1)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to cur"
 .RB ` \-checkmime '
 .RB ` \-header '
+.RB ` \-concat '
 .fi
-
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The last
-message shown will become the current message.
-
+message selected will become the current message.
 .SH BUGS
 The
 .B \-header
@@ -217,7 +221,7 @@ be circumvented by referencing the \*(lqmessagename\*(rq field in the
 .B mhl
 format file.
 .PP
-.B Show
+.B show
 updates the user's context before showing the message.
 Hence
 .B show