mhbuildsbr.c: Don't free(3) string then print it; do reverse.

[nmh] / man / scan.man

diff --git a/man/scan.man b/man/scan.man
index 17a702caee89c1c6cceebe6a38b9a98bebc0f45c..6d41cebb1874376f1f62c53749af2746a52f3e5f 100644 (file)
--- a/man/scan.man
+++ b/man/scan.man
@@ -1,13 +1,15 @@
-.TH SCAN %manext1% "November 6, 2012" "%nmhversion%"
-.\"
+.TH SCAN %manext1% 2014-01-20 "%nmhversion%"
+.

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

-.\"
+.

 .SH NAME
 .SH NAME

-scan \- produce a one line per message scan listing
+scan \- produce a summary listing of nmh messages

 .SH SYNOPSIS
 .HP 5
 .na
 .B scan
 .SH SYNOPSIS
 .HP 5
 .na
 .B scan

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

 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-clear " | " \-noclear ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-clear " | " \-noclear ]


@@ -21,12 +23,10 @@ scan \- produce a one line per message scan listing
 .RB [ \-reverse " | " \-noreverse ]
 .RB [ \-file
 .IR filename ]
 .RB [ \-reverse " | " \-noreverse ]
 .RB [ \-file
 .IR filename ]

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

 .ad
 .SH DESCRIPTION
 .ad
 .SH DESCRIPTION

-.B Scan
-produces a one\-line\-per\-message listing of the specified
+.B scan
+produces a one-line-per-message listing of the specified

 folder or messages.  Each
 .B scan
 line contains the message number
 folder or messages.  Each
 .B scan
 line contains the message number


@@ -61,7 +61,7 @@ If there is sufficient room left on the
 line after the
 subject, the line will be filled with text from the body, preceded by
 \*(lq<<\*(rq, and terminated by \*(lq>>\*(rq if the body is sufficiently short.
 line after the
 subject, the line will be filled with text from the body, preceded by
 \*(lq<<\*(rq, and terminated by \*(lq>>\*(rq if the body is sufficiently short.

-.B Scan
+.B scan

 actually reads each of the specified messages and parses them to extract
 the desired fields.  During parsing, appropriate error messages will be
 produced if there are format errors in any of the messages.
 actually reads each of the specified messages and parses them to extract
 the desired fields.  During parsing, appropriate error messages will be
 produced if there are format errors in any of the messages.


@@ -70,7 +70,7 @@ By default,
 .B scan
 will decode RFC 2047 (MIME) encoding in
 these scan listings.
 .B scan
 will decode RFC 2047 (MIME) encoding in
 these scan listings.

-.B Scan
+.B scan

 will only decode these fields if your
 terminal can natively display the character set used in the encoding.
 You should set the appropriate
 will only decode these fields if your
 terminal can natively display the character set used in the encoding.
 You should set the appropriate


@@ -92,7 +92,7 @@ The
 .I filename
 switch allows the user to obtain a
 .B scan
 .I filename
 switch allows the user to obtain a
 .B scan

-listing of a maildrop file as produced by
+listing of a mail drop file as produced by

 .BR packf .
 This listing
 includes every message in the file (you can't scan individual messages).
 .BR packf .
 This listing
 includes every message in the file (you can't scan individual messages).


@@ -148,7 +148,7 @@ followed by a formatted listing of all messages in the folder, one
 per page.  Omitting
 .RB \*(lq "\-show\ pr\ \-f" \*(rq
 will cause the messages to be
 per page.  Omitting
 .RB \*(lq "\-show\ pr\ \-f" \*(rq
 will cause the messages to be

-concatenated, separated by a one\-line header and two blank lines.
+concatenated, separated by a one-line header and two blank lines.

 .PP
 To override the output format used by
 .BR scan ,
 .PP
 To override the output format used by
 .BR scan ,


@@ -182,6 +182,10 @@ folder     string  the name of the current folder
 .fi
 .RE
 .PP
 .fi
 .RE
 .PP

+.RB { body }
+returns a string without MIME decoding,
+i.e.\& the MIME boundary seperator may be the first text shown.
+.PP

 If no date header is present in the message, the
 .I function
 escapes
 If no date header is present in the message, the
 .I function
 escapes


@@ -193,7 +197,7 @@ scanning a draft folder, as message drafts usually aren't allowed
 to have dates in them.
 .PP
 The
 to have dates in them.
 .PP
 The

-.B %etcdir%
+.B %nmhetcdir%

 directory contains several format files as examples of customized
 .B scan
 output.
 directory contains several format files as examples of customized
 .B scan
 output.


@@ -210,8 +214,8 @@ purists hate this idea.
 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'%etcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
+^$HOME/.mh_profile~^The user profile

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