5 .TH MARK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 mark \- manipulate message sequences
16 .RB [ \-add " | " \-delete ]
18 .RB [ \-public " | " \-nopublic ]
19 .RB [ \-zero " | " \-nozero ]
25 command manipulates message sequences by adding or deleting
26 message numbers from folder\-specific message sequences, or by listing
27 those sequences and messages.
29 A message sequence is a keyword, just like one of the \*(lqreserved\*(rq
30 message names, such as \*(lqfirst\*(rq or \*(lqnext\*(rq. Unlike the
31 \*(lqreserved\*(rq message names, which have a fixed semantics on
32 a per\-folder basis, the semantics of a message sequence may be
33 defined, modified, and removed by the user. Message sequences are
34 folder\-specific, e.g., the sequence name \*(lqseen\*(rq in the context
36 .RI \*(lq +inbox \*(rq
37 need not have any relation whatsoever to the
38 sequence of the same name in a folder of a different name.
40 Three action switches direct the operation of
43 are mutually exclusive: the last occurrence of any of them overrides
44 any previous occurrence of the other two.
50 to add messages to sequences or to
51 create a new sequence. For each sequence named via the
54 argument (which must occur at least once) the messages named via
56 (which defaults to \*(lqcur\*(rq if no
58 are given), are added to the
59 sequence. The messages to be added need not be absent from the sequence.
62 switch is specified, the sequence will be emptied prior
63 to adding the messages. Hence,
66 means that each sequence
67 should be initialized to the indicated messages, while
70 means that each sequence should be appended to by the indicated messages.
76 to delete messages from sequences, and is the dual of
78 For each of the named sequences, the
79 named messages are removed from the sequence. These messages need
80 not be already present in the sequence. If the
83 specified, then all messages in the folder are added to the sequence
84 (first creating the sequence, if necessary) before removing the messages.
88 means that each sequence should contain
89 all messages except those indicated, while
93 that only the indicated messages should be removed from each sequence.
94 As expected, the command
100 deletes the sequence \*(lqfoo\*(rq from the current folder.
102 When creating or modifying sequences, you can specify the switches
106 to force the new or modified sequences to be
107 \*(lqpublic\*(rq or \*(lqprivate\*(rq. The switch
110 that the sequences should be made \*(lqpublic\*(rq. These sequences
111 will then be readable by all
113 users with permission to read the relevant folders. In contrast, the
115 switch indicates that the
116 sequences should be made \*(lqprivate\*(rq, and will only be accessible by
117 you. If neither of these switches is specified, then existing sequences
118 will maintain their current status, and new sequences will default to
119 \*(lqpublic\*(rq if you have write permission for the relevant folder.
122 man page for more details about the difference
123 between \*(lqpublic\*(rq and \*(lqprivate\*(rq sequences.
129 to list both the sequences defined
130 for the folder and the messages associated with those sequences.
132 will list the name of each sequence given by
135 and the messages associated with that sequence. If the
136 sequence is private, this will also be indicated. If no sequence is
139 switch, then all sequences for this folder
142 switch does not affect the operation of
145 The current restrictions on sequences are:
148 The name used to denote a message sequence must consist of an alphabetic
149 character followed by zero or more alphanumeric characters, and cannot
150 be one of the (reserved) message names \*(lqnew\*(rq, \*(lqfirst\*(rq,
151 \*(lqlast\*(rq, \*(lqall\*(rq, \*(lqnext\*(rq, or \*(lqprev\*(rq.
154 Only a certain number of sequences may be defined for a given folder.
155 This number is usually limited to 26 (10 on small systems).
158 Message ranges with user\-defined sequence names are restricted to the
159 form \*(lqname:n\*(rq, \*(lqname:+n\*(rq, or \*(lqname:-n\*(rq, and refer
160 to the first or last `n' messages of the sequence `name', respectively.
161 Constructs of the form \*(lqname1\-name2\*(rq are forbidden for user
167 .ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
168 ^$HOME/\&.mh\(ruprofile~^The user profile
171 .SH "PROFILE COMPONENTS"
175 .ta \w'ExtraBigProfileName 'u
176 ^Path:~^To determine the user's nmh directory
177 ^Current\-Folder:~^To find the default current folder
181 flist(1), pick(1), mh-sequence(5)
185 .RB ` +folder "' defaults to the current folder"
186 .RB ` \-add "' if " \-sequence " is specified, " \-list " otherwise"
187 .RB ` msgs "' defaults to cur (or all if " \-list " is specified)"
191 If a folder is given, it will become the current folder.
196 to find folders with a given sequence, and
200 to enumerate those messages in the sequence (such as for
201 use by a shell script).