diplodocus.org Git - nmh/blob - man/anno.man

   1 .TH ANNO %manext1% 2005-12-07 "%nmhversion%"
   2 .
   3 .\" %nmhwarning%
   4 .
   5 .SH NAME
   6 anno \- annotate nmh messages
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B anno
  11 .RB [ \-help ]
  12 .RB [ \-version ]
  13 .RI [ +folder ]
  14 .RI [ msgs ]
  15 .RB [ \-component
  16 .IR field ]
  17 .RB [ \-inplace " | " \-noinplace ]
  18 .RB [ \-date " | " \-nodate ]
  19 .RB [ \-draft ]
  20 .RB [ \-append ]
  21 .RB [ \-list ]
  22 .RB [ \-delete ]
  23 .RB [ \-number
  24 .IR [ num|all ]]
  25 .RB [ \-preserve " | " \-nopreserve ]
  26 .RB [ \-text
  27 .IR body ]
  28 .ad
  29 .SH DESCRIPTION
  30 .B anno
  31 manipulates header fields or
  32 .I annotations
  33 in messages.
  34 Header fields consist of a field name and an optional field body
  35 as defined by RFC 2822.
  36 The
  37 .B -component
  38 switch specifies the field name, and the
  39 .B -text
  40 switch specifies the field body.
  41 .PP
  42 The messages are either the
  43 .I msgs
  44 in the named folder, or the draft if invoked with the
  45 .B -draft
  46 switch.
  47 .PP
  48 Usually, annotation is performed by the commands
  49 .BR dist ,
  50 .BR forw ,
  51 and
  52 .BR repl ,
  53 if they are given the
  54 .B \-anno
  55 switch.  This allows you to keep track of your distribution of,
  56 forwarding of, and replies to a message.
  57 .PP
  58 By using
  59 .BR anno ,
  60 you can perform arbitrary annotations of your own.
  61 Each message selected will be annotated with the lines
  62 .PP
  63     field:\ date
  64     field:\ body
  65 .PP
  66 The
  67 .B \-nodate
  68 switch inhibits the date annotation, leaving only the
  69 body annotation.
  70 .PP
  71 By default,
  72 .B anno
  73 prepends the annotations to the message.
  74 Annotations are instead appended if the
  75 .B -append
  76 switch is specified.
  77 .PP
  78 If a
  79 .B \-component
  80 .I field
  81 is not specified when
  82 .B anno
  83 is invoked,
  84 .B anno
  85 will prompt the user for a field name.
  86 .PP
  87 The field specified must be a valid RFC 2822-style message field name,
  88 consisting only of alphanumeric characters and dashes.
  89 The body may consist of arbitrary text.
  90 .PP
  91 Normally
  92 .B anno
  93 does the annotation in place in order to preserve
  94 any links to the message.  You may change this by using the
  95 .B \-noinplace
  96 switch.
  97 .PP
  98 The
  99 .B -list
 100 switch produces a listing of the field bodies for header fields with
 101 names matching the specified component, one per line.
 102 The listing is numbered, starting at 1, if the
 103 .B -number
 104 switch is also used.
 105 A tab character separates the number and the field body.
 106 The field body is treated as if it is a file name, and only the final
 107 path name component is listed.
 108 The complete field body is listed if the
 109 .B -text
 110 switch is used; the argument to the
 111 .B -text
 112 switch is required but ignored.
 113 .PP
 114 The
 115 .B -delete
 116 switch removes header fields from messages.
 117 The first header field whose name matches the component is deleted if
 118 no other options are specified.
 119 If the
 120 .B -text
 121 switch is used in conjunction with the
 122 .B -delete
 123 switch, the first header field whose name matches the component and
 124 whose body matches the text is deleted.
 125 The text is treated as if it was a file name; if it begins with a
 126 slash, the entire field body must match the text, otherwise just the
 127 last path name component of the field body must match.
 128 If the
 129 .B -number
 130 switch is used in conjunction with the
 131 .B -delete
 132 switch, header field
 133 .I num
 134 whose name matches the component is deleted.
 135 The number matches that which is produced by the
 136 .B -list
 137 switch.
 138 The special value
 139 .B all
 140 can be used for the number, and causes all components that match the
 141 name to be deleted.
 142 .PP
 143 By default,
 144 .B anno
 145 changes the last-accessed and last-modified times on annotated messages
 146 to the time of the annotation.
 147 .B anno
 148 preserves the original times if the
 149 .B -preserve
 150 switch is used.
 151 A matching
 152 .B -nopreserve
 153 switch allows time preservation to be turned off, if enabled
 154 in the profile.
 155 .SH FILES
 156 .TP 20
 157 $HOME/.mh_profile
 158 The user's profile.
 159 .SH "PROFILE COMPONENTS"
 160 .PD 0
 161 .TP 20
 162 Path:
 163 To determine the user's nmh directory.
 164 .TP
 165 Current\-Folder:
 166 To find the default current folder.
 167 .PD
 168 .SH "SEE ALSO"
 169 .IR dist (1),
 170 .IR forw (1),
 171 .IR repl (1)
 172 .SH DEFAULTS
 173 .PD 0
 174 .TP 20
 175 +folder
 176 The current folder.
 177 .TP
 178 msgs
 179 The current message.
 180 .TP
 181 -inplace
 182 .TP
 183 -date
 184 .PD
 185 .SH CONTEXT
 186 If a folder is given, it will become the current folder.  The first
 187 message annotated will become the current message.