sbr/m_mktemp.h: Move remaining prototypes from h/prototypes.h.

[nmh] / man / mark.man

diff --git a/man/mark.man b/man/mark.man
index 6915792d986df17e67d5745828c3c872210f6ff2..7a34e678f6e5d71b299a9a55554519a0b7a25e7c 100644 (file)
--- a/man/mark.man
+++ b/man/mark.man
@@ -1,39 +1,38 @@
-.\"
+.TH MARK %manext1% 2013-03-31 "%nmhversion%"
+.

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

-.\" $Id$
-.\"
-.TH MARK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.

 .SH NAME
 .SH NAME

-mark \- manipulate message sequences
+mark \- manipulate nmh message sequences

 .SH SYNOPSIS
 .HP 5
 .na
 .B mark
 .SH SYNOPSIS
 .HP 5
 .na
 .B mark

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

 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-sequence
 .I name
 \&...]
 .RB [ \-add " | " \-delete ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-sequence
 .I name
 \&...]
 .RB [ \-add " | " \-delete ]

-.RB [ \-list ] 
+.RB [ \-list ]

 .RB [ \-public " | " \-nopublic ]
 .RB [ \-zero " | " \-nozero ]
 .RB [ \-public " | " \-nopublic ]
 .RB [ \-zero " | " \-nozero ]

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

 .ad
 .SH DESCRIPTION
 The
 .B mark
 command manipulates message sequences by adding or deleting
 .ad
 .SH DESCRIPTION
 The
 .B mark
 command manipulates message sequences by adding or deleting

-message numbers from folder\-specific message sequences, or by listing
+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
 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
+a per-folder basis, the semantics of a message sequence may be

 defined, modified, and removed by the user.  Message sequences are
 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 \*(lqseen\*(rq in the context

 of folder
 .RI \*(lq +inbox \*(rq
 need not have any relation whatsoever to the
 of folder
 .RI \*(lq +inbox \*(rq
 need not have any relation whatsoever to the


@@ -98,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


@@ -120,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
 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
 man page for more details about the difference
 between \*(lqpublic\*(rq and \*(lqprivate\*(rq sequences.
 .PP


@@ -130,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


@@ -144,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


@@ -153,45 +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
 \*(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
+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.
 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
 .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"
 .SH "SEE ALSO"

-flist(1), pick(1), mh-sequence(5)
-
+.IR flist (1),
+.IR pick (1),
+.IR mh-sequence (5)

 .SH DEFAULTS
 .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 CONTEXT
 If a folder is given, it will become the current folder.

-

 .SH "HELPFUL HINTS"
 Use
 .B flist
 .SH "HELPFUL HINTS"
 Use
 .B flist