Replaced use of ! with || true, for ultimate Bourne shell compatiblity.

[nmh] / man / anno.man

diff --git a/man/anno.man b/man/anno.man
index b626e2a4bd5a139a626d8e7e9a4609f4bf586c96..c35b82e4238753767508587c3a279496ca7cd546 100644 (file)
--- a/man/anno.man
+++ b/man/anno.man
@@ -1,14 +1,15 @@
+.TH ANNO %manext1% "December 7, 2005" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 anno \- annotate messages
 .SH SYNOPSIS
 .HP 5
 .na
 .B anno
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-component
@@ -20,19 +21,18 @@ anno \- annotate messages
 .RB [ \-list ]
 .RB [ \-delete ]
 .RB [ \-number
-.IR [ num ]]
-.RB [ \-version ]
-.RB [ \-help ]
+.IR [ num|all ]]
+.RB [ \-preserve " | " \-nopreserve ]
 .RB [ \-text
 .IR body ]
 .ad
 .SH DESCRIPTION
-.B Anno
+.B anno
 manipulates header fields or
 .I annotations
 in messages.
 Header fields consist of a field name and an optional field body
-as defined by RFC-2822.
+as defined by RFC 2822.
 The
 .B -component
 option specifies the field name, and the
@@ -84,8 +84,8 @@ is invoked,
 .B anno
 will prompt the user for the name of field for the annotation.
 .PP
-The field specified must be a valid 2822-style message field name,
-which means that it may only consist of alphanumerics and dashes,
+The field specified must be a valid RFC 2822-style message field name,
+which means that it may only consist of alphanumerics and dashes.
 The body specified is arbitrary text.
 .PP
 Normally
@@ -125,7 +125,7 @@ slash, the entire field body must match the text, otherwise just the
 last path name component of the field body must match.
 If the
 .B -number
-option is used in conjuction with the
+option is used in conjunction with the
 .B -delete
 option, header field
 .I num
@@ -133,33 +133,53 @@ whose name matches the component is deleted.
 The number matches that which is produced by the
 .B -list
 option.
+The special value
+.B all
+can be used for the number, and causes all components that match the
+name to be deleted.
+.PP
+By default,
+.B anno
+changes the last-accessed and last-modified times on annotate messages
+to the time at which the annotation occurs.
+.B anno
+preserves the original times if the
+.B -preserve
+option is used.
+A matching
+.B -nopreserve
+option exists that allows time preservation to be turned off if enabled
+in the profile.
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-.fi
-
+.TP 20
+$HOME/\&.mh\(ruprofile
+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"
-dist(1), forw(1), repl(1)
-
+.IR dist (1),
+.IR forw (1),
+.IR repl (1)
 .SH DEFAULTS
-.nf
-.RI ` +folder "' defaults to the current folder"
-.RI ` msgs "' defaults to cur"
-.RB ` \-inplace '
-.RB ` \-date '
-.fi
-
+.PD 0
+.TP 20
++folder
+The current folder.
+.TP
+msgs
+The current message.
+.TP
+-inplace
+.TP
+-date
+.PD
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The first
 message annotated will become the current message.