1ANNO(1) General Commands Manual ANNO(1)
2
6 anno - annotate nmh messages
7
9 anno [-help] [-version] [+folder] [msgs] [-component field] [-inplace |
10 -noinplace] [-date | -nodate] [-draft] [-append] [-list] [-delete]
11 [-number [num|all]] [-preserve | -nopreserve] [-text body]
12
14 anno manipulates header fields or annotations in messages. Header
15 fields consist of a field name and an optional field body as defined by
16 RFC 2822. The -component switch specifies the field name, and the
17 -text switch specifies the field body.
18 The messages are either the msgs in the named folder, or the draft if
20 invoked with the -draft switch.
21 Usually, annotation is performed by the commands dist, forw, and repl,
23 if they are given the -anno switch. This allows you to keep track of
24 your distribution of, forwarding of, and replies to a message.
25 By using anno, you can perform arbitrary annotations of your own. Each
27 message selected will be annotated with the lines
28 field: date
30 field: body
31 The -nodate switch inhibits the date annotation, leaving only the body
33 annotation.
34 By default, anno prepends the annotations to the message. Annotations
36 are instead appended if the -append switch is specified.
37 If a -component field is not specified when anno is invoked, anno will
39 prompt the user for a field name.
40 The field specified must be a valid RFC 2822-style message field name,
42 consisting only of alphanumeric characters and dashes. The body may
43 consist of arbitrary text.
44 Normally anno does the annotation in place in order to preserve any
46 links to the message. You may change this by using the -noinplace
47 switch.
48 The -list switch produces a listing of the field bodies for header
50 fields with names matching the specified component, one per line. The
51 listing is numbered, starting at 1, if the -number switch is also used.
52 A tab character separates the number and the field body. The field
53 body is treated as if it is a file name, and only the final path name
54 component is listed. The complete field body is listed if the -text
55 switch is used; the argument to the -text switch is required but
56 ignored.
57 The -delete switch removes header fields from messages. The first
59 header field whose name matches the component is deleted if no other
60 options are specified. If the -text switch is used in conjunction with
61 the -delete switch, the first header field whose name matches the com‐
62 ponent and whose body matches the text is deleted. The text is treated
63 as if it was a file name; if it begins with a slash, the entire field
64 body must match the text, otherwise just the last path name component
65 of the field body must match. If the -number switch is used in con‐
66 junction with the -delete switch, header field num whose name matches
67 the component is deleted. The number matches that which is produced by
68 the -list switch. The special value all can be used for the number,
69 and causes all components that match the name to be deleted.
70 By default, anno changes the last-accessed and last-modified times on
72 annotated messages to the time of the annotation. anno preserves the
73 original times if the -preserve switch is used. A matching -nopreserve
74 switch allows time preservation to be turned off, if enabled in the
75 profile.
76
78 $HOME/.mh_profile The user's profile.
79
81 Path: To determine the user's nmh directory.
82 Current-Folder: To find the default current folder.
83
85 dist(1), forw(1), repl(1)
86
88 +folder The current folder.
89 msgs The current message.
90 -inplace
91 -date
92
94 If a folder is given, it will become the current folder. The first
95 message annotated will become the current message.
96nmh-1.7.1 2005-12-07 ANNO(1)