ANNO(1mh)

NAME
anno - annotate messages

SYNOPSIS

anno [+folder] [msgs] [-component field] [-text body] [-append] [-date | -nodate] [-preserve | -nopreserve] [-Version] [-help]

anno -delete [+folder] [msgs] [-component field] [-text body] [-number num | all ] [-preserve | -nopreserve] [-Version] [-help]

anno -list [+folder] [msgs] [-component field] [-number] [-Version] [-help]

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 field name may consist of alphanumerics and dashes only. The field body may consist of arbitrary text.

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 redistribution of, forwarding of, and replies to a message. The whatnow shell uses annoations to manage attachments, too.

By using anno manually, you can perform arbitrary annotations of your own.

Anno has three operation modes: Adding, deleting and listing of header lines.

  Add mode

This is the default mode. Historically, it had been the only mode available.

Each message selected will be annotated with the lines

    field: date
    field: body

The -component switch specifies the field name. If no -component field is specified, anno will prompt the user for a field name.

The -text switch specifies the field body. If it is missing, only the date annotation will be added. 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 switch is specified.

Anno always does the annotation in place in order to preserve any links to the message.

By default, anno changes the last-accessed and last-modified times on annotated messages to the time of the annotation. Anno preserves the original times if the -preserve switch is used.

  Delete mode

The -delete mode removes header fields from messages. By default, the first header field whose name matches the component is deleted.

The -component switch specifies the field name of headers to delete. If no -component field is specified, anno will prompt the user for the name.

If the -text switch is used, 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 path 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 switch is used, the nth header field whose name matches the component is deleted. The numbers are the same as those produced in -list mode. The special value `all' can be used for the number, and causes all components that match the name to be deleted.

Either -text or -number may be specified, but not both at the same time.

  List mode

The -list mode produces a listing of the field bodies for header fields with matching component names, one per line. Trailing whitespace in the field body does not get printed. If the -number switch is also used, the listing is numbered, starting at 1.

The -component switch specifies the field name of headers to list. If no -component field is specified, anno will prompt the user for the name.

FILES
^$HOME/.mmh/profile~^The user profile

PROFILE COMPONENTS
^Path:~^To determine the user's mail storage
^Current-Folder:~^To find the default current folder

SEE ALSO
dist(1), forw(1), repl(1)

DEFAULTS
`+folder' defaults to the current folder
`msgs' defaults to the current message
`-date'
`-nopreserve'

CONTEXT
If a folder is given, it will become the current folder. The first message annotated will become the current message.

BUGS

The -number switch must appear after either the -list or the -delete mode switch, on the command line. Otherwise it is not possible to determine if it takes an argument.