Factor trim format function out
[mmh] / man / mark.man1
index eeda438..ba19506 100644 (file)
@@ -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
 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
 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
 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
 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
 .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.
 .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
 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
 .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
 .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
 .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
 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
 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
 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
 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
 .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
 .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.
 .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
 .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.
 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
 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"
 .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
 .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
 Use
 .B flist
 to find folders with a given sequence, and
-.RB \*(lq pick
+.RB ` pick
 .I sequence
 .I sequence
-.BR \-list \*(rq
+.BR \-list '
 to enumerate those messages in the sequence (such as for
 use by a shell script).
 to enumerate those messages in the sequence (such as for
 use by a shell script).