1ANNO(1) [nmh-1.3] ANNO(1)
2
3
4
6 anno - annotate messages
7
9 anno [+folder] [msgs] [-component field] [-inplace | -noinplace] [-date
10 | -nodate] [-draft] [-append] [-list] [-delete] [-number
11 [num|all]] [-preserve | -nopreserve] [-version] [-help] [-text
12 body]
13
15 Anno manipulates header fields or annotations in messages. Header
16 fields consist of a field name and an optional field body as defined by
17 RFC-2822. The -component option specifies the field name, and the
18 -text option specifies the field body.
19
20 The messages are either the msgs in the named folder, or the draft if
21 invoked with the -draft option.
22
23 Usually, annotation is performed by the commands dist, forw, and repl,
24 if they are given the -anno switch. This allows you to keep track of
25 your distribution of, forwarding of, and replies to a message.
26
27 By using anno, you can perform arbitrary annotations of your own. Each
28 message selected will be annotated with the lines
29
30 field: date
31 field: body
32
33 The -nodate switch inhibits the date annotation, leaving only the body
34 annotation.
35
36 By default, anno prepends the annotations to the message. Annotations
37 are instead appended if the -append option is specified.
38
39 If a -component field is not specified when anno is invoked, anno will
40 prompt the user for the name of field for the annotation.
41
42 The field specified must be a valid 2822-style message field name,
43 which means that it may only consist of alphanumerics and dashes, The
44 body specified is arbitrary text.
45
46 Normally anno does the annotation inplace in order to preserve any
47 links to the message. You may change this by using the -noinplace
48 switch.
49
50 The -list option produces a listing of the field bodies for header
51 fields with names matching the specified component, one per line. The
52 listing is numbered, starting at 1, if the -number option is also used.
53 A tab character separates the number and the field body. The field
54 body is treated as if it is a file name, and only the final path name
55 component is listed. The complete field body is listed if the -text
56 option is used, the contents of the text are ignored.
57
58 The -delete option 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 option is used in conjunction with
61 the -delete option, 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 option is used in conjuc‐
66 tion with the -delete option, header field num whose name matches the
67 component is deleted. The number matches that which is produced by the
68 -list option. The special value all can be used for the number, and
69 causes all components that match the name to be deleted.
70
71 By default, anno changes the last-accessed and last-modified times on
72 annotate messages to the time at which the annotation occurs. Anno
73 preserves the original times if the -preserve option is used. A match‐
74 ing -nopreserve option exists that allows time preservation to be
75 turned off if enabled in the profile.
76
78 $HOME/.mh_profile The user profile
79
80
82 Path: To determine the user's nmh directory
83 Current-Folder: To find the default current folder
84
85
87 dist(1), forw(1), repl(1)
88
89
91 `+folder' defaults to the current folder
92 `msgs' defaults to cur
93 `-inplace'
94 `-date'
95
96
98 If a folder is given, it will become the current folder. The first
99 message annotated will become the current message.
100
101
102
103MH.6.8 1 June 2008 ANNO(1)