4 .TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 anno \- annotate messages
18 .RB [ \-date " | " \-nodate ]
19 .RB [ \-preserve " | " \-nopreserve ]
33 .RB [ \-preserve " | " \-nopreserve ]
49 manipulates header fields or
52 Header fields consist of a field name and an optional field body
53 as defined by RFC-2822.
54 The field name may consist of alphanumerics and dashes only.
55 The field body may consist of arbitrary text.
57 Usually, annotation is performed by the commands
64 switch. This allows you to keep track of your redistribution of,
65 forwarding of, and replies to a message.
68 shell uses annoations to manage attachments, too.
72 manually, you can perform arbitrary annotations of your own.
75 has three operation modes: Adding, deleting and listing of header lines.
79 This is the default mode.
80 Historically, it had been the only mode available.
82 Each message selected will be annotated with the lines
93 option specifies the field name.
99 will prompt the user for the name of field for the annotation.
103 option specifies the field body.
104 If it is missing, only the date annotation will be added.
107 switch inhibits the date annotation, leaving only the
112 prepends the annotations to the message.
113 Annotations are instead appended if the
118 always does the annotation inplace in order to preserve
119 any links to the message.
123 changes the last-accessed and last-modified times on annotate messages
124 to the time at which the annotation occurs.
126 preserves the original times if the
134 mode removes header fields from messages.
135 By default, the first header field whose name matches the component
140 option specifies the field name of headers to delete.
146 will prompt the user for the name.
151 the first header field whose name matches the component and
152 whose body matches the text is deleted.
153 The text is treated as if it was a path name; if it begins with a
154 slash, the entire field body must match the text, otherwise just the
155 last path name component of the field body must match.
162 header field whose name matches the component is deleted.
163 The numbers are the same as those produced in
166 The special value `all' can be used for the number,
167 and causes all components that match the name to be deleted.
173 may be specified, but not both at the same time.
179 mode produces a listing of the field bodies for header fields with
180 matching component names, one per line.
184 the listing is numbered, starting at 1.
188 option specifies the field name of headers to list.
194 will prompt the user for the name.
199 .ta \w'%etcdir%/ExtraBigFileName 'u
200 ^$HOME/.mmh/profile~^The user profile
203 .SH "PROFILE COMPONENTS"
207 .ta \w'ExtraBigProfileName 'u
208 ^Path:~^To determine the user's mail storage
209 ^Current\-Folder:~^To find the default current folder
213 dist(1), forw(1), repl(1)
217 .RI ` +folder "' defaults to the current folder"
218 .RI ` msgs "' defaults to cur"
224 If a folder is given, it will become the current folder. The first
225 message annotated will become the current message.
231 switch must appear after either the
235 mode switch, on the command line.
236 Otherwise it is not possible to determine if it takes an argument.