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.