![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mhpath.me CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh|
Return to mhpath.me CVS log | Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh |
1.1 root 1: .\" This file is automatically generated. Do not edit!
2: .SC MHPATH 1
3: .NA
4: mhpath \- print full pathnames of MH messages and folders
5: .SY
6: mhpath
7: \%[+folder] \%[msgs]
8: \%[\-help]
9: .DE
10: \fIMhpath\fR expands and sorts the message list `msgs' and writes
11: the full pathnames of the messages to the standard output
12: separated by newlines.
13: If no `msgs' are specified,
14: \fImhpath\fR outputs the folder pathname instead.
15:
16: Contrasted with other MH commands, a message argument to \fImhpath\fR
17: may often be intended for \fIwriting\fR.
18: Because of this:
19: 1) the name \*(lqnew\*(rq has been added to \fImhpath\fR's list of
20: reserved message names
21: (the others are \*(lqfirst\*(rq, \*(lqlast\*(rq, \*(lqprev\*(rq,
22: \*(lqnext\*(rq, \*(lqcur\*(rq, and \*(lqall\*(rq).
23: The new message is equivalent to the message after the
24: last message in a folder
25: (and equivalent to 1 in a folder without messages).
26: The \*(lqnew\*(rq message may not be used as part of a message range.
27: 2) Within a message list,
28: the following designations may refer to messages that do not exist:
29: a single numeric message name,
30: the single message name \*(lqcur\*(rq,
31: and (obviously) the single message name \*(lqnew\*(rq.
32: All other message designations must refer to at least one existing message.
33: 3) An empty folder is not in itself an error.
34:
35: Message numbers greater than the highest existing message in a folder as
36: part of a range designation are replaced with the next free message number.
37:
38: Examples: The current folder foo contains messages 3 5 6.
39: Cur is 4.
40:
41: .nf
42: .in +.5i
43: % mhpath
44: /r/phyl/Mail/foo
45:
46: % mhpath all
47: /r/phyl/Mail/foo/3
48: /r/phyl/Mail/foo/5
49: /r/phyl/Mail/foo/6
50:
51: % mhpath 2001
52: /r/phyl/Mail/foo/7
53:
54: % mhpath 1\-2001
55: /r/phyl/Mail/foo/3
56: /r/phyl/Mail/foo/5
57: /r/phyl/Mail/foo/6
58:
59: % mhpath new
60: /r/phyl/Mail/foo/7
61:
62: % mhpath last new
63: /r/phyl/Mail/foo/6
64: /r/phyl/Mail/foo/7
65:
66: % mhpath last\-new
67: bad message list \*(lqlast\-new\*(rq.
68:
69: % mhpath cur
70: /r/phyl/Mail/foo/4
71:
72: % mhpath 1\-2
73: no messages in range \*(lq1\-2\*(rq.
74:
75: % mhpath first:2
76: /r/phyl/Mail/foo/3
77: /r/phyl/Mail/foo/5
78:
79: % mhpath 1 2
80: /r/phyl/Mail/foo/1
81: /r/phyl/Mail/foo/2
82: .in -.5i
83: .fi
84:
85: \fIMHpath\fR is also useful in back\-quoted operations:
86:
87: .nf
88: .in +.5i
89: % cd `mhpath +inbox`
90:
91: % echo `mhpath +`
92: /r/phyl/Mail
93: .in -.5i
94: .fi
95: .Fi
96: ^$HOME/\&.mh\(ruprofile~^The user profile
97: .Pr
98: ^Path:~^To determine the user's MH directory
99: .Ps
100: ^Current\-Folder:~^To find the default current folder
101: .Sa
102: folder(1)
103: .De
104: `+folder' defaults to the current folder
105: .Ds
106: `msgs' defaults to none
107: .Co
108: None
109: .Bu
110: Like all MH commands, \fImhpath\fR expands and sorts \%[msgs].
111: So don't expect
112:
113: .ti +.5i
114: mv `mhpath 501 500`
115:
116: to move 501 to 500.
117: Quite the reverse. But
118:
119: .ti +.5i
120: mv `mhpath 501` `mhpath 500`
121:
122: will do the trick.
123:
124: Out of range message 0 is treated far more severely than large out of
125: range message numbers.
126: .En
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.