NAME¶

anno - annotate nmh messages

SYNOPSIS¶

anno[-help][-version][+folder][msgs][-componentfield][-inplace | -noinplace][-date | -nodate][-draft][-append][-list][-delete][-number[num|all]][-preserve | -nopreserve][-textbody]

DESCRIPTION¶

annomanipulates header fields orannotationsin messages.Header fields consist of a field name and an optional field bodyas defined by RFC 2822.The-componentswitch specifies the field name, and the-textswitch specifies the field body.

The messages are either themsgsin the named folder, or the draft if invoked with the-draftswitch.

Usually, annotation is performed by the commandsdist,forw,andrepl,if they are given the-annoswitch. This allows you to keep track of your distribution of,forwarding of, and replies to a message.

By usinganno,you can perform arbitrary annotations of your own.Each message selected will be annotated with the lines

field: date
field: body

The-nodateswitch inhibits the date annotation, leaving only thebody annotation.

By default,annoprepends the annotations to the message.Annotations are instead appended if the-appendswitch is specified.

If a-componentfieldis not specified whenannois invoked,annowill prompt the user for a field name.

The field specified must be a valid RFC 2822-style message field name,consisting only of alphanumeric characters and dashes.The body may consist of arbitrary text.

Normallyannodoes the annotation in place in order to preserveany links to the message. You may change this by using the-noinplaceswitch.

The-listswitch produces a listing of the field bodies for header fields withnames matching the specified component, one per line.The listing is numbered, starting at 1, if the-numberswitch 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 finalpath name component is listed.The complete field body is listed if the-textswitch is used; the argument to the-textswitch is required but ignored.

The-deleteswitch removes header fields from messages.The first header field whose name matches the component is deleted ifno other options are specified.If the-textswitch is used in conjunction with the-deleteswitch, the first header field whose name matches the component andwhose body matches the text is deleted.The text is treated as if it was a file name; if it begins with aslash, the entire field body must match the text, otherwise just thelast path name component of the field body must match.If the-numberswitch is used in conjunction with the-deleteswitch, header fieldnumwhose name matches the component is deleted.The number matches that which is produced by the-listswitch.The special valueallcan be used for the number, and causes all components that match thename to be deleted.

By default,annochanges the last-accessed and last-modified times on annotated messagesto the time of the annotation.annopreserves the original times if the-preserveswitch is used.A matching-nopreserveswitch allows time preservation to be turned off, if enabledin 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 firstmessage annotated will become the current message.