X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/fc25a4f840747685117a482f9a0cf6296224ea1a..9f8418e870a70c264eda1598f2d470e5428c216d:/man/mhpath.man diff --git a/man/mhpath.man b/man/mhpath.man index 51c71448..0c0618d9 100644 --- a/man/mhpath.man +++ b/man/mhpath.man @@ -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 @@ -116,14 +116,39 @@ is also useful in back\-quoted operations: .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" .fc ^ ~ .nf @@ -132,45 +157,12 @@ is also useful in back\-quoted operations: ^Path:~^To determine the user's nmh directory ^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" .RB ` msgs "' defaults to 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.