X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fanno.man;h=65db87efe5b4b98d2ad6c73e769c1d9f0eb5a388;hp=76b71e44f88d93cf840ebcceae0294646fd6c1a5;hb=363190329760d38060e89956206583831b0d084d;hpb=b36e2ab7892cdf30a8b33d02e00af70398013b5d

diff --git a/man/anno.man b/man/anno.man
index 76b71e4..65db87e 100644
--- a/man/anno.man
+++ b/man/anno.man
@@ -1,12 +1,12 @@
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
 .TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 anno \- annotate messages
 .SH SYNOPSIS
 .HP 5
+.na
 .B anno
 .RI [ +folder ]
 .RI [ msgs ]
@@ -14,14 +14,33 @@ anno \- annotate messages
 .IR field ]
 .RB [ \-inplace " | " \-noinplace ]
 .RB [ \-date " | " \-nodate ]
+.RB [ \-append ]
+.RB [ \-list ]
+.RB [ \-delete ]
+.RB [ \-number
+.IR [ num|all ]]
+.RB [ \-preserve " | " \-nopreserve ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-text
 .IR body ]
+.ad
 .SH DESCRIPTION
 .B Anno
-annotates the specified messages in the named folder using
-the field and body.
+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.
+The
+.B -component
+option specifies the field name, and the
+.B -text
+option specifies the field body.
+.PP
+The messages are the
+.I msgs
+in the named folder.
 .PP
 Usually, annotation is performed by the commands
 .BR dist ,
@@ -45,7 +64,14 @@ The
 .B \-nodate
 switch inhibits the date annotation, leaving only the
 body annotation.
-
+.PP
+By default,
+.B anno
+prepends the annotations to the message.
+Annotations are instead appended if the
+.B -append
+option is specified.
+.PP
 If a
 .B \-component
 .I field
@@ -55,8 +81,8 @@ is invoked,
 .B anno
 will prompt the user for the name of field for the annotation.
 .PP
-The field specified should be a valid 822-style message field name,
-which means that it should consist of alphanumerics (or dashes) only.
+The field specified must be a valid 2822-style message field name,
+which means that it may only consist of alphanumerics and dashes,
 The body specified is arbitrary text.
 .PP
 Normally
@@ -65,30 +91,88 @@ does the annotation inplace in order to preserve
 any links to the message.  You may change this by using the
 .B \-noinplace
 switch.
-
+.PP
+The
+.B -list
+option produces a listing of the field bodies for header fields with
+names matching the specified component, one per line.
+The listing is numbered, starting at 1, if the
+.B -number
+option is also used.
+A tab character separates the number and the field body.
+The field body is treated as if it is a file name, and only the final
+path name component is listed.
+The complete field body is listed if the
+.B -text
+option is used, the contents of the text are ignored.
+.PP
+The
+.B -delete
+option removes header fields from messages.
+The first header field whose name matches the component is deleted if
+no other options are specified.
+If the
+.B -text
+option is used in conjunction with the
+.B -delete
+option, the first header field whose name matches the component and
+whose body matches the text is deleted.
+The text is treated as if it was a file name; if it begins with a
+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
+.B -delete
+option, header field
+.I num
+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'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%etcdir%/ExtraBigFileName  'u
+^$HOME/.mmh/profile~^The user profile
+.fi
 
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .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
 
 .SH "SEE ALSO"
 dist(1), forw(1), repl(1)
 
-.SH "DEFAULTS"
+.SH DEFAULTS
 .nf
 .RI ` +folder "' defaults to the current folder"
 .RI ` msgs "' defaults to cur"
 .RB ` \-inplace '
 .RB ` \-date '
+.fi
 
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The first