Added getmymbox function escape.

[nmh] / man / mhlist.man

diff --git a/man/mhlist.man b/man/mhlist.man
index fab619f9611b4b901c060fdc258334ee0b22cbdc..a75e50d82384e0b4b7b068b573349b97347ac0a2 100644 (file)
--- a/man/mhlist.man
+++ b/man/mhlist.man
@@ -1,4 +1,4 @@
-.TH MHLIST %manext1% "January 9, 2001" "%nmhversion%"
+.TH MHLIST %manext1% "August 20, 2014" "%nmhversion%"

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


@@ -25,7 +25,9 @@ mhlist \- list information about MIME messages
 .RB [ \-wcache
 .IR policy ]
 .RB [ \-check " | " \-nocheck ]
 .RB [ \-wcache
 .IR policy ]
 .RB [ \-check " | " \-nocheck ]

+.RB [ \-changecur " | " \-nochangecur ]

 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-verbose " | " \-noverbose ]

+.RB [ \-disposition " | " \-nodisposition ]

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


@@ -38,7 +40,7 @@ MIME (multi-media) messages.
 .PP
 .B mhlist
 manipulates MIME (multi-media messages) as specified
 .PP
 .B mhlist
 manipulates MIME (multi-media messages) as specified

-in RFC\-2045 thru RFC\-2049 (See
+in RFC 2045 to RFC 2049 (See

 .IR mhbuild (1)).
 .PP
 The
 .IR mhbuild (1)).
 .PP
 The


@@ -53,6 +55,8 @@ switch tells
 to evaluate the
 \*(lqnative\*(rq (decoded) format of each content prior to listing.
 This provides an accurate count at the expense of a small delay.
 to evaluate the
 \*(lqnative\*(rq (decoded) format of each content prior to listing.
 This provides an accurate count at the expense of a small delay.

+In either case, sizes will be expressed using SI prefix abbreviations
+(K/M/G/T), which are based on factors of 1000.

 .PP
 If the
 .B \-verbose
 .PP
 If the
 .B \-verbose


@@ -60,6 +64,11 @@ switch is present, then the listing will show
 any \*(lqextra\*(rq information that is present in the message,
 such as comments in the \*(lqContent-Type\*(rq header.
 .PP
 any \*(lqextra\*(rq information that is present in the message,
 such as comments in the \*(lqContent-Type\*(rq header.
 .PP

+If the
+.B \-disposition
+switch is present, then the listing will show any relevant information from
+the \*(lqContent-Disposition\*(rq header.
+.PP

 The option
 .B \-file
 .I file
 The option
 .B \-file
 .I file


@@ -106,7 +115,7 @@ switch will not prevent the content from being acted upon.
 .PP
 A content specification consists of a content type and a subtype.
 The initial list of \*(lqstandard\*(rq content types and subtypes can
 .PP
 A content specification consists of a content type and a subtype.
 The initial list of \*(lqstandard\*(rq content types and subtypes can

-be found in RFC\-2046.
+be found in RFC 2046.

 .PP
 A list of commonly used contents is briefly reproduced here:
 .PP
 .PP
 A list of commonly used contents is briefly reproduced here:
 .PP


@@ -142,6 +151,10 @@ act on a message/external-body content, then the
 switch must
 be used twice: once for message/external-body and once for the content
 externally referenced.
 switch must
 be used twice: once for message/external-body and once for the content
 externally referenced.

+.PP
+The parts of a multipart/alternative part are listed in the reverse
+order of their placement in the message.  The listing therefore is
+in decreasing order of preference, as defined in RFC 2046.

 .SS "Checking the Contents"
 The
 .B \-check
 .SS "Checking the Contents"
 The
 .B \-check


@@ -156,7 +169,7 @@ integrity of the content.
 .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
 .SH "PROFILE COMPONENTS"
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"


@@ -168,10 +181,9 @@ integrity of the content.
 ^Current\-Folder:~^To find the default current folder
 .fi
 .SH "SEE ALSO"
 ^Current\-Folder:~^To find the default current folder
 .fi
 .SH "SEE ALSO"

-,IR mhbuild (1),
+.IR mhbuild (1),

 .IR mhshow (1),
 .IR mhshow (1),

-.IR mhstore (1),
-.IR sendfiles (1)
+.IR mhstore (1)

 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"


@@ -181,8 +193,12 @@ integrity of the content.
 .RB ` \-realsize '
 .RB ` \-rcache\ ask '
 .RB ` \-wcache\ ask '
 .RB ` \-realsize '
 .RB ` \-rcache\ ask '
 .RB ` \-wcache\ ask '

+.RB ` \-changecur '

 .RB ` \-noverbose '
 .RB ` \-noverbose '

+.RB ` \-nodisposition '

 .fi
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The last
 .fi
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The last

-message selected will become the current message.
+message selected will become the current message, unless the
+.B \-nochangecur
+option is specified.