NAME

       anno - annotate nmh messages

SYNOPSIS

       anno [-help] [-version] [+folder] [msgs] [-component field] [-inplace | -noinplace] [-date | -nodate]
            [-draft] [-append] [-list] [-delete] [-number [num|all]] [-preserve | -nopreserve] [-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 switch specifies  the  field  name,  and  the
       -text switch specifies the field body.

       The messages are either the msgs in the named folder, or the draft if invoked with the -draft switch.

       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 switch is specified.

       If a -component field is not specified when anno is invoked, anno will prompt the user for a field name.

       The field specified must be a valid RFC 2822-style message field name, consisting  only  of  alphanumeric
       characters and dashes.  The body may consist of arbitrary text.

       Normally anno does the annotation in place in order to preserve any links to the message.  You may change
       this by using the -noinplace switch.

       The  -list  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 -number switch 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 switch is used; the argument to the -text switch is required but ignored.

       The -delete 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 -text switch is used in conjunction with
       the -delete 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 -number switch is used in conjunction with the -delete switch, header field num whose name matches
       the component is deleted.  The number matches that which is produced by the -list  switch.   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 annotated messages to the time of
       the annotation.  anno preserves the  original  times  if  the  -preserve  switch  is  used.   A  matching
       -nopreserve switch 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.

nmh-1.8                                            2005-12-07                                          ANNO(1mh)