5 .TH MHPATH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 mhpath \- print full pathnames of nmh messages and folders
19 expands and sorts the message list `msgs' and writes the full
20 pathnames of the messages to the standard output separated by newlines.
21 If no `msgs' are specified,
23 outputs the folder pathname
24 instead. If the only argument is `+', your
26 \*(lqPath\*(rq is output; this can be useful is shell scripts.
30 commands, a message argument to
32 may often be intended for writing. Because of this:
35 the name \*(lqnew\*(rq has been added to
38 reserved message names (the others are \*(lqfirst\*(rq, \*(lqlast\*(rq,
39 \*(lqprev\*(rq, \*(lqnext\*(rq, \*(lqcur\*(rq, and \*(lqall\*(rq).
40 The new message is equivalent to the message after the last message
41 in a folder (and equivalent to 1 in a folder without messages).
42 The \*(lqnew\*(rq message may not be used as part of a message range.
44 Within a message list, the following designations may refer to messages
45 that do not exist: a single numeric message name, the single message name
46 \*(lqcur\*(rq, and (obviously) the single message name \*(lqnew\*(rq.
47 All other message designations must refer to at least one existing
50 An empty folder is not in itself an error.
52 Message numbers greater than the highest existing message in a folder
53 as part of a range designation are replaced with the next free message
56 Examples: The current folder foo contains messages 3 5 6.
85 bad message list \*(lqlast\-new\*(rq.
91 no messages in range \*(lq1\-2\*(rq.
104 is also useful in back\-quoted operations:
119 .ta \w'%etcdir%/ExtraBigFileName 'u
120 ^$HOME/\&.mh\(ruprofile~^The user profile
123 .SH "PROFILE COMPONENTS"
127 .ta \w'ExtraBigProfileName 'u
128 ^Path:~^To determine the user's nmh directory
129 ^Current\-Folder:~^To find the default current folder
137 .RB ` +folder "' defaults to the current folder"
138 .RB ` msgs "' defaults to none"
161 Quite the reverse. But
165 mv `mhpath 501` `mhpath 500`
171 Out of range message 0 is treated far more severely than large out of
172 range message numbers.