Update docs a bit.

[nmh] / man / mark.man

diff --git a/man/mark.man b/man/mark.man
index 1f12d9d3365c89d3023b918c84c78aad8ad809ee..fcbc2ef7b7ea3c1734d89f7a6447b34a87560c0c 100644 (file)
--- a/man/mark.man
+++ b/man/mark.man
@@ -1,4 +1,4 @@
-.TH MARK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MARK %manext1% "March 31, 2013" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"


@@ -8,6 +8,8 @@ mark \- manipulate message sequences
 .HP 5
 .na
 .B mark
 .HP 5
 .na
 .B mark

+.RB [ \-help ]
+.RB [ \-version ]

 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-sequence
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-sequence


@@ -17,8 +19,6 @@ mark \- manipulate message sequences
 .RB [ \-list ] 
 .RB [ \-public " | " \-nopublic ]
 .RB [ \-zero " | " \-nozero ]
 .RB [ \-list ] 
 .RB [ \-public " | " \-nopublic ]
 .RB [ \-zero " | " \-nozero ]

-.RB [ \-version ]
-.RB [ \-help ]

 .ad
 .SH DESCRIPTION
 The
 .ad
 .SH DESCRIPTION
 The


@@ -97,8 +97,8 @@ As expected, the command
 .B \-sequence
 .I foo
 .B \-delete
 .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
 .PP
 When creating or modifying sequences, you can specify the switches
 .B \-public


@@ -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
 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
 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
 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
 .PP
 .IP \(bu 2
 The name used to denote a message sequence must consist of an alphabetic


@@ -152,41 +152,50 @@ be one of the (reserved) message names \*(lqnew\*(rq, \*(lqfirst\*(rq,
 \*(lqlast\*(rq, \*(lqall\*(rq, \*(lqnext\*(rq, or \*(lqprev\*(rq.
 .PP
 .IP \(bu 2
 \*(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
 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"
 .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"
 .IR flist (1),
 .IR pick (1),
 .IR mh-sequence (5)
 .SH DEFAULTS
 .SH "SEE ALSO"
 .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"
 .SH CONTEXT
 If a folder is given, it will become the current folder.
 .SH "HELPFUL HINTS"