X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmhpath.man;h=4ad442c22c445fdb62e6c2e6185e0d9623a3d8e1;hb=d8c7d4f2c785d35cebd5ea64213a335561a57f7d;hp=ff17b73f5b8fd9afb145142e20f64c95db14ca3b;hpb=1691e80890e5d8ba258c51c214a3e91880e1db2b;p=mmh diff --git a/man/mhpath.man b/man/mhpath.man index ff17b73..4ad442c 100644 --- a/man/mhpath.man +++ b/man/mhpath.man @@ -1,55 +1,67 @@ .\" .\" %nmhwarning% -.\" $Id$ .\" -.\" include the -mh macro file -.so %etcdir%/tmac.h -.\" -.TH MHPATH %manext1% MH.6.8 [%nmhversion%] +.TH MHPATH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME mhpath \- print full pathnames of nmh messages and folders .SH SYNOPSIS -.in +.5i -.ti -.5i -mhpath -\%[+folder] \%[msgs] -\%[\-version] -\%[\-help] -.in -.5i +.HP 5 +.na +.B mhpath +.RI [ +folder ] +.RI [ msgs ] +.RB [ \-version ] +.RB [ \-help ] +.ad .SH DESCRIPTION -\fIMhpath\fR expands and sorts the message list `msgs' and writes the full +.B mhpath +expands and sorts the message list `msgs' and writes the full pathnames of the messages to the standard output separated by newlines. -If no `msgs' are specified, \fImhpath\fR outputs the folder pathname -instead. If the only argument is `+', your nmh \fIPath\fR is output; -this can be useful is shell scripts. - -Contrasted with other nmh commands, a message argument to \fImhpath\fR -may often be intended for \fIwriting\fR. Because of this: -.sp -1) the name \*(lqnew\*(rq has been added to \fImhpath\fR's list of +If no `msgs' are specified, +.B mhpath +outputs the current mail folder's pathname +instead. If the only argument is `+', your +.B nmh +\*(lqPath\*(rq is output; this can be useful in shell scripts. +.PP +Contrasted with other +.B nmh +commands, a message argument to +.B mhpath +may often be intended for writing. Because of this: +.PP +.IP 1) 4 +the name \*(lqnew\*(rq has been added to +.BR mhpath 's +list of reserved message names (the others are \*(lqfirst\*(rq, \*(lqlast\*(rq, \*(lqprev\*(rq, \*(lqnext\*(rq, \*(lqcur\*(rq, and \*(lqall\*(rq). The new message is equivalent to the message after the last message in a folder (and equivalent to 1 in a folder without messages). The \*(lqnew\*(rq message may not be used as part of a message range. -.sp -2) Within a message list, the following designations may refer to messages +.IP 2) 4 +Within a message list, the following designations may refer to messages that do not exist: a single numeric message name, the single message name \*(lqcur\*(rq, and (obviously) the single message name \*(lqnew\*(rq. All other message designations must refer to at least one existing -message. -.sp -3) An empty folder is not in itself an error. - -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. - +message, if the folder contains messages. +.IP 3) 4 +An empty folder is not in itself an error. +.PP +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. - +.PP +.RS 5 .nf -.in +.5i % mhpath /r/phyl/Mail/foo @@ -59,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 @@ -74,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 @@ -89,48 +101,76 @@ no messages in range \*(lq1\-2\*(rq. % mhpath 1 2 /r/phyl/Mail/foo/1 /r/phyl/Mail/foo/2 -.in -.5i .fi - -\fImhpath\fR is also useful in back\-quoted operations: - +.RE +.PP +.B mhpath +is also useful in back\-quoted operations: +.PP +.RS 5 .nf -.in +.5i % cd `mhpath +inbox` % echo `mhpath +` /r/phyl/Mail -.in -.5i .fi -.Fi +.RE +.PP + +.SH FILES +.fc ^ ~ +.nf +.ta \w'%etcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile -.Pr +.fi + +.SH "PROFILE COMPONENTS" +.fc ^ ~ +.nf +.ta 2.4i +.ta \w'ExtraBigProfileName 'u ^Path:~^To determine the user's nmh directory -.Ps ^Current\-Folder:~^To find the default current folder -.Sa +.fi + +.SH "SEE ALSO" folder(1) -.De -`+folder' defaults to the current folder -.Ds -`msgs' defaults to none -.Co + +.SH DEFAULTS +.nf +.RB ` +folder "' defaults to the current folder" +.RB ` msgs "' defaults to none" +.fi + +.SH CONTEXT None -.Bu -Like all nmh commands, \fImhpath\fR expands and sorts \%[msgs]. So don't -expect -.ti +.5i +.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 - -.ti +.5i +.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. -.En