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