1ANNO(1)                     General Commands Manual                    ANNO(1)
2
3
4

NAME

6       anno - annotate nmh messages
7

SYNOPSIS

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

DESCRIPTION

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
19       The messages are either the msgs in the named folder, or the  draft  if
20       invoked with the -draft switch.
21
22       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
26       By using anno, you can perform arbitrary annotations of your own.  Each
27       message selected will be annotated with the lines
28
29           field: date
30           field: body
31
32       The -nodate switch inhibits the date annotation, leaving only the  body
33       annotation.
34
35       By  default, anno prepends the annotations to the message.  Annotations
36       are instead appended if the -append switch is specified.
37
38       If a -component field is not specified when anno is invoked, anno  will
39       prompt the user for a field name.
40
41       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
45       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
49       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 ig‐
56       nored.
57
58       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
71       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

FILES

78       $HOME/.mh_profile   The user's profile.
79

PROFILE COMPONENTS

81       Path:               To determine the user's nmh directory.
82       Current-Folder:     To find the default current folder.
83

SEE ALSO

85       dist(1), forw(1), repl(1)
86

DEFAULTS

88       +folder             The current folder.
89       msgs                The current message.
90       -inplace
91       -date
92

CONTEXT

94       If  a  folder  is  given, it will become the current folder.  The first
95       message annotated will become the current message.
96
97
98
99nmh-1.8                           2005-12-07                           ANNO(1)
Impressum