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.
78 This is the default mode.
79 Historically, it had been the only mode available.
81 Each message selected will be annotated with the lines
92 switch specifies the field name.
98 will prompt the user for a field name.
102 switch specifies the field body.
103 If it is missing, only the date annotation will be added.
106 switch inhibits the date annotation, leaving only the
111 prepends the annotations to the message.
112 Annotations are instead appended if the
117 always does the annotation in place in order to preserve
118 any links to the message.
122 changes the last-accessed and last-modified times on annotated messages
123 to the time of the annotation.
125 preserves the original times if the
132 mode removes header fields from messages.
133 By default, the first header field whose name matches the component
138 switch specifies the field name of headers to delete.
144 will prompt the user for the name.
149 the first header field whose name matches the component and
150 whose body matches the text is deleted.
151 The text is treated as if it was a path name; if it begins with a
152 slash, the entire field body must match the text, otherwise just the
153 last path name component of the field body must match.
160 header field whose name matches the component is deleted.
161 The numbers are the same as those produced in
164 The special value `all' can be used for the number,
165 and causes all components that match the name to be deleted.
171 may be specified, but not both at the same time.
176 mode produces a listing of the field bodies for header fields with
177 matching component names, one per line.
178 Trailing whitespace in the field body does not get printed.
182 the listing is numbered, starting at 1.
186 switch specifies the field name of headers to list.
192 will prompt the user for the name.
196 .ta \w'%etcdir%/ExtraBigFileName 'u
197 ^$HOME/.mmh/profile~^The user profile
199 .SH "PROFILE COMPONENTS"
203 .ta \w'ExtraBigProfileName 'u
204 ^Path:~^To determine the user's mail storage
205 ^Current\-Folder:~^To find the default current folder
208 dist(1), forw(1), repl(1)
211 .RI ` +folder "' defaults to the current folder"
212 .RI ` msgs "' defaults to the current message"
217 If a folder is given, it will become the current folder. The first
218 message annotated will become the current message.
223 switch must appear after either the
227 mode switch, on the command line.
228 Otherwise it is not possible to determine if it takes an argument.