Provided by: nmh_1.6-8build1_amd64 
NAME
anno - annotate messages
SYNOPSIS
anno [+folder] [msgs] [-component field] [-inplace | -noinplace] [-date | -nodate] [-draft] [-append]
[-list] [-delete] [-number [num|all]] [-preserve | -nopreserve] [-version] [-help] [-text body]
DESCRIPTION
Anno manipulates header fields or annotations in messages. Header fields consist of a field name and an
optional field body as defined by RFC 2822. The -component option specifies the field name, and the
-text option specifies the field body.
The messages are either the msgs in the named folder, or the draft if invoked with the -draft option.
Usually, annotation is performed by the commands dist, forw, and repl, if they are given the -anno
switch. This allows you to keep track of your distribution of, forwarding of, and replies to a message.
By using anno, you can perform arbitrary annotations of your own. Each message selected will be
annotated with the lines
field: date
field: body
The -nodate switch inhibits the date annotation, leaving only the body annotation.
By default, anno prepends the annotations to the message. Annotations are instead appended if the
-append option is specified.
If a -component field is not specified when anno is invoked, anno will prompt the user for the name of
field for the annotation.
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.
Normally anno does the annotation inplace in order to preserve any links to the message. You may change
this by using the -noinplace switch.
The -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 -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
-text option is used, the contents of the text are ignored.
The -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 -text option is used in conjunction with
the -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 -number option is used in conjuction with the -delete option, header field num whose name matches
the component is deleted. The number matches that which is produced by the -list option. The special
value all can be used for the number, and causes all components that match the name to be deleted.
By default, anno changes the last-accessed and last-modified times on annotate messages to the time at
which the annotation occurs. Anno preserves the original times if the -preserve option is used. A
matching -nopreserve option exists that allows time preservation to be turned off if enabled in the
profile.
FILES
$HOME/.mh_profile The user's profile.
PROFILE COMPONENTS
Path: To determine the user's nmh directory.
Current-Folder: To find the default current folder.
SEE ALSO
dist(1), forw(1), repl(1)
DEFAULTS
+folder The current folder.
msgs The current message.
-inplace
-date
CONTEXT
If a folder is given, it will become the current folder. The first message annotated will become the
current message.