Don't need to cast to `char *' for free(3) these days.

[nmh] / man / show.man

diff --git a/man/show.man b/man/show.man
index 64a1a67112df8259206b504fa0ef02b8d73f707e..1d6eb36651a22a67224166222a7ccfc51ea8899f 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,12 +19,11 @@ 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
 .B Show
 .ad
 .SH DESCRIPTION
 .B Show


@@ -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'%etcdir%/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