Updated all man pages and renamed install-mh.man to mmh.man.
[mmh] / man / anno.man
index b626e2a..65db87e 100644 (file)
@@ -1,6 +1,5 @@
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
 .TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
@@ -15,12 +14,12 @@ anno \- annotate messages
 .IR field ]
 .RB [ \-inplace " | " \-noinplace ]
 .RB [ \-date " | " \-nodate ]
-.RB [ \-draft ]
 .RB [ \-append ]
 .RB [ \-list ]
 .RB [ \-delete ]
 .RB [ \-number
-.IR [ num ]]
+.IR [ num|all ]]
+.RB [ \-preserve " | " \-nopreserve ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-text
@@ -39,11 +38,9 @@ option specifies the field name, and the
 .B -text
 option specifies the field body.
 .PP
-The messages are either the
+The messages are the
 .I msgs
-in the named folder, or the draft if invoked with the
-.B -draft
-option.
+in the named folder.
 .PP
 Usually, annotation is performed by the commands
 .BR dist ,
@@ -133,11 +130,28 @@ 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
+^$HOME/.mmh/profile~^The user profile
 .fi
 
 .SH "PROFILE COMPONENTS"
@@ -145,7 +159,7 @@ option.
 .nf
 .ta 2.4i
 .ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh directory
+^Path:~^To determine the user's mail storage
 ^Current\-Folder:~^To find the default current folder
 .fi