]> diplodocus.org Git - nmh/blobdiff - man/mark.man
Add test/format/test-ap to get 100% uip/ap.c coverage.
[nmh] / man / mark.man
index 130b4fd254ff3cdbcf0673f769650c09ff7147ef..fcbc2ef7b7ea3c1734d89f7a6447b34a87560c0c 100644 (file)
@@ -1,13 +1,15 @@
+.TH MARK %manext1% "March 31, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
-.TH MARK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 mark \- manipulate message sequences
 .SH SYNOPSIS
 .HP 5
 .na
 .B mark
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-sequence
@@ -17,8 +19,6 @@ mark \- manipulate message sequences
 .RB [ \-list ] 
 .RB [ \-public " | " \-nopublic ]
 .RB [ \-zero " | " \-nozero ]
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
 The
@@ -97,8 +97,8 @@ As expected, the command
 .B \-sequence
 .I foo
 .B \-delete
-all\*(rq
-deletes the sequence \*(lqfoo\*(rq from the current folder.
+all\*(rq empties the sequence \*(lqfoo\*(rq, and therefore removes
+that sequence from the current folder's list of sequences.
 .PP
 When creating or modifying sequences, you can specify the switches
 .B \-public
@@ -119,7 +119,7 @@ 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)
+.IR mh\-sequence (5)
 man page for more details about the difference
 between \*(lqpublic\*(rq and \*(lqprivate\*(rq sequences.
 .PP
@@ -129,7 +129,7 @@ switch tells
 .B mark
 to list both the sequences defined
 for the folder and the messages associated with those sequences.
-.B Mark
+.B mark
 will list the name of each sequence given by
 .B \-sequence
 .I name
@@ -143,7 +143,7 @@ will be listed.  The
 switch does not affect the operation of
 .BR \-list .
 .PP
-The current restrictions on sequences are:
+The restrictions on sequences are:
 .PP
 .IP \(bu 2
 The name used to denote a message sequence must consist of an alphabetic
@@ -152,47 +152,52 @@ 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 27 (11 on small systems).  (The
-internal implementation relies on bitmasks, with some bits set aside
-for internal use.)
-.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/\&.mh\(ruprofile~^The user profile
-.fi
-
+.TP 20
+$HOME/.mh_profile
+The user's profile.
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh directory
-^Current\-Folder:~^To find the default current folder
-.fi
-
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP
+Current\-Folder:
+To find the default current folder.
+.PD
 .SH "SEE ALSO"
-flist(1), pick(1), mh-sequence(5)
-
+.IR flist (1),
+.IR pick (1),
+.IR 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 '
-
+.PD 0
+.TP 20
++folder
+The current folder.
+.TP
+\-add
+If
+.B \-sequence
+is specified,
+.B \-list
+otherwise.
+.TP
+msgs
+The current message, or
+.B all
+if
+.B \-list
+is specified.
+.TP
+\-nozero
+.PD
 .SH CONTEXT
 If a folder is given, it will become the current folder.
-
 .SH "HELPFUL HINTS"
 Use
 .B flist