ANNO(1)
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 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 profile
PROFILE COMPONENTS
Path: To determine the user's nmh directory
Current-Folder: To find the default current folder
SEE ALSO
DEFAULTS
`+folder' defaults to the current folder
`msgs' defaults to cur
`-inplace'
`-date'
CONTEXT
- If a folder is given, it will become the current folder. The first
message annotated will become the current message.