X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmark.man;fp=man%2Fmark.man;h=0000000000000000000000000000000000000000;hp=71b24f639437434f2c6661befe449af911c98756;hb=5aaedc4256d58afe2481d667afdcb5162a914ba9;hpb=2676fdf95667cfa0fec45372dbb956c8645c1119 diff --git a/man/mark.man b/man/mark.man deleted file mode 100644 index 71b24f6..0000000 --- a/man/mark.man +++ /dev/null @@ -1,202 +0,0 @@ -.\" -.\" %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).