ANNO(1)                                                              [nmh-1.5]                                                             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 pro-
       duced 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

       dist(1), forw(1), repl(1)

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.

MH.6.8                                                             11 June 2012                                                            ANNO(1)