1MARK(1) General Commands Manual MARK(1)
2
6 mark - manipulate nmh message sequences
7
9 mark [-help] [-version] [+folder] [msgs] [-sequence name ...] [-add |
10 -delete] [-list] [-public | -nopublic] [-zero | -nozero]
11
13 The mark command manipulates message sequences by adding or deleting
14 message numbers from folder-specific message sequences, or by listing
15 those sequences and messages.
16 A message sequence is a keyword, just like one of the “reserved” mes‐
18 sage names, such as “first” or “next”. Unlike the “reserved” message
19 names, which have a fixed semantics on a per-folder basis, the seman‐
20 tics of a message sequence may be defined, modified, and removed by the
21 user. Message sequences are folder-specific, e.g., the sequence name
22 “seen” in the context of folder “+inbox” need not have any relation
23 whatsoever to the sequence of the same name in a folder of a different
24 name.
25 Three action switches direct the operation of mark. These switches are
27 mutually exclusive: the last occurrence of any of them overrides any
28 previous occurrence of the other two.
29 The -add switch tells mark to add messages to sequences or to create a
31 new sequence. For each sequence named via the -sequence name argument
32 (which must occur at least once) the messages named via msgs (which
33 defaults to “cur” if no msgs are given), are added to the sequence.
34 The messages to be added need not be absent from the sequence. If the
35 -zero switch is specified, the sequence will be emptied prior to adding
36 the messages. Hence, -add -zero means that each sequence should be
37 initialized to the indicated messages, while -add -nozero means that
38 each sequence should be appended to by the indicated messages.
39 The -delete switch tells mark to delete messages from sequences, and is
41 the dual of -add. For each of the named sequences, the named messages
42 are removed from the sequence. These messages need not be already
43 present in the sequence. If the -zero switch is specified, then all
44 messages in the folder are added to the sequence (first creating the
45 sequence, if necessary) before removing the messages. Hence, -delete
46 -zero means that each sequence should contain all messages except those
47 indicated, while -delete -nozero means that only the indicated messages
48 should be removed from each sequence. As expected, the command “mark
49 -sequence foo -delete all” empties the sequence “foo”, and therefore
50 removes that sequence from the current folder's list of sequences.
51 When creating or modifying sequences, you can specify the switches
53 -public or -nopublic to force the new or modified sequences to be “pub‐
54 lic” or “private”. The switch -public indicates that the sequences
55 should be made “public”. These sequences will then be readable by all
56 nmh users with permission to read the relevant folders. In contrast,
57 the -nopublic switch indicates that the sequences should be made “pri‐
58 vate”, and will only be accessible by you. If neither of these
59 switches is specified, then existing sequences will maintain their cur‐
60 rent status, and new sequences will default to “public” if you have
61 write permission for the relevant folder. Check the mh-sequence(5) man
62 page for more details about the difference between “public” and “pri‐
63 vate” sequences.
64 The -list switch tells mark to list both the sequences defined for the
66 folder and the messages associated with those sequences. mark will
67 list the name of each sequence given by -sequence name and the messages
68 associated with that sequence. If the sequence is private, this will
69 also be indicated. If no sequence is specified by the -sequence
70 switch, then all sequences for this folder will be listed. The -zero
71 switch does not affect the operation of -list.
72 The restrictions on sequences are:
74 · The name used to denote a message sequence must consist of an alpha‐
76 betic character followed by zero or more alphanumeric characters, and
77 cannot be one of the (reserved) message names “new”, “first”, “last”,
78 “all”, “next”, or “prev”.
79 · Message ranges with user-defined sequence names are restricted to the
81 form “name:n”, “name:+n”, or “name:-n”, and refer to the first or
82 last `n' messages of the sequence `name', respectively. Constructs
83 of the form “name1-name2” are forbidden for user defined sequences.
84
86 $HOME/.mh_profile The user's profile.
87
89 Path: To determine the user's nmh directory.
90 Current-Folder: To find the default current folder.
91
93 flist(1), pick(1), mh-sequence(5)
94
96 +folder The current folder.
97 -add If -sequence is specified, -list otherwise.
98 msgs The current message, or all if -list is specified.
99 -nozero
100
102 If a folder is given, it will become the current folder.
103
105 Use flist to find folders with a given sequence, and “pick sequence
106 -list” to enumerate those messages in the sequence (such as for use by
107 a shell script).
108nmh-1.7.1 2013-03-31 MARK(1)