5 .TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 anno \- annotate messages
16 .RB [ \-inplace " | " \-noinplace ]
17 .RB [ \-date " | " \-nodate ]
24 .RB [ \-preserve " | " \-nopreserve ]
32 manipulates header fields or
35 Header fields consist of a field name and an optional field body
36 as defined by RFC-2822.
39 option specifies the field name, and the
41 option specifies the field body.
43 The messages are either the
45 in the named folder, or the draft if invoked with the
49 Usually, annotation is performed by the commands
56 switch. This allows you to keep track of your distribution of,
57 forwarding of, and replies to a message.
61 you can perform arbitrary annotations of your own.
62 Each message selected will be annotated with the lines
69 switch inhibits the date annotation, leaving only the
74 prepends the annotations to the message.
75 Annotations are instead appended if the
86 will prompt the user for the name of field for the annotation.
88 The field specified must be a valid 2822-style message field name,
89 which means that it may only consist of alphanumerics and dashes,
90 The body specified is arbitrary text.
94 does the annotation inplace in order to preserve
95 any links to the message. You may change this by using the
101 option produces a listing of the field bodies for header fields with
102 names matching the specified component, one per line.
103 The listing is numbered, starting at 1, if the
106 A tab character separates the number and the field body.
107 The field body is treated as if it is a file name, and only the final
108 path name component is listed.
109 The complete field body is listed if the
111 option is used, the contents of the text are ignored.
115 option removes header fields from messages.
116 The first header field whose name matches the component is deleted if
117 no other options are specified.
120 option is used in conjunction with the
122 option, the first header field whose name matches the component and
123 whose body matches the text is deleted.
124 The text is treated as if it was a file name; if it begins with a
125 slash, the entire field body must match the text, otherwise just the
126 last path name component of the field body must match.
129 option is used in conjuction with the
133 whose name matches the component is deleted.
134 The number matches that which is produced by the
139 can be used for the number, and causes all components that match the
144 changes the last-accessed and last-modified times on annotate messages
145 to the time at which the annotation occurs.
147 preserves the original times if the
152 option exists that allows time preservation to be turned off if enabled
157 .ta \w'%etcdir%/ExtraBigFileName 'u
158 ^$HOME/\&.mh\(ruprofile~^The user profile
161 .SH "PROFILE COMPONENTS"
165 .ta \w'ExtraBigProfileName 'u
166 ^Path:~^To determine the user's nmh directory
167 ^Current\-Folder:~^To find the default current folder
171 dist(1), forw(1), repl(1)
175 .RI ` +folder "' defaults to the current folder"
176 .RI ` msgs "' defaults to cur"
182 If a folder is given, it will become the current folder. The first
183 message annotated will become the current message.