phpman > man > anno(1)

ANNO(1mh)                                                                                  ANNO(1mh)



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 | -nopre‐‐
            serve] [-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 al‐
       phanumeric 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  -num‐‐
       ber 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  compo‐
       nent 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.7.1                                    2005-12-07                                    ANNO(1mh)