]> diplodocus.org Git - nmh/blobdiff - man/show.man
Allow advertise() to assume strerror(3) won't fail.
[nmh] / man / show.man
index a248e6acd62c4b5c005ef3908ef464810db71622..078181640dad68d1fec055b82bca8e917a5d2178 100644 (file)
@@ -1,13 +1,15 @@
-.TH SHOW %manext1% "June 6, 2012" "%nmhversion%"
-.\"
+.TH SHOW %manext1% 2016-03-24 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
-show \- show (display) messages
+show \- show (display) nmh messages
 .SH SYNOPSIS
 .HP 5
 .na
 .B show
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-draft ]
@@ -17,15 +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
@@ -43,7 +44,11 @@ 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
@@ -59,7 +64,7 @@ program to list the messages with no reformatting.  Normally, this
 program is specified as the
 .I showproc
 in the user's
-.IR \&.mh\(ruprofile ,
+.IR \&.mh_profile ,
 rather than using a command line switch.
 .PP
 By default, non-text messages (MIME messages with multi-media
@@ -138,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
@@ -167,7 +178,7 @@ from each sequence named by the profile entry.
 .fc ^ ~
 .nf
 .ta \w'%nmhetcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+^$HOME/.mh_profile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
@@ -192,6 +203,7 @@ from each sequence named by the profile entry.
 .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
@@ -209,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