ap: Fix write past end of addrs[] array.

[nmh] / man / show.man

diff --git a/man/show.man b/man/show.man
index c274175a86e2ca9b9d1bc8cf9e8e63dce4c0a8e9..89a5719e1c7d9b23bb2a87f83c45560d5e494579 100644 (file)
--- a/man/show.man
+++ b/man/show.man
@@ -1,14 +1,15 @@
+.TH SHOW %manext1% "March 24, 2016" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .\"

-.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]

 .SH NAME
 show \- show (display) messages
 .SH SYNOPSIS
 .HP 5
 .na
 .B show
 .SH NAME
 show \- show (display) messages
 .SH SYNOPSIS
 .HP 5
 .na
 .B show

+.RB [ \-help ]
+.RB [ \-version ]

 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-draft ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-draft ]


@@ -18,15 +19,14 @@ show \- show (display) messages
 .IR program ]
 .RB [ \-header " | " \-noheader ]
 .RB [ \-checkmime " | " \-nocheckmime ]
 .IR program ]
 .RB [ \-header " | " \-noheader ]
 .RB [ \-checkmime " | " \-nocheckmime ]

+.RB [ \-concat " | " \-noconcat ]

 [switches\ for
 .I showproc
 or
 .IR showmimeproc ]
 [switches\ for
 .I showproc
 or
 .IR showmimeproc ]

-.RB [ \-version ]
-.RB [ \-help ]

 .ad
 .SH DESCRIPTION
 .ad
 .SH DESCRIPTION

-.B Show
+.B show

 lists each of the specified messages to the standard output
 (typically, the terminal).
 .PP
 lists each of the specified messages to the standard output
 (typically, the terminal).
 .PP


@@ -39,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
 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
 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
 are
 passed along to that program.  To override the default and the
 .I showproc


@@ -69,7 +73,7 @@ contents) are processed and displayed by the
 command
 .BR mhshow .
 See 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
 manual page for details
 about this command.  This default can changed by defining the
 .I showmimeproc


@@ -93,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
 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
 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
 .PP
 The option
 .B \-checkmime


@@ -130,14 +135,6 @@ messages.  It is equivalent to
 .IR cat .
 It is still accepted, but should be considered (somewhat) obsolete.
 .PP
 .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
 The
 .B \-header
 switch tells


@@ -146,6 +143,12 @@ to display a one\-line
 description of the message being shown.  This description includes
 the folder and the message number.
 .PP
 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
 If no `msgs' are specified, the current message is used.  Although
 it depends on the specific
 .I showproc


@@ -171,14 +174,12 @@ non\-empty, then
 .B show
 will remove each of the messages shown
 from each sequence named by the profile entry.
 .B show
 will remove each of the messages shown
 from each sequence named by the profile entry.

-

 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u

 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi

-

 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf


@@ -190,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
 ^showproc:~^Program to show text (non-MIME) messages
 ^showmimeproc:~^Program to show non-text (MIME) messages
 .fi

-

 .SH "SEE ALSO"
 .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 '
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to cur"
 .RB ` \-checkmime '
 .RB ` \-header '

+.RB ` \-concat '

 .fi
 .fi

-

 .SH CONTEXT
 If a folder is given, it will become the current folder.  The last
 .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
 .SH BUGS
 The
 .B \-header


@@ -219,7 +221,7 @@ be circumvented by referencing the \*(lqmessagename\*(rq field in the
 .B mhl
 format file.
 .PP
 .B mhl
 format file.
 .PP

-.B Show
+.B show

 updates the user's context before showing the message.
 Hence
 .B show
 updates the user's context before showing the message.
 Hence
 .B show