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