Fix invalid pointer arithmetic.

[nmh] / man / show.man

diff --git a/man/show.man b/man/show.man
index cf3db8060b2e493ddf9655dc5191d3a966e235cf..4a0f5f4829caa0d8f0affa3a5a3056ad02d52a9d 100644 (file)
--- a/man/show.man
+++ b/man/show.man
@@ -1,30 +1,32 @@
-.\"
+.TH SHOW %manext1% 2016-03-24 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\" $Id$
-.\"
-.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.
 .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
@@ -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
@@ -58,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
@@ -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.
+See
+.IR locale (1)
+for details about these environment variables.
 .PP
 The option
 .B \-checkmime
@@ -128,22 +135,20 @@ 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
 .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
@@ -157,26 +162,24 @@ 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.
-
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
+^$HOME/.mh_profile~^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
@@ -234,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
@@ -263,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