xenial (1) anno.1mh.gz

Provided by: nmh_1.6-8build1_amd64 bug

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 RFC 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 produced 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'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.