+++ /dev/null
-.\"
-.\" %nmhwarning%
-.\"
-.TH MARK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.SH NAME
-mark \- manipulate message sequences
-.SH SYNOPSIS
-.HP 5
-.na
-.B mark
-.RI [ +folder ]
-.RI [ msgs ]
-.RB [ \-sequence
-.I name
-\&...]
-.RB [ \-add " | " \-delete ]
-.RB [ \-list ]
-.RB [ \-public " | " \-nopublic ]
-.RB [ \-zero " | " \-nozero ]
-.RB [ \-version ]
-.RB [ \-help ]
-.ad
-.SH DESCRIPTION
-The
-.B mark
-command manipulates message sequences by adding or deleting
-message numbers from folder\-specific message sequences, or by listing
-those sequences and messages.
-.PP
-A message sequence is a keyword, just like one of the \*(lqreserved\*(rq
-message names, such as \*(lqfirst\*(rq or \*(lqnext\*(rq. Unlike the
-\*(lqreserved\*(rq 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 \*(lqseen\*(rq in the context
-of folder
-.RI \*(lq +inbox \*(rq
-need not have any relation whatsoever to the
-sequence of the same name in a folder of a different name.
-.PP
-Three action switches direct the operation of
-.BR mark .
-These switches
-are mutually exclusive: the last occurrence of any of them overrides
-any previous occurrence of the other two.
-.PP
-The
-.B \-add
-switch tells
-.B mark
-to add messages to sequences or to
-create a new sequence. For each sequence named via the
-.B \-sequence
-.I name
-argument (which must occur at least once) the messages named via
-.I msgs
-(which defaults to \*(lqcur\*(rq if no
-.I msgs
-are given), are added to the
-sequence. The messages to be added need not be absent from the sequence.
-If the
-.B \-zero
-switch is specified, the sequence will be emptied prior
-to adding the messages. Hence,
-.B \-add
-.B \-zero
-means that each sequence
-should be initialized to the indicated messages, while
-.B \-add
-.B \-nozero
-means that each sequence should be appended to by the indicated messages.
-.PP
-The
-.B \-delete
-switch tells
-.B mark
-to delete messages from sequences, and is the dual of
-.BR \-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
-.B \-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,
-.B \-delete
-.B \-zero
-means that each sequence should contain
-all messages except those indicated, while
-.B \-delete
-.B \-nozero
-means
-that only the indicated messages should be removed from each sequence.
-As expected, the command
-.RB \*(lq mark
-.B \-sequence
-.I foo
-.B \-delete
-all\*(rq
-deletes the sequence \*(lqfoo\*(rq from the current folder.
-.PP
-When creating or modifying sequences, you can specify the switches
-.B \-public
-or
-.B \-nopublic
-to force the new or modified sequences to be
-\*(lqpublic\*(rq or \*(lqprivate\*(rq. The switch
-.B \-public
-indicates
-that the sequences should be made \*(lqpublic\*(rq. These sequences
-will then be readable by all
-.B nmh
-users with permission to read the relevant folders. In contrast, the
-.B \-nopublic
-switch indicates that the
-sequences should be made \*(lqprivate\*(rq, 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
-\*(lqpublic\*(rq if you have write permission for the relevant folder.
-Check the
-.BR mh\-sequence (5)
-man page for more details about the difference
-between \*(lqpublic\*(rq and \*(lqprivate\*(rq sequences.
-.PP
-The
-.B \-list
-switch tells
-.B mark
-to list both the sequences defined
-for the folder and the messages associated with those sequences.
-.B Mark
-will list the name of each sequence given by
-.B \-sequence
-.I name
-and the messages associated with that sequence. If the
-sequence is private, this will also be indicated. If no sequence is
-specified by the
-.B \-sequence
-switch, then all sequences for this folder
-will be listed. The
-.B \-zero
-switch does not affect the operation of
-.BR \-list .
-.PP
-The current restrictions on sequences are:
-.PP
-.IP \(bu 2
-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 \*(lqnew\*(rq, \*(lqfirst\*(rq,
-\*(lqlast\*(rq, \*(lqall\*(rq, \*(lqnext\*(rq, or \*(lqprev\*(rq.
-.PP
-.IP \(bu 2
-Only a certain number of sequences may be defined for a given folder.
-This number is usually limited to 26 (10 on small systems).
-.PP
-.IP \(bu 2
-Message ranges with user\-defined sequence names are restricted to the
-form \*(lqname:n\*(rq, \*(lqname:+n\*(rq, or \*(lqname:-n\*(rq, and refer
-to the first or last `n' messages of the sequence `name', respectively.
-Constructs of the form \*(lqname1\-name2\*(rq are forbidden for user
-defined sequences.
-
-.SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
-^$HOME/.mmh/profile~^The user profile
-.fi
-
-.SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName 'u
-^Path:~^To determine the user's mail storage
-^Current\-Folder:~^To find the default current folder
-.fi
-
-.SH "SEE ALSO"
-flist(1), pick(1), mh-sequence(5)
-
-.SH DEFAULTS
-.nf
-.RB ` +folder "' defaults to the current folder"
-.RB ` \-add "' if " \-sequence " is specified, " \-list " otherwise"
-.RB ` msgs "' defaults to cur (or all if " \-list " is specified)"
-.RB ` \-nozero '
-
-.SH CONTEXT
-If a folder is given, it will become the current folder.
-
-.SH "HELPFUL HINTS"
-Use
-.B flist
-to find folders with a given sequence, and
-.RB \*(lq pick
-.I sequence
-.BR \-list \*(rq
-to enumerate those messages in the sequence (such as for
-use by a shell script).
projects / mmh / blobdiff