annotate conf/doc/mh-profile.rf @ 12:441a2190cfae

Lion fix
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Sat, 21 Apr 2012 13:10:49 +0900
parents bce86c4163a3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1 .\" @(MHWARNING)
12
441a2190cfae Lion fix
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 0
diff changeset
2 .\" @(#)$Id: mh-profile.rf,v 1.1.1.1 2005/04/18 14:46:03 kono Exp $
0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
3 .SC MH-PROFILE 5
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 mh-profile \- user profile customization for MH message handler
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 \&\fI.mh\(ruprofile\fP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 .DE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9 Each user of \fIMH\fR is expected to have a file named \fI\&.mh\(ruprofile\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 in his or her home directory. This file contains a set of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 user parameters used by some or all of the \fIMH\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 family of programs. Each entry in the file is of the format
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14 \fIprofile\-component\fR: \fIvalue\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 If the text of an entry extends across several
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 real lines, the continuation lines are indicated by leading
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 spaces or tabs.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 The possible profile components are exemplified below.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20 Only `Path:' is mandatory.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 The others are optional;
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 some have default values if they are not present.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 In the notation used below,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 (profile, default) indicates whether the information is kept in the user's
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25 \fIMH\fR profile or \fIMH\fR context,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 and indicates what the default value is.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 .in +1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30 Path: Mail
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 Locates \fIMH\fR transactions in directory \*(lqMail\*(rq.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 context: context
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38 Declares the location of the \fIMH\fR context file,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 see the \fBHISTORY\fR section below.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40 (profile, default: <mh\-dir>/context)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43 Current\-Folder:\ inbox
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45 Keeps track of the current open folder.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 (context, default: folder specified by \*(lqInbox\*(rq)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49 Inbox: inbox
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51 Defines the name of your inbox.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52 (profile, default: inbox)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55 Previous\-Sequence:\ pseq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 Names the sequences which should be defined as the `msgs' or `msg'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 argument given to the program.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 If not present, or empty, no sequences are defined.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 Otherwise,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 for each name given,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62 the sequence is first zero'd and then each message is added to the sequence.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64
bce86c4163a3 Initial revision
kono
parents:
diff changeset
65 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
66 Sequence\-Negation:\ not
bce86c4163a3 Initial revision
kono
parents:
diff changeset
67 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
68 Defines the string which, when prefixed to a sequence name,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69 negates that sequence.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70 Hence,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71 \*(lqnotseen\*(rq means all those messages that are not a member of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72 the sequence \*(lqseen\*(rq.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
73 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
74
bce86c4163a3 Initial revision
kono
parents:
diff changeset
75 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
76 Unseen\-Sequence:\ unseen
bce86c4163a3 Initial revision
kono
parents:
diff changeset
77 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
78 Names the sequences which should be defined as those messages recently
bce86c4163a3 Initial revision
kono
parents:
diff changeset
79 incorporated by \fIinc\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
80 \fIShow\fR knows to remove messages from this sequence once it thinks they
bce86c4163a3 Initial revision
kono
parents:
diff changeset
81 have been seen.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
82 If not present, or empty, no sequences are defined.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
83 Otherwise,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
84 each message is added to each sequence name given.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
85 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
86
bce86c4163a3 Initial revision
kono
parents:
diff changeset
87 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
88 mh\-sequences:\ \&.mh\(rusequences
bce86c4163a3 Initial revision
kono
parents:
diff changeset
89 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
90 The name of the file in each folder which defines public sequences.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
91 To disable the use of public sequences,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
92 leave the value portion of this entry blank.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
93 (profile, default: \&.mh\(rusequences)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
94
bce86c4163a3 Initial revision
kono
parents:
diff changeset
95 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
96 atr\-\fIseq\fR\-\fIfolder\fR:\ 172\0178\-181\0212
bce86c4163a3 Initial revision
kono
parents:
diff changeset
97 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
98 Keeps track of the private sequence called \fIseq\fR in the specified folder.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
99 (context, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
100
bce86c4163a3 Initial revision
kono
parents:
diff changeset
101 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
102 Editor:\ /usr/ucb/ex
bce86c4163a3 Initial revision
kono
parents:
diff changeset
103 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
104 Defines editor to be used by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
105 \fIcomp\fR\0(1), \fIdist\fR\0(1), \fIforw\fR\0(1), and \fIrepl\fR\0(1).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
106 (profile, default: @(MHEDITOR))
bce86c4163a3 Initial revision
kono
parents:
diff changeset
107
bce86c4163a3 Initial revision
kono
parents:
diff changeset
108 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
109 Msg\-Protect:\ 644
bce86c4163a3 Initial revision
kono
parents:
diff changeset
110 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
111 Defines octal protection bits for message files.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
112 See \fIchmod\fR\0(1) for an explanation of the octal number.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
113 (profile, default: 0644)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
114
bce86c4163a3 Initial revision
kono
parents:
diff changeset
115 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
116 Folder\-Protect:\ 711
bce86c4163a3 Initial revision
kono
parents:
diff changeset
117 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
118 Defines protection bits for folder directories.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
119 (profile, default: 0711)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
120
bce86c4163a3 Initial revision
kono
parents:
diff changeset
121 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
122 \fIprogram\fR:\ default switches
bce86c4163a3 Initial revision
kono
parents:
diff changeset
123 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
124 Sets default switches to be used whenever the mh program
bce86c4163a3 Initial revision
kono
parents:
diff changeset
125 \fIprogram\fR is invoked.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
126 For example, one could override the \fIEditor\fR:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
127 profile component when replying to messages by adding a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
128 component such as:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
129 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
130 repl: \-editor /bin/ed
bce86c4163a3 Initial revision
kono
parents:
diff changeset
131 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
132 (profile, no defaults)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
133
bce86c4163a3 Initial revision
kono
parents:
diff changeset
134 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
135 \fIlasteditor\fR\-next:\ nexteditor
bce86c4163a3 Initial revision
kono
parents:
diff changeset
136 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
137 Names \*(lqnexteditor\*(rq to be the default editor after using \*(lqlasteditor\*(rq.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
138 This takes effect at \*(lqWhat now?\*(rq level in
bce86c4163a3 Initial revision
kono
parents:
diff changeset
139 \fIcomp\fR, \fIdist\fR, \fIforw\fR, and \fIrepl\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
140 After editing the draft with \*(lqlasteditor\*(rq,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
141 the default editor is set to be \*(lqnexteditor\*(rq.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
142 If the user types \*(lqedit\*(rq without any arguments to \*(lqWhat now?\*(rq,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
143 then \*(lqnexteditor\*(rq is used.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
144 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
145
bce86c4163a3 Initial revision
kono
parents:
diff changeset
146 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
147 bboards: system
bce86c4163a3 Initial revision
kono
parents:
diff changeset
148 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
149 Tells \fIbbc\fR which BBoards you are interested in.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
150 (profile, default: system)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
151
bce86c4163a3 Initial revision
kono
parents:
diff changeset
152 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
153 Folder\-Stack: \fIfolders\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
154 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
155 The contents of the folder-stack for the \fIfolder\fR command.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
156 (context, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
157
bce86c4163a3 Initial revision
kono
parents:
diff changeset
158 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
159 mhe:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
160 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
161 If present, tells \fIinc\fR to compose an \fIMHE\fR auditfile in addition to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
162 its other tasks.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
163 \fIMHE\fR is Brian Reid's \fIEmacs\fR front-end for \fIMH\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
164 An early version is supplied with the \fImh.6\fR distribution.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
165 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
166
bce86c4163a3 Initial revision
kono
parents:
diff changeset
167 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
168 Alternate\-Mailboxes: mh@uci\-750a, bug-mh*
bce86c4163a3 Initial revision
kono
parents:
diff changeset
169 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
170 Tells \fIrepl\fR and \fIscan\fR which addresses are really yours.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
171 In this way, \fIrepl\fR knows which addresses should be included in the reply,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
172 and \fIscan\fR knows if the message really originated from you.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
173 Addresses must be separated by a comma,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
174 and the hostnames listed should be the \*(lqofficial\*(rq hostnames for the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
175 mailboxes you indicate,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
176 as local nicknames for hosts are not replaced with their official site names.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
177 For each address,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
178 if a host is not given,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
179 then that address on any host is considered to be you.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
180 In addition,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
181 an asterisk (`*') may appear at either or both ends of the mailbox and host
bce86c4163a3 Initial revision
kono
parents:
diff changeset
182 to indicate wild-card matching.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
183 (profile, default: your user-id)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
184
bce86c4163a3 Initial revision
kono
parents:
diff changeset
185 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
186 Aliasfile: aliases other-alias
bce86c4163a3 Initial revision
kono
parents:
diff changeset
187 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
188 Indicates aliases files for \fIali\fR, \fIwhom\fR, and \fIsend\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
189 This may be used instead of the `\-alias file' switch.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
190 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
191
bce86c4163a3 Initial revision
kono
parents:
diff changeset
192 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
193 Draft\-Folder: drafts
bce86c4163a3 Initial revision
kono
parents:
diff changeset
194 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
195 Indicates a default draft folder for \fIcomp\fR, \fIdist\fR, \fIforw\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
196 and \fIrepl\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
197 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
198
bce86c4163a3 Initial revision
kono
parents:
diff changeset
199 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
200 digest\-issue\-\fIlist\fR:\ 1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
201 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
202 Tells \fIforw\fR the last issue of the last volume sent for the digest
bce86c4163a3 Initial revision
kono
parents:
diff changeset
203 \fIlist\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
204 (context, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
205
bce86c4163a3 Initial revision
kono
parents:
diff changeset
206 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
207 digest\-volume\-\fIlist\fR:\ 1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
208 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
209 Tells \fIforw\fR the last volume sent for the digest \fIlist\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
210 (context, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
211
bce86c4163a3 Initial revision
kono
parents:
diff changeset
212 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
213 MailDrop: .mail
bce86c4163a3 Initial revision
kono
parents:
diff changeset
214 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
215 Tells \fIinc\fR your maildrop, if different from the default.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
216 This is superceded by the \fBMAILDROP\fR envariable.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
217 (profile, default: @(MHDROPLOC))
bce86c4163a3 Initial revision
kono
parents:
diff changeset
218
bce86c4163a3 Initial revision
kono
parents:
diff changeset
219 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
220 Signature: RAND MH System (agent: Marshall Rose)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
221 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
222 Tells \fIsend\fR your mail signature.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
223 This is superceded by the \fBSIGNATURE\fR envariable.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
224 If \fBSIGNATURE\fR is not set and this profile entry is not present,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
225 the \*(lqgcos\*(rq field of the \fI/etc/passwd\fP file will be used;
bce86c4163a3 Initial revision
kono
parents:
diff changeset
226 otherwise,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
227 on hosts where \fIMH\fR was configured with the UCI option,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
228 the file $HOME/.signature is consulted.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
229 Your signature will be added to the address \fIsend\fP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
230 puts in the \*(lqFrom:\*(rq header;
bce86c4163a3 Initial revision
kono
parents:
diff changeset
231 do not include an address in the signature text.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
232 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
233 @BEGIN: MH_PLUS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
234
bce86c4163a3 Initial revision
kono
parents:
diff changeset
235 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
236 Sendername: username
bce86c4163a3 Initial revision
kono
parents:
diff changeset
237 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
238 Tells \fIsend\fR your user name on SMTP server,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
239 if \*(lqLocalUser\*(rq in \fI@(MHETCPATH)/mtstailor\fR is valid.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
240 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
241
bce86c4163a3 Initial revision
kono
parents:
diff changeset
242 .ti -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
243 From-Address: mh@uci\-750a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
244 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
245 Tells \fIsend\fR your mail address.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
246 This will become the address \fIsend\fP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
247 puts in the \*(lqFrom:\*(rq header;
bce86c4163a3 Initial revision
kono
parents:
diff changeset
248 do not include anything except address(FQDN) in the from text.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
249 (profile, no default)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
250 @END: MH_PLUS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
251 .in -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
252
bce86c4163a3 Initial revision
kono
parents:
diff changeset
253 The following profile elements are used whenever an \fIMH\fR program
bce86c4163a3 Initial revision
kono
parents:
diff changeset
254 invokes some other program such as \fImore\fR\0(1).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
255 The \fI\&.mh\(ruprofile\fR can be used to select alternate
bce86c4163a3 Initial revision
kono
parents:
diff changeset
256 programs if the user wishes. The default values are given in
bce86c4163a3 Initial revision
kono
parents:
diff changeset
257 the examples.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
258
bce86c4163a3 Initial revision
kono
parents:
diff changeset
259 .nf
bce86c4163a3 Initial revision
kono
parents:
diff changeset
260 .in +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
261 .ta \w'whatnowproc: 'u
bce86c4163a3 Initial revision
kono
parents:
diff changeset
262 ^fileproc:~^@(MHBINPATH)/refile
bce86c4163a3 Initial revision
kono
parents:
diff changeset
263 ^incproc:~^@(MHBINPATH)/inc
bce86c4163a3 Initial revision
kono
parents:
diff changeset
264 ^installproc:~^@(MHETCPATH)/install\-mh
bce86c4163a3 Initial revision
kono
parents:
diff changeset
265 ^lproc:~^/usr/ucb/more
bce86c4163a3 Initial revision
kono
parents:
diff changeset
266 ^mailproc:~^@(MHBINPATH)/mhmail
bce86c4163a3 Initial revision
kono
parents:
diff changeset
267 ^mhlproc:~^@(MHETCPATH)/mhl
bce86c4163a3 Initial revision
kono
parents:
diff changeset
268 ^moreproc:~^/usr/ucb/more
bce86c4163a3 Initial revision
kono
parents:
diff changeset
269 ^mshproc:~^@(MHBINPATH)/msh
bce86c4163a3 Initial revision
kono
parents:
diff changeset
270 ^packproc:~^@(MHBINPATH)/packf
bce86c4163a3 Initial revision
kono
parents:
diff changeset
271 ^postproc:~^@(MHETCPATH)/post
bce86c4163a3 Initial revision
kono
parents:
diff changeset
272 ^rmmproc:~^none
bce86c4163a3 Initial revision
kono
parents:
diff changeset
273 ^rmfproc:~^@(MHBINPATH)/rmf
bce86c4163a3 Initial revision
kono
parents:
diff changeset
274 ^sendproc:~^@(MHBINPATH)/send
bce86c4163a3 Initial revision
kono
parents:
diff changeset
275 ^showproc:~^/usr/ucb/more
bce86c4163a3 Initial revision
kono
parents:
diff changeset
276 ^whatnowproc:~^@(MHBINPATH)/whatnow
bce86c4163a3 Initial revision
kono
parents:
diff changeset
277 ^whomproc:~^@(MHBINPATH)/whom
bce86c4163a3 Initial revision
kono
parents:
diff changeset
278 .re
bce86c4163a3 Initial revision
kono
parents:
diff changeset
279 .in -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
280 .fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
281
bce86c4163a3 Initial revision
kono
parents:
diff changeset
282 If you define the envariable \fBMH\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
283 you can specify a profile other than \fI\&.mh\(ruprofile\fR to be read
bce86c4163a3 Initial revision
kono
parents:
diff changeset
284 by the \fIMH\fR programs that you invoke.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
285 If the value of \fBMH\fR is not absolute,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
286 (i.e., does not begin with a \fB/\fR\0),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
287 it will be presumed to start from the current working directory.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
288 This is one of the very few exceptions in \fIMH\fR where non-absolute
bce86c4163a3 Initial revision
kono
parents:
diff changeset
289 pathnames are not considered relative to the user's \fIMH\fR directory.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
290
bce86c4163a3 Initial revision
kono
parents:
diff changeset
291 Similarly,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
292 if you define the envariable \fBMHCONTEXT\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
293 you can specify a context other than the normal context file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
294 (as specified in the \fIMH\fR profile).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
295 As always,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
296 unless the value of \fBMHCONTEXT\fR is absolute,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
297 it will be presumed to start from your \fIMH\fR directory.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
298
bce86c4163a3 Initial revision
kono
parents:
diff changeset
299 \fIMH\fR programs also support other envariables:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
300
bce86c4163a3 Initial revision
kono
parents:
diff changeset
301 .in +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
302 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
303 \fBMAILDROP\fR\0: tells \fIinc\fR the default maildrop
bce86c4163a3 Initial revision
kono
parents:
diff changeset
304 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
305 This supercedes the \*(lqMailDrop:\*(rq profile entry.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
306
bce86c4163a3 Initial revision
kono
parents:
diff changeset
307 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
308 \fBSIGNATURE\fR\0: tells \fIsend\fR and \fIpost\fR your mail signature
bce86c4163a3 Initial revision
kono
parents:
diff changeset
309 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
310 This supercedes the \*(lqSignature:\*(rq profile entry.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
311
bce86c4163a3 Initial revision
kono
parents:
diff changeset
312 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
313 \fBHOME\fR\0: tells all \fIMH\fR programs your home directory
bce86c4163a3 Initial revision
kono
parents:
diff changeset
314
bce86c4163a3 Initial revision
kono
parents:
diff changeset
315 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
316 \fBSHELL\fR\0: tells \fIbbl\fR the default shell to run
bce86c4163a3 Initial revision
kono
parents:
diff changeset
317
bce86c4163a3 Initial revision
kono
parents:
diff changeset
318 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
319 \fBTERM\fR\0: tells \fIMH\fR your terminal type
bce86c4163a3 Initial revision
kono
parents:
diff changeset
320 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
321 The \fBTERMCAP\fR envariable is also consulted.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
322 In particular,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
323 these tell \fIscan\fR and \fImhl\fR how to clear your terminal,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
324 and how many columns wide your terminal is.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
325 They also tell \fImhl\fR how many lines long your terminal screen is.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
326
bce86c4163a3 Initial revision
kono
parents:
diff changeset
327 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
328 \fBeditalt\fR\0: the alternate message
bce86c4163a3 Initial revision
kono
parents:
diff changeset
329 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
330 This is set by \fIdist\fR and \fIrepl\fR during edit sessions
bce86c4163a3 Initial revision
kono
parents:
diff changeset
331 so you can peruse the message being distributed or replied to.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
332 The message is also available through a link called \*(lq@\*(rq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
333 in the current directory if your current working directory and
bce86c4163a3 Initial revision
kono
parents:
diff changeset
334 the folder the message lives in are on the same UNIX filesystem.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
335
bce86c4163a3 Initial revision
kono
parents:
diff changeset
336 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
337 \fBmhdraft\fR\0: the path to the working draft
bce86c4163a3 Initial revision
kono
parents:
diff changeset
338 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
339 This is set by \fIcomp\fR, \fIdist\fR, \fIforw\fR, and \fIrepl\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
340 to tell the \fIwhatnowproc\fR which file to ask \*(lqWhat now?\*(rq questions
bce86c4163a3 Initial revision
kono
parents:
diff changeset
341 about.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
342 In addition,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
343 \fIdist\fR, \fIforw\fR, and \fIrepl\fR set \fBmhfolder\fR if appropriate.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
344 Further,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
345 \fIdist\fR and \fIrepl\fR set \fBmhaltmsg\fR to tell the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
346 \fIwhatnowproc\fR about an alternate message associated with the draft
bce86c4163a3 Initial revision
kono
parents:
diff changeset
347 (the message being distributed or replied to),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
348 and
bce86c4163a3 Initial revision
kono
parents:
diff changeset
349 \fIdist\fR sets \fBmhdist\fR to tell the \fIwhatnowproc\fR that
bce86c4163a3 Initial revision
kono
parents:
diff changeset
350 message re-distribution is occurring.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
351 Also,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
352 \fBmheditor\fR is set to tell the \fIwhatnowproc\fR the user's choice of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
353 editor (unless overridden by `\-noedit').
bce86c4163a3 Initial revision
kono
parents:
diff changeset
354 Similarly,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
355 \fBmhuse\fR may be set by \fIcomp\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
356 Finally,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
357 \fBmhmessages\fR is set by \fIdist\fR, \fIforw\fR, and \fIrepl\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
358 if annotations are to occur
bce86c4163a3 Initial revision
kono
parents:
diff changeset
359 (along with \fBmhannotate\fR, and \fBmhinplace\fR).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
360 It's amazing all the information that has to get passed via envariables to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
361 make the \*(lqWhat now?\*(rq interface look squeaky clean to the \fIMH\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
362 user, isn't it?
bce86c4163a3 Initial revision
kono
parents:
diff changeset
363 The reason for all this
bce86c4163a3 Initial revision
kono
parents:
diff changeset
364 is that the \fIMH\fR user can select \fIany\fR program as the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
365 \fIwhatnowproc\fR, including one of the standard shells.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
366 As a result, it's not possible to pass information via an argument list.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
367 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
368 If the WHATNOW option was set during \fIMH\fR configuration
bce86c4163a3 Initial revision
kono
parents:
diff changeset
369 (type `\-help' to an \fIMH\fR command to find out),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
370 and if this envariable is set,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
371 if the commands \fIrefile\fR, \fIsend\fR, \fIshow\fR, or \fIwhom\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
372 are not given any `msgs' arguments,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
373 then they will default to using the file indicated by \fBmhdraft\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
374 This is useful for getting the default behavior supplied by the default
bce86c4163a3 Initial revision
kono
parents:
diff changeset
375 \fIwhatnowproc\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
376
bce86c4163a3 Initial revision
kono
parents:
diff changeset
377 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
378 \fBmhfolder\fR\0: the folder containing the alternate message
bce86c4163a3 Initial revision
kono
parents:
diff changeset
379 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
380 This is set by \fIdist\fR and \fIrepl\fR during edit sessions
bce86c4163a3 Initial revision
kono
parents:
diff changeset
381 so you can peruse other messages in the current folder
bce86c4163a3 Initial revision
kono
parents:
diff changeset
382 besides the one being distributed or replied to.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
383 The \fBmhfolder\fR envariable is also
bce86c4163a3 Initial revision
kono
parents:
diff changeset
384 set by \fIshow\fR, \fIprev\fR, and \fInext\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
385 for use by \fImhl\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
386
bce86c4163a3 Initial revision
kono
parents:
diff changeset
387 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
388 \fBMHBBRC\fR\0:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
389 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
390 If you define the envariable \fBMHBBRC\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
391 you can specify a BBoards information file other than \fI\&.bbrc\fR to be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
392 read by \fIbbc\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
393 If the value of \fBMHBBRC\fR is not absolute,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
394 (i.e., does not begin with a \fB/\fR\0),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
395 it will be presumed to start from the current working directory.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
396
bce86c4163a3 Initial revision
kono
parents:
diff changeset
397 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
398 \fBMHFD\fR\0:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
399 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
400 If the OVERHEAD option was set during \fIMH\fR configuration
bce86c4163a3 Initial revision
kono
parents:
diff changeset
401 (type `\-help' to an \fIMH\fR command to find out),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
402 then if this envariable is set,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
403 \fIMH\fR considers it to be the number of a file descriptor which is opened,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
404 read-only to the \fIMH\fR profile.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
405 Similarly,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
406 if the envariable \fBMHCONTEXTFD\fR is set,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
407 this is the number of a file descriptor which is opened read-only
bce86c4163a3 Initial revision
kono
parents:
diff changeset
408 to the \fIMH\fR context.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
409 This feature of \fIMH\fR is experimental,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
410 and is used to examine possible speed improvements for \fIMH\fR startup.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
411 Note that these envariables must be set and non-empty to enable this feature.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
412 However,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
413 if OVERHEAD is enabled during \fIMH\fR configuration,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
414 then when \fIMH\fR programs call other \fIMH\fR programs,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
415 this scheme is used.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
416 These file descriptors are not closed throughout the execution of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
417 \fIMH\fR program,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
418 so children may take advantage of this.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
419 This approach is thought to be completely safe and does result in some
bce86c4163a3 Initial revision
kono
parents:
diff changeset
420 performance enhancements.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
421 .in -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
422
bce86c4163a3 Initial revision
kono
parents:
diff changeset
423 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
424 ^$HOME/\&.mh\(ruprofile~^The user profile
bce86c4163a3 Initial revision
kono
parents:
diff changeset
425 ^or $MH~^Rather than the standard profile
bce86c4163a3 Initial revision
kono
parents:
diff changeset
426 ^<mh\-dir>/context~^The user context
bce86c4163a3 Initial revision
kono
parents:
diff changeset
427 ^or $CONTEXT~^Rather than the standard context
bce86c4163a3 Initial revision
kono
parents:
diff changeset
428 ^<folder>/\&.mh\(rusequences~^Public sequences for <folder>
bce86c4163a3 Initial revision
kono
parents:
diff changeset
429 .Pr
bce86c4163a3 Initial revision
kono
parents:
diff changeset
430 All
bce86c4163a3 Initial revision
kono
parents:
diff changeset
431 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
432 mh(1), environ(5), mh-sequence(5)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
433 .De
bce86c4163a3 Initial revision
kono
parents:
diff changeset
434 None
bce86c4163a3 Initial revision
kono
parents:
diff changeset
435 .Co
bce86c4163a3 Initial revision
kono
parents:
diff changeset
436 All
bce86c4163a3 Initial revision
kono
parents:
diff changeset
437 .Hi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
438 In previous versions of \fIMH\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
439 the current-message value of a writable folder was kept in a file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
440 called \*(lqcur\*(rq in the folder itself.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
441 In \fImh.3\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
442 the \fI\&.mh\(ruprofile\fR contained the current-message values for
bce86c4163a3 Initial revision
kono
parents:
diff changeset
443 all folders, regardless of their writability.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
444
bce86c4163a3 Initial revision
kono
parents:
diff changeset
445 In all versions of \fIMH\fR since \fImh.4\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
446 the \fI\&.mh\(ruprofile\fR contains only static information,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
447 which \fIMH\fR programs will \fBNOT\fR update.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
448 Changes in context are made to the \fIcontext\fR file kept in the users MH
bce86c4163a3 Initial revision
kono
parents:
diff changeset
449 \fIdirectory\fR.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
450 This includes, but is not limited to:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
451 the \*(lqCurrent\-Folder\*(rq entry and all private sequence information.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
452 Public sequence information is kept in a file called \fI\&.mh\(rusequences\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
453 in each folder.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
454
bce86c4163a3 Initial revision
kono
parents:
diff changeset
455 To convert from the format used in releases of \fIMH\fR prior
bce86c4163a3 Initial revision
kono
parents:
diff changeset
456 to the format used in the \fImh.4\fR release,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
457 \fIinstall\-mh\fR should be invoked with the `\-compat' switch.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
458 This generally happens automatically on \fIMH\fR systems generated with the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
459 \*(lqCOMPAT\*(rq option during \fIMH\fR configuration.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
460
bce86c4163a3 Initial revision
kono
parents:
diff changeset
461 The \fI\&.mh\(ruprofile\fR may override the path of the \fIcontext\fR file,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
462 by specifying a \*(lqcontext\*(rq entry (this must be in lower-case).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
463 If the entry is not absolute (does not start with a \fB/\fR\0),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
464 then it is interpreted relative to the user's \fIMH\fR directory.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
465 As a result,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
466 you can actually have more than one set of private sequences by using
bce86c4163a3 Initial revision
kono
parents:
diff changeset
467 different context files.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
468 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
469 The shell quoting conventions are not available in the \&.mh\(ruprofile.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
470 Each token is separated by whitespace.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
471
bce86c4163a3 Initial revision
kono
parents:
diff changeset
472 There is some question as to what kind of arguments should be placed in
bce86c4163a3 Initial revision
kono
parents:
diff changeset
473 the profile as options.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
474 In order to provide a clear answer,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
475 recall command line semantics of all \fIMH\fR programs:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
476 conflicting switches (e.g., `\-header and `\-noheader')
bce86c4163a3 Initial revision
kono
parents:
diff changeset
477 may occur more than one time on the command line,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
478 with the last switch taking effect.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
479 Other arguments,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
480 such as message sequences, filenames and folders,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
481 are always remembered on the invocation line and are not superseded by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
482 following arguments of the same type.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
483 Hence, it is safe to place only switches (and their arguments)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
484 in the profile.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
485
bce86c4163a3 Initial revision
kono
parents:
diff changeset
486 If one finds that an \fIMH\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
487 program is being invoked again and again with the same arguments,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
488 and those arguments aren't switches,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
489 then there are a few possible solutions to this problem.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
490 The first is to create a (soft) link in your \fI$HOME/bin\fR directory
bce86c4163a3 Initial revision
kono
parents:
diff changeset
491 to the \fIMH\fR program of your choice.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
492 By giving this link a different name,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
493 you can create a new entry in your profile
bce86c4163a3 Initial revision
kono
parents:
diff changeset
494 and use an alternate set of defaults for the \fIMH\fR command.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
495 Similarly, you could create a small shell script which called the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
496 \fIMH\fR program of your choice with an alternate set of invocation
bce86c4163a3 Initial revision
kono
parents:
diff changeset
497 line switches (using links and an alternate profile entry is preferable
bce86c4163a3 Initial revision
kono
parents:
diff changeset
498 to this solution).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
499
bce86c4163a3 Initial revision
kono
parents:
diff changeset
500 Finally, the \fIcsh\fR user could create an alias for the command of the form:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
501
bce86c4163a3 Initial revision
kono
parents:
diff changeset
502 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
503 alias cmd 'cmd arg1 arg2 ...'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
504
bce86c4163a3 Initial revision
kono
parents:
diff changeset
505 In this way, the user can avoid lengthy type-in to the shell,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
506 and still give \fIMH\fR commands safely. (Recall that some \fIMH\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
507 commands invoke others, and that in all cases, the profile is read,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
508 meaning that aliases are disregarded beyond an initial command invocation)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
509 .En