Removed note from BUGS section of several man pages saying

that command line arguments must be quoted for protection from
the shell.  That's not a bug, and has nothing to do with nmh.

Changed "back-quoted" to "backquoted" for consistency in a few
man pages.

diff --git a/man/ap.man b/man/ap.man
index e0b5f63..f1b6faa 100644 (file)
--- a/man/ap.man
+++ b/man/ap.man
@@ -1,4 +1,4 @@
-.TH AP %manext8% "March 6, 2012" "%nmhversion%"
+.TH AP %manext8% "November 6, 2012" "%nmhversion%"

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

@@ -100,11 +100,3 @@ Standard for the Format of ARPA Internet Text Messages
 .fi
 .SH CONTEXT
 None
 .fi
 .SH CONTEXT
 None

-.SH BUGS
-The argument to the
-.B \-format
-switch must be interpreted as a single token
-by the shell that invokes
-.BR ap .
-Therefore,
-one must usually place the argument to this switch inside quotes.

diff --git a/man/dp.man b/man/dp.man
index b9b4cc8..3f98913 100644 (file)
--- a/man/dp.man
+++ b/man/dp.man
@@ -1,4 +1,4 @@
-.TH DP %manext8% "March 6, 2012" "%nmhversion%"
+.TH DP %manext8% "November 6, 2012" "%nmhversion%"

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

@@ -81,9 +81,3 @@ None
 .fi
 .SH CONTEXT
 None
 .fi
 .SH CONTEXT
 None

-.SH BUGS
-The argument to the
-.B \-format
-switch must be interpreted as a single token by the shell that invokes
-.BR dp .
-Therefore, one must usually place the argument to this switch inside quotes.

diff --git a/man/inc.man b/man/inc.man
index 04c948b..4c471fc 100644 (file)
--- a/man/inc.man
+++ b/man/inc.man
@@ -1,4 +1,4 @@
-.TH INC %manext1% "July 1, 2012" "%nmhversion%"
+.TH INC %manext1% "November 6, 2012" "%nmhversion%"

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

@@ -327,11 +327,3 @@ message, unless the
 option is specified.  This leaves the context ready for a
 .B show
 of the first new message.
 option is specified.  This leaves the context ready for a
 .B show
 of the first new message.

-.SH BUGS
-The argument to the
-.B \-format
-switch must be interpreted as a single
-token by the shell that invokes
-.BR inc .
-Therefore, one must usually place the argument to this switch inside
-quotes.

diff --git a/man/mh-draft.man b/man/mh-draft.man
index ab16e8a..6e6f4b1 100644 (file)
--- a/man/mh-draft.man
+++ b/man/mh-draft.man
@@ -1,4 +1,4 @@
-.TH MH-DRAFT %manext5% "January 2, 2001" "%nmhversion%"
+.TH MH-DRAFT %manext5% "November 6, 2012" "%nmhversion%"

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

@@ -183,7 +183,7 @@ the user could
 .B scan
 the folder to see which message draft in the
 folder should be used for editing or sending.  Clever users could even
 .B scan
 the folder to see which message draft in the
 folder should be used for editing or sending.  Clever users could even

-employ a back-quoted
+employ a backquoted

 .B pick
 to do the work:
 .PP
 .B pick
 to do the work:
 .PP

diff --git a/man/mh-profile.man b/man/mh-profile.man
index 0e92a5f..a586eef 100644 (file)
--- a/man/mh-profile.man
+++ b/man/mh-profile.man
@@ -1,4 +1,4 @@
-.TH MH-PROFILE %manext5% "October 15, 2012" "%nmhversion%"
+.TH MH-PROFILE %manext5% "November 6, 2012" "%nmhversion%"

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

@@ -31,6 +31,9 @@ This is a comment.
 .PP
 Blank lines are not permitted in
 .IR \&.mh\(ruprofile.
 .PP
 Blank lines are not permitted in
 .IR \&.mh\(ruprofile.

+The shell quoting conventions are not available in the
+.IR \&.mh\(ruprofile ;
+each token is separated by whitespace.

 .SS "Standard Profile Entries"
 The possible profile components are exemplified below.  The only mandatory
 entry is `Path:'.  The others are optional; some have default values if
 .SS "Standard Profile Entries"
 The possible profile components are exemplified below.  The only mandatory
 entry is `Path:'.  The others are optional; some have default values if

@@ -1004,10 +1007,6 @@ lower-case).  If the entry is not absolute (does not start with a
 directory.  As a result, you can actually have more than one set of
 private sequences by using different context files.
 .SH BUGS
 directory.  As a result, you can actually have more than one set of
 private sequences by using different context files.
 .SH BUGS

-The shell quoting conventions are not available in the
-.IR \&.mh\(ruprofile .
-Each token is separated by whitespace.
-.PP

 There is some question as to what kind of arguments should be placed
 in the profile as options.  In order to provide a clear answer, recall
 command line semantics of all
 There is some question as to what kind of arguments should be placed
 in the profile as options.  In order to provide a clear answer, recall
 command line semantics of all

diff --git a/man/mhparam.man b/man/mhparam.man
index 4c2ad88..cc614ef 100644 (file)
--- a/man/mhparam.man
+++ b/man/mhparam.man
@@ -1,4 +1,4 @@
-.TH MHPARAM %manext1% "June 14, 2012" "%nmhversion%"
+.TH MHPARAM %manext1% "November 6, 2012" "%nmhversion%"

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

@@ -92,7 +92,7 @@ context: context
 .RE
 .PP
 .B mhparam
 .RE
 .PP
 .B mhparam

-is also useful in back\-quoted operations:
+is also useful in backquoted operations:

 .PP
 .RS 5
 .nf
 .PP
 .RS 5
 .nf

diff --git a/man/mhpath.man b/man/mhpath.man
index c4928b4..4ecb614 100644 (file)
--- a/man/mhpath.man
+++ b/man/mhpath.man
@@ -1,4 +1,4 @@
-.TH MHPATH %manext1% "February 18, 2012" "%nmhversion%"
+.TH MHPATH %manext1% "November 6, 2012" "%nmhversion%"

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

@@ -105,7 +105,7 @@ mhpath: no messages in range 1\-2
 .RE
 .PP
 .B mhpath
 .RE
 .PP
 .B mhpath

-is also useful in back\-quoted operations:
+is also useful in backquoted operations:

 .PP
 .RS 5
 .nf
 .PP
 .RS 5
 .nf

@@ -115,6 +115,31 @@ is also useful in back\-quoted operations:
 /r/phyl/Mail
 .fi
 .RE
 /r/phyl/Mail
 .fi
 .RE

+Because
+.B mhpath
+expands and sorts
+.RI [ msgs ].
+the command
+.PP
+.RS 5
+.nf
+mv `mhpath 501 500`
+.fi
+.RE
+.PP
+to will not move 501 to 500.
+Quite the reverse.  But
+.PP
+.RS 5
+.nf
+mv `mhpath 501` `mhpath 500`
+.fi
+.RE
+.PP
+will do the trick.
+.PP
+Out of range message 0 is treated far more severely than large out of
+range message numbers.

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

@@ -138,32 +163,3 @@ is also useful in back\-quoted operations:
 .fi
 .SH CONTEXT
 None
 .fi
 .SH CONTEXT
 None

-.SH BUGS
-Like all
-.B nmh
-commands,
-.B mhpath
-expands and sorts
-.RI [ msgs ].
-So don't
-expect
-.PP
-.RS 5
-.nf
-mv `mhpath 501 500`
-.fi
-.RE
-.PP
-to move 501 to 500.
-Quite the reverse.  But
-.PP
-.RS 5
-.nf
-mv `mhpath 501` `mhpath 500`
-.fi
-.RE
-.PP
-will do the trick.
-.PP
-Out of range message 0 is treated far more severely than large out of
-range message numbers.

diff --git a/man/msh.man b/man/msh.man
index ba239ce..2416d7a 100644 (file)
--- a/man/msh.man
+++ b/man/msh.man
@@ -1,4 +1,4 @@
-.TH MSH %manext1% "January 8, 2012" "%nmhversion%"
+.TH MSH %manext1% "November 6, 2012" "%nmhversion%"

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

@@ -176,7 +176,7 @@ substitutions, or alias substitutions.
 .PP
 When parsing commands to the left of any redirection symbol,
 .B msh
 .PP
 When parsing commands to the left of any redirection symbol,
 .B msh

-will honor `\\' (back\-slash) as the quote next\-character symbol, and
+will honor `\\' (backslash) as the quote next\-character symbol, and

 `\*(lq' (double\-quote) as quote\-word delimiters.  All other input tokens
 are separated by whitespace (spaces and tabs).
 .SH FILES
 `\*(lq' (double\-quote) as quote\-word delimiters.  All other input tokens
 are separated by whitespace (spaces and tabs).
 .SH FILES

@@ -208,13 +208,6 @@ are separated by whitespace (spaces and tabs).
 .SH CONTEXT
 None
 .SH BUGS
 .SH CONTEXT
 None
 .SH BUGS

-The argument to the
-.B \-prompt
-switch must be interpreted as a single
-token by the shell that invokes
-.BR msh .
-Therefore, one must usually
-place the argument to this switch inside double\-quotes.

 .PP
 There is a strict limit of messages per file in
 .BR packf 'd
 .PP
 There is a strict limit of messages per file in
 .BR packf 'd

@@ -229,7 +222,7 @@ the nice facilities provided by the latter are not present in the former.
 .PP
 In particular,
 .B msh
 .PP
 In particular,
 .B msh

-does not understand back\-quoting, so the only
+does not understand backquoting, so the only

 effective way to use
 .B pick
 inside
 effective way to use
 .B pick
 inside

diff --git a/man/pick.man b/man/pick.man
index aca0918..fe0ddf4 100644 (file)
--- a/man/pick.man
+++ b/man/pick.man
@@ -1,4 +1,4 @@
-.TH PICK %manext1% "March 6, 2012" "%nmhversion%"
+.TH PICK %manext1% "November 6, 2012" "%nmhversion%"

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

@@ -357,16 +357,7 @@ Use
 to enumerate the messages in a sequence
 (such as for use by a shell script).
 .SH BUGS
 to enumerate the messages in a sequence
 (such as for use by a shell script).
 .SH BUGS

-The argument to the
-.B \-after
-and
-.B \-before
-switches must be interpreted
-as a single token by the shell that invokes
-.BR pick .
-Therefore, one
-must usually place the argument to this switch inside quotes.
-Furthermore, any occurrence of
+Any occurrence of

 .B \-datefield
 must occur prior to the
 .B \-after
 .B \-datefield
 must occur prior to the
 .B \-after

@@ -376,7 +367,7 @@ switch it applies to.
 .PP
 If
 .B pick
 .PP
 If
 .B pick

-is used in a back\-quoted operation, such as
+is used in a backquoted operation, such as

 .PP
 .RS 5
 scan\0`pick\0\-from\0jones`
 .PP
 .RS 5
 scan\0`pick\0\-from\0jones`

diff --git a/man/scan.man b/man/scan.man
index 95cf428..7510505 100644 (file)
--- a/man/scan.man
+++ b/man/scan.man
@@ -1,4 +1,4 @@
-.TH SCAN %manext1% "November 4, 2012" "%nmhversion%"
+.TH SCAN %manext1% "November 6, 2012" "%nmhversion%"

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

@@ -240,14 +240,6 @@ used to generate
 a heading saying what each column in the listing was.  Format strings
 prevent this from happening.
 .SH BUGS
 a heading saying what each column in the listing was.  Format strings
 prevent this from happening.
 .SH BUGS

-The argument to the
-.B \-format
-switch must be interpreted as a single
-token by the shell that invokes
-.BR scan .
-Therefore, one must usually
-place the argument to this switch inside quotes.
-.PP

 The value of each
 .I component
 escape is set by
 The value of each
 .I component
 escape is set by

diff --git a/man/whatnow.man b/man/whatnow.man
index 0a7c952..6b205fb 100644 (file)
--- a/man/whatnow.man
+++ b/man/whatnow.man
@@ -1,4 +1,4 @@
-.TH WHATNOW %manext1% "April 4, 2012" "%nmhversion%"
+.TH WHATNOW %manext1% "November 6, 2012" "%nmhversion%"

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

@@ -231,14 +231,6 @@ information.
 .RB ` \-attach "' defaults to \*(lqNmh-Attachment\*(rq"
 .fi
 .SH BUGS
 .RB ` \-attach "' defaults to \*(lqNmh-Attachment\*(rq"
 .fi
 .SH BUGS

-The argument to the
-.B \-prompt
-switch must be interpreted as a single
-token by the shell that invokes
-.BR whatnow .
-Therefore, one must
-usually place the argument to this switch inside quotes.
-.PP

 If the initial edit fails,
 .B whatnow
 deletes your draft (by renaming
 If the initial edit fails,
 .B whatnow
 deletes your draft (by renaming