X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmhpath.man;h=e9879f4c8c21d2425bf61ca7a2bb6a60f563550c;hb=0d33f1e27c4edb7290ef51cd03d50c0dbc9059ef;hp=e04c4a3f808c9162b56e3ea6176406fa40b8f250;hpb=8c7907f07f098ce5375e39e710f615931777ef4c;p=mmh diff --git a/man/mhpath.man b/man/mhpath.man index e04c4a3..e9879f4 100644 --- a/man/mhpath.man +++ b/man/mhpath.man @@ -1,7 +1,7 @@ +.TH MHPATH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .\" .\" %nmhwarning% .\" -.TH MHPATH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME mhpath \- print full pathnames of nmh messages and folders .SH SYNOPSIS @@ -48,9 +48,14 @@ message, if the folder contains messages. .IP 3) 4 An empty folder is not in itself an error. .PP -Message numbers greater than the highest existing message in a folder -as part of a range designation are replaced with the next free message -number. +A message number less than that of the smallest existing message in a +folder is treated as if the message already exists. A message number +greater than that of the highest existing message in a folder causes +an \*(lqout of range\*(rq error message to be displayed. +.PP +As part of a range designation that contains messages that do exist, +message numbers less than the smallest, or greater than the highest, +existing message in a folder are ignored. .PP Examples: The current folder foo contains messages 3 5 6. Cur is 4. @@ -66,7 +71,7 @@ Cur is 4. /r/phyl/Mail/foo/6 % mhpath 2001 -/r/phyl/Mail/foo/7 +mhpath: message 2001 out of range 1-6 % mhpath 1\-2001 /r/phyl/Mail/foo/3 @@ -81,13 +86,13 @@ Cur is 4. /r/phyl/Mail/foo/7 % mhpath last\-new -bad message list \*(lqlast\-new\*(rq. +mhpath: bad message list last\-new % mhpath cur /r/phyl/Mail/foo/4 % mhpath 1\-2 -no messages in range \*(lq1\-2\*(rq. +mhpath: no messages in range 1\-2 % mhpath first:2 /r/phyl/Mail/foo/3 @@ -110,15 +115,12 @@ is also useful in back\-quoted operations: /r/phyl/Mail .fi .RE -.PP - .SH FILES .fc ^ ~ .nf .ta \w'%etcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile .fi - .SH "PROFILE COMPONENTS" .fc ^ ~ .nf @@ -127,19 +129,15 @@ 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