crawl_folders.h: Base header on implementation.

[nmh] / man / show.man

diff --git a/man/show.man b/man/show.man
index 57832c3f66a75a5012b324fd899cf56ef640ae03..4a0f5f4829caa0d8f0affa3a5a3056ad02d52a9d 100644 (file)
--- a/man/show.man
+++ b/man/show.man
@@ -1,31 +1,32 @@
-.TH SHOW %manext1% "February 8, 2015" "%nmhversion%"
-.\"
+.TH SHOW %manext1% 2016-03-24 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
-show \- show (display) messages
+show \- display nmh messages
 .SH SYNOPSIS
 .HP 5
 .na
 .B show
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-draft ]
-.RB [\-showproc
+.RB [ \-showproc
 .IR program ]
 .RB [ \-showmimeproc
 .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
@@ -63,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
@@ -102,9 +103,9 @@ environment variables
 should be set to the terminal's native character set to avoid
 gratuitous invocations of the
 .IR showmimeproc .
-See the
+See
 .IR locale (1)
-man page for details about these environment variables.
+for details about these environment variables.
 .PP
 The option
 .B \-checkmime
@@ -138,10 +139,16 @@ The
 .B \-header
 switch tells
 .B show
-to display a one\-line
+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
@@ -155,15 +162,15 @@ 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
+each file is listed with a one-line header and two lines of
 separation.
 .PP
 .RB \*(lq "show \-draft" \*(rq
-will list the file <mh\-dir>/draft if it
+will list the file <mh-dir>/draft if it
 exists.
 .PP
 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
-non\-empty, then
+non-empty, then
 .B show
 will remove each of the messages shown
 from each sequence named by the profile entry.
@@ -171,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 ^ ~
@@ -196,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
@@ -213,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
@@ -230,13 +238,13 @@ is
 (the default), then
 .B show
 uses
-a built\-in
+a built-in
 .BR mhl :
 it does not actually run the
 .B mhl
 program.
 Hence, if you define your own
-.B showproc ,
+.BR showproc ,
 don't call it
 .B mhl
 since
@@ -259,7 +267,7 @@ show | imprint &
 Due to a bug in
 .BR more ,
 show will go into a \*(lqtty input\*(rq state.
-To avoid this problem, re\-direct
+To avoid this problem, re-direct
 .BR show 's
 diagnostic output as well.
 For users of