# phpman > man > anno(1)

[ANNO(1mh)](https://www.chedong.com/phpMan.php/man/ANNO/1mh/markdown)                                                                                  [ANNO(1mh)](https://www.chedong.com/phpMan.php/man/ANNO/1mh/markdown)



## 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
       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)](https://www.chedong.com/phpMan.php/man/dist/1/markdown), [_forw_(1)](https://www.chedong.com/phpMan.php/man/forw/1/markdown), [_repl_(1)](https://www.chedong.com/phpMan.php/man/repl/1/markdown)

## 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)](https://www.chedong.com/phpMan.php/man/ANNO/1mh/markdown)