mark - manipulate nmh message sequences
mark [-help] [-version] [+folder]
[msgs] [-sequence name ...] [-add |
-delete] [-list] [-public | -nopublic]
[-zero | -nozero]
command manipulates message sequences by adding or deleting
message numbers from folder-specific message sequences, or by listing those
sequences and messages.
A message sequence is a keyword, just like one of the “reserved”
message names, such as “first” or “next”. Unlike
the “reserved” message names, which have a fixed semantics on a
per-folder basis, the semantics of a message sequence may be defined,
modified, and removed by the user. Message sequences are folder-specific,
e.g., the sequence name “seen” in the context of folder
” need not have any relation whatsoever to the
sequence of the same name in a folder of a different name.
Three action switches direct the operation of mark
. These switches are
mutually exclusive: the last occurrence of any of them overrides any previous
occurrence of the other two.
switch tells mark
to add messages to sequences or to
create a new sequence. For each sequence named via the -sequence
argument (which must occur at least once) the messages named via
(which defaults to “cur” if no msgs
given), are added to the sequence. The messages to be added need not be absent
from the sequence. If the -zero
switch is specified, the sequence will
be emptied prior to adding the messages. Hence, -add -zero
that each sequence should be initialized to the indicated messages, while
means that each sequence should be appended to by
the indicated messages.
switch tells mark
to delete messages from sequences,
and is the dual of -add
. For each of the named sequences, the named
messages are removed from the sequence. These messages need not be already
present in the sequence. If the -zero
switch is specified, then all
messages in the folder are added to the sequence (first creating the sequence,
if necessary) before removing the messages. Hence, -delete -zero
means that each sequence should contain all messages except those indicated,
while -delete -nozero
means that only the indicated messages
should be removed from each sequence. As expected, the command
“mark -sequence foo -delete
empties the sequence “foo”, and therefore removes that sequence
from the current folder's list of sequences.
When creating or modifying sequences, you can specify the switches
to force the new or modified sequences to
be “public” or “private”. The switch
indicates that the sequences should be made
“public”. These sequences will then be readable by all
users with permission to read the relevant folders. In contrast,
switch indicates that the sequences should be made
“private”, and will only be accessible by you. If neither of
these switches is specified, then existing sequences will maintain their
current status, and new sequences will default to “public” if
you have write permission for the relevant folder. Check the
(5) man page for more details about the difference between
“public” and “private” sequences.
switch tells mark
to list both the sequences defined for
the folder and the messages associated with those sequences. mark
list the name of each sequence given by -sequence name
messages associated with that sequence. If the sequence is private, this will
also be indicated. If no sequence is specified by the -sequence
then all sequences for this folder will be listed. The -zero
does not affect the operation of -list
The restrictions on sequences are:
- The name used to denote a message sequence must consist of an alphabetic
character followed by zero or more alphanumeric characters, and cannot be
one of the (reserved) message names “new”,
“first”, “last”, “all”,
“next”, or “prev”.
- Message ranges with user-defined sequence names are restricted to the form
“name:n”, “name:+n”, or
“name:-n”, and refer to the first or last `n' messages of
the sequence `name', respectively. Constructs of the form
“name1-name2” are forbidden for user defined sequences.
- The user's profile.
- To determine the user's nmh directory.
- To find the default current folder.
- The current folder.
- If -sequence is specified, -list otherwise.
- The current message, or all if -list is specified.
If a folder is given, it will become the current folder.
to find folders with a given sequence, and “pick
” to enumerate those messages in the
sequence (such as for use by a shell script).