+.TH ANNO %manext1% "December 7, 2005" "%nmhversion%"
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
anno \- annotate messages
.SH SYNOPSIS
.RB [ \-list ]
.RB [ \-delete ]
.RB [ \-number
-.IR [ num ]]
+.IR [ num|all ]]
+.RB [ \-preserve " | " \-nopreserve ]
.RB [ \-version ]
.RB [ \-help ]
.RB [ \-text
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,
+which means that it may only consist of alphanumerics and dashes.
The body specified is arbitrary text.
.PP
Normally
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
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^Path:~^To determine the user's nmh directory
^Current\-Folder:~^To find the default current folder
.fi
-
.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"
.RB ` \-inplace '
.RB ` \-date '
.fi
-
.SH CONTEXT
If a folder is given, it will become the current folder. The first
message annotated will become the current message.