(Also noted that description of -list needs to be fixed, will
do in next commit.)
as defined by RFC 2822.
The
.B -component
as defined by RFC 2822.
The
.B -component
-option specifies the field name, and the
+switch specifies the field name, and the
-option specifies the field body.
+switch specifies the field body.
.PP
The messages are either the
.I msgs
in the named folder, or the draft if invoked with the
.B -draft
.PP
The messages are either the
.I msgs
in the named folder, or the draft if invoked with the
.B -draft
.PP
Usually, annotation is performed by the commands
.BR dist ,
.PP
Usually, annotation is performed by the commands
.BR dist ,
prepends the annotations to the message.
Annotations are instead appended if the
.B -append
prepends the annotations to the message.
Annotations are instead appended if the
.B -append
.B anno
is invoked,
.B anno
.B anno
is invoked,
.B anno
-will prompt the user for the name of field for the annotation.
+will prompt the user for a field name.
.PP
The field specified must be a valid RFC 2822-style message field name,
.PP
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.
+consisting only of alphanumeric characters and dashes.
+The body may consist of arbitrary text.
-does the annotation inplace in order to preserve
+does the annotation in place in order to preserve
any links to the message. You may change this by using the
.B \-noinplace
switch.
.PP
The
.B -list
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
+switch 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
names matching the specified component, one per line.
The listing is numbered, starting at 1, if the
.B -number
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
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.
+switch is used, the contents of the text are ignored.
-option removes header fields from messages.
+switch 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
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
+switch is used in conjunction with the
-option, the first header field whose name matches the component and
+switch, 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
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 conjunction with the
+switch is used in conjunction with the
.I num
whose name matches the component is deleted.
The number matches that which is produced by the
.B -list
.I num
whose name matches the component is deleted.
The number matches that which is produced by the
.B -list
The special value
.B all
can be used for the number, and causes all components that match the
The special value
.B all
can be used for the number, and causes all components that match the
-changes the last-accessed and last-modified times on annotate messages
-to the time at which the annotation occurs.
+changes the last-accessed and last-modified times on annotated messages
+to the time of the annotation.
.B anno
preserves the original times if the
.B -preserve
.B anno
preserves the original times if the
.B -preserve
A matching
.B -nopreserve
A matching
.B -nopreserve
-option exists that allows time preservation to be turned off if enabled
+switch allows time preservation to be turned off, if enabled
in the profile.
.SH FILES
.TP 20
in the profile.
.SH FILES
.TP 20