8 date 93.08.20.00.04.30; author jromine; state Exp;
13 date 93.08.19.21.21.01; author jromine; state Exp;
18 date 92.02.12.00.23.13; author jromine; state Exp;
23 date 90.12.26.17.03.28; author mh; state Exp;
28 date 90.04.05.15.12.51; author sources; state Exp;
33 date 90.03.22.11.31.10; author sources; state Exp;
38 date 90.03.20.19.41.49; author sources; state Exp;
43 date 90.03.20.17.36.05; author sources; state Exp;
48 date 90.03.20.17.20.51; author sources; state Exp;
63 .\" @@(#)$Id: mark.rf,v 1.8 1993/08/19 21:21:01 jromine Exp jromine $
70 \%[\-sequence\ name\ ...]
71 \%[\-add] \%[\-delete] \%[\-list]
72 \%[\-public] \%[\-nopublic]
73 \%[\-zero] \%[\-nozero]
76 The \fImark\fR command manipulates message sequences by adding or
77 deleting message numbers from folder\-specific message sequences,
78 or by listing those sequences and messages.
79 A message sequence is a keyword, just like one of the
80 \*(lqreserved\*(rq message names,
81 such as \*(lqfirst\*(rq or \*(lqnext\*(rq.
82 Unlike the \*(lqreserved\*(rq message names,
83 which have a fixed semantics on a per\-folder basis,
84 the semantics of a message sequence may be defined, modified, and
86 Message sequences are folder\-specific, e.g.,
87 the sequence name \*(lqseen\*(rq in the context of folder \*(lq+inbox\*(rq
88 need not have any relation whatsoever to the sequence of the same name
89 in a folder of a different name.
91 Three action switches direct the operation of \fImark\fR.
92 These switches are mutually exclusive:
93 the last occurrence of any of them overrides any previous occurrence of the
96 The `\-add' switch tells \fImark\fR to add messages to sequences
97 or to create a new sequence.
98 For each sequence named via the `\-sequence\ name' argument
99 (which must occur at least once)
100 the messages named via `msgs'
101 (which defaults to \*(lqcur\*(rq if no `msgs' are given),
102 are added to the sequence.
103 The messages to be added need not be absent from the sequence.
104 If the `\-zero' switch is specified,
105 the sequence will be emptied prior to adding the messages.
106 Hence, `\-add\ \-zero' means that each sequence should be initialized
107 to the indicated messages,
108 while `\-add\ \-nozero' means that each sequence should be appended to
109 by the indicated messages.
111 The `\-delete' switch tells \fImark\fR to delete messages from
112 sequences, and is the dual of `\-add'.
113 For each of the named sequences,
114 the named messages are removed from the sequence.
115 These messages need not be already present in the sequence.
116 If the `\-zero' switch is specified,
117 then all messages in the folder are appended to the sequence prior to
118 removing the messages.
119 Hence, `\-delete\ \-zero' means that each sequence should contain all
120 messages except those indicated,
121 while `\-delete\ \-nozero' means that only the indicated messages
122 should be removed from each sequence.
123 As expected, the command `mark\0\-sequence\0seen\0\-delete\0all'
124 deletes the sequence \*(lqseen\*(rq from the current folder.
126 When creating (or modifying) a sequence,
127 the `\-public' switch indicates that the sequence should be made readable
128 for other \fIMH\fR users.
129 In contrast, the `\-nopublic' switch indicates that the sequence should be
130 private to the user's \fIMH\fR environment.
132 The `\-list' switch tells \fImark\fR to list both the sequences defined
133 for the folder and the messages associated with those sequences.
134 \fIMark\fR will list the name of each sequence given by
135 `\-sequence\ name' and the messages associated with that sequence.
136 If `\-sequence' isn't used, all sequences will be listed,
137 with private sequences being so indicated.
138 The `\-zero' switch does not affect the operation of `\-list'.
140 The current restrictions on sequences are:
143 The name used to denote a message sequence must consist of
144 an alphabetic character followed by zero or more
145 alphanumeric characters, and cannot be one of the (reserved)
146 message names \*(lqnew\*(rq, \*(lqfirst\*(rq,
147 \*(lqlast\*(rq, \*(lqall\*(rq, \*(lqnext\*(rq, or \*(lqprev\*(rq.
149 Only a certain number of sequences may be defined for a given folder.
150 This number is usually limited to 26 (10 on small systems).
152 Message ranges with user\-defined
153 sequence names are restricted to the form \*(lqname:n\*(rq or
154 \*(lqname:-n\*(rq, and refer to the first or last `n' messages
155 of the sequence `name', respectively.
156 Constructs of the form \*(lqname1\-name2\*(rq are forbidden.
159 ^$HOME/\&.mh\(ruprofile~^The user profile
161 ^Path:~^To determine the user's MH directory
163 ^Current\-Folder:~^To find the default current folder
165 pick (1), mh-sequence (5)
167 `+folder' defaults to the current folder
169 `\-add' if `\-sequence' is specified, `\-list' otherwise
171 `msgs' defaults to cur (or all if `\-list' is specified)
173 `\-nopublic' if the folder is read\-only, `\-public' otherwise
177 If a folder is given, it will become the current folder.
179 Use \*(lqpick sequence \-list\*(rq
180 to enumerate the messages in a sequence (such as for use
188 @list reserved message sequence names
193 .\" @@(#)$Id: mark.rf,v 1.7 1992/02/12 00:23:13 jromine Exp jromine $
196 alphanumeric characters, and cannot be one of the reserved
197 message names (\*(lqnew\*(rq, \*(lqall\*(rq, \*(lqfirst\*(rq,
198 \*(lqlast\*(rq, \*(lqnext\*(rq, and \*(lqprev\*(rq).
209 .\" @@(#)$Id: mark.rf,v 1.6 1990/12/26 17:03:28 mh Exp jromine $
212 alphanumeric characters, and can not be one of the \*(lqreserved\*(rq
214 (e.g., \*(lqfirst\*(rq, \*(lqcur\*(rq, and so forth).
220 @document user-defined sequence ranges
226 .\" @@(#)$Id: mark.rf,v 1.5 90/04/05 15:12:51 sources Exp Locker: mh $
229 \fIMark\fR will list each sequence named via `\-sequence\ name'
230 (or all of them if `\-sequence' isn't used),
231 and the messages associated with that sequence.
234 This number is usually limited to 10.
252 The name used to denote a message sequence must consist solely of
253 alphabetic characters, and can not be one of the \*(lqreserved\*(rq
256 The name used to denote a message sequence can not occur as part of a
257 message range, e.g., constructs like \*(lqseen:20\*(rq or
258 \*(lqseen\-10\*(rq are forbidden.
264 @put things back, do .NA stuff another way
278 .TH MARK 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
288 @fixup for makewhatis