]> diplodocus.org Git - nmh/blobdiff - man/mhpath.man
Add failing test case for single-character header parsing.
[nmh] / man / mhpath.man
index 74b539d950cd89014e5a3a4b1e54fa2459e57f10..0c0618d984b1a7ea056f0fa6f62f54301cf97321 100644 (file)
@@ -1,4 +1,4 @@
-.TH MHPATH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHPATH %manext1% "January 20, 2014" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -8,10 +8,10 @@ mhpath \- print full pathnames of nmh messages and folders
 .HP 5
 .na
 .B mhpath
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .B mhpath
@@ -105,7 +105,7 @@ mhpath: no messages in range 1\-2
 .RE
 .PP
 .B mhpath
-is also useful in back\-quoted operations:
+is also useful in backquoted operations:
 .PP
 .RS 5
 .nf
@@ -115,10 +115,38 @@ is also useful in back\-quoted operations:
 /r/phyl/Mail
 .fi
 .RE
+.PP
+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 produces a different error message than large
+out-of-range message numbers.  But both cause
+.B mhpath
+to exit with non-zero status.
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'ExtraBigProfileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
@@ -130,7 +158,7 @@ is also useful in back\-quoted operations:
 ^Current\-Folder:~^To find the default current folder
 .fi
 .SH "SEE ALSO"
-folder(1)
+.IR folder (1)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
@@ -138,32 +166,3 @@ folder(1)
 .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.