X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmark.man1;h=ba19506a495da073fb8cd30f58d240bd8099ce7a;hp=eeda4380094683a703168daaf6f75144341dd650;hb=18591f8e001ecedbee48a51c1d1f08ebaa1c15c8;hpb=32b2354dbaf4bf934936eb5b102a4a3d2fdd209a diff --git a/man/mark.man1 b/man/mark.man1 index eeda438..ba19506 100644 --- a/man/mark.man1 +++ b/man/mark.man1 @@ -27,14 +27,14 @@ 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 message sequence is a keyword, just like one of the `reserved' +message names, such as `f' or `n' (see mh-sequence(7)). 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 \*(lqseen\*(rq in the context +folder\-specific, e.g., the sequence name `seen' in the context of folder -.RI \*(lq +inbox \*(rq +.RI ` +inbox ' need not have any relation whatsoever to the sequence of the same name in a folder of a different name. .PP @@ -54,7 +54,7 @@ create a new sequence. For each sequence named via the .I name argument (which must occur at least once) the messages named via .I msgs -(which defaults to \*(lqcur\*(rq if no +(which defaults to `c' if no .I msgs are given), are added to the sequence. The messages to be added need not be absent from the sequence. @@ -93,35 +93,35 @@ all messages except those indicated, while means that only the indicated messages should be removed from each sequence. As expected, the command -.RB \*(lq mark +.RB ` mark .B \-sequence .I foo .B \-delete -all\*(rq -deletes the sequence \*(lqfoo\*(rq from the current folder. +all' +deletes the sequence `foo' 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 +`public' or `private'. The switch .B \-public indicates -that the sequences should be made \*(lqpublic\*(rq. These sequences +that the sequences should be made `public'. These sequences will then be readable by all -.B nmh +.B mmh 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 +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 -\*(lqpublic\*(rq if you have write permission for the relevant folder. +`public' if you have write permission for the relevant folder. Check the .BR mh\-sequence (7) man page for more details about the difference -between \*(lqpublic\*(rq and \*(lqprivate\*(rq sequences. +between `public' and `private' sequences. .PP The .B \-list @@ -148,8 +148,8 @@ The current restrictions on sequences are: .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. +be one of the (reserved) message names `c', `f', +`l', `a', `n', `p', or `b'. .PP .IP \(bu 2 Only a certain number of sequences may be defined for a given folder. @@ -159,9 +159,9 @@ This number is usually limited to 29 (13 on small systems). (The .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 +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 \*(lqname1\-name2\*(rq are forbidden for user +Constructs of the form `name1\-name2' are forbidden for user defined sequences. .SH FILES @@ -187,7 +187,7 @@ flist(1), pick(1), mh-sequence(7) .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 ` msgs "' defaults to `c' (or `a' if " \-list " is specified)" .RB ` \-nozero ' .SH CONTEXT @@ -197,8 +197,8 @@ If a folder is given, it will become the current folder. Use .B flist to find folders with a given sequence, and -.RB \*(lq pick +.RB ` pick .I sequence -.BR \-list \*(rq +.BR \-list ' to enumerate those messages in the sequence (such as for use by a shell script).