git.marmaro.de Git - mmh/blob - man/repl.man1

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 repl \- reply to a message
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B repl
  11 .RI [ +folder ]
  12 .RI [ msgs ]
  13 .RB [ \-annotate " | " \-noannotate ]
  14 .RB [ \-group " | " \-nogroup ]
  15 .RB [ \-cc
  16 all/to/cc/me]
  17 .RB [ \-nocc
  18 all/to/cc/me]
  19 .RB [ \-query " | " \-noquery ]
  20 .RB [ \-form
  21 .IR formfile ]
  22 .RB [ \-format " | " \-noformat ]
  23 .RB [ \-filter
  24 .IR filterfile ]
  25 .RB [ \-inplace " | " \-noinplace ]
  26 .RB [ \-mime " | " \-nomime ]
  27 .RB [ \-fcc
  28 .IR +folder ]
  29 .RB [ \-editor
  30 .IR editor ]
  31 .RB [ \-noedit ]
  32 .RB [ \-whatnowproc
  33 .IR program ]
  34 .RB [ \-nowhatnowproc ]
  35 .RB [ \-build ]
  36 .RB [ \-file
  37 .IR msgfile ]
  38 .RB [ \-version ]
  39 .RB [ \-help ]
  40 .ad
  41 .SH DESCRIPTION
  42 .B Repl
  43 may be used to produce a reply to an existing message.
  44 .PP
  45 In its simplest form (with no arguments),
  46 .B repl
  47 will set up a
  48 message\-form skeleton in reply to the current message in the current
  49 folder, and invoke the whatnow shell.
  50 .PP
  51 In order to construct the message draft of the reply,
  52 .B repl
  53 uses
  54 a reply template to guide its actions.  A reply template is simply a
  55 .B mhl
  56 format file (see
  57 .BR mh\-format (5)
  58 for details).
  59 .PP
  60 If the switch
  61 .B \-nogroup
  62 is given (it is on by default), then
  63 .B repl
  64 will use the standard forms file \*(lqreplcomps\*(rq.  This will construct
  65 a draft message that is intended to be sent only to the author of the
  66 message to which you are replying.  If a file named \*(lqreplcomps\*(rq
  67 exists in the user's
  68 .B mmh
  69 directory, it will be used instead of this
  70 default forms file.
  71 .PP
  72 The default reply template \*(lqreplcomps\*(rq will direct
  73 .B repl
  74 to construct the reply message draft as follows:
  75 .PP
  76 .RS 5
  77 .nf
  78 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
  79 Cc: <To> and <Cc> and <personal address>
  80 Fcc: {fcc switch} or +sent
  81 Subject: Re: <Subject>
  82 In\-Reply\-To: <Message\-Id>
  83 References: <Message\-Id>
  84 Comments: In\-Reply\-To <From> or <apparently from> or <Sender>
  85 .ti +3
  86 message dated <date>
  87 --------
  88 .fi
  89 .RE
  90 .PP
  91 where field names enclosed in angle brackets (<\ >) indicate the
  92 contents of the named field from the message to which the reply is
  93 being made.
  94 .PP
  95 By default, the \*(lqCc:\*(rq field is empty.  You may selectively add
  96 addresses to this default with the
  97 .B \-cc
  98 .I type
  99 switch.  This switch takes an
 100 argument (
 101 .IR all / to / cc / me )
 102 which specifies who gets added to the default
 103 \*(lqCc:\*(rq list of the reply.  You may give this switch multiple times (with
 104 different arguments) if you wish to add multiple types of addresses.
 105 .PP
 106 If the switch
 107 .B \-group
 108 is given, then
 109 .B repl
 110 will use the the
 111 standard forms file \*(lqreplgroupcomps\*(rq.  This will construct a
 112 draft message that is intended as a group or followup reply.  If a file
 113 named \*(lqreplgroupcomps\*(rq exists in the user's mmh directory, it
 114 will be used instead of this default forms file.
 115 .PP
 116 The default group reply template \*(lqreplgroupcomps\*(rq will direct
 117 .B repl
 118 to construct the reply message draft as follows:
 119 .PP
 120 .RS 5
 121 .nf
 122 To: <Mail\-Followup\-To>
 123 Subject: Re: <Subject>
 124 In\-Reply\-To: Message from <From> of <Date>.
 125 .ti +\w'In\-Reply\-To: 'u
 126 <Message\-Id>
 127 --------
 128 .fi
 129 .RE
 130 .PP
 131 or if the field <Mail\-Followup\-To> is not available:
 132 .PP
 133 .RS 5
 134 .nf
 135 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
 136 Cc: <To> and <Cc> and <personal address>
 137 Subject: Re: <Subject>
 138 In\-Reply\-To: Message from <From> of <Date>.
 139 .ti +\w'In\-Reply\-To: 'u
 140 <Message\-Id>
 141 --------
 142 .fi
 143 .RE
 144 .PP
 145 By default, the \*(lqCc:\*(rq contains all the addresses shown.  You may
 146 selectively remove addresses from this default with the
 147 .B \-nocc
 148 .I type
 149 switch.
 150 This switch takes an argument (
 151 .IR all / to / cc / me )
 152 which specifies who gets removed
 153 from the default \*(lqCc:\*(rq list of the reply.  You may give this switch
 154 multiple times (with different arguments) if you wish to remove multiple types
 155 of addresses.
 156 .PP
 157 In any case, you may specify an alternate forms file with the switch
 158 .B \-form
 159 .IR formfile .
 160 .PP
 161 The
 162 .B \-query
 163 switch modifies the action of
 164 .B \-nocc
 165 .I type
 166 switch by
 167 interactively asking you if each address that normally would be placed in
 168 the \*(lqTo:\*(rq and \*(lqCc:\*(rq list should actually be sent a copy.
 169 This is useful for special\-purpose replies.  Note that the position of
 170 the
 171 .B \-cc
 172 and
 173 .B \-nocc
 174 switches, like all other switches which take a
 175 positive and negative form, is important.
 176 .PP
 177 Lines beginning with the fields \*(lqTo:\*(rq, \*(lqCc:\*(rq, and
 178 \*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
 179 In addition, these fields will be wrapped at a reasonable length.
 180 .PP
 181 See
 182 .BR comp (1)
 183 for a description of the
 184 .B \-editor
 185 and
 186 .B \-noedit
 187 switches.  Note that while in the editor, the message being replied
 188 to is available through a link named \*(lq@\*(rq (assuming the default
 189 .IR whatnowproc ).
 190 In addition, the actual pathname of the message is
 191 stored in the environment variable
 192 .BR $editalt ,
 193 and the pathname of
 194 the folder containing the message is stored in the environment variable
 195 .BR $mhfolder .
 196 .PP
 197 Although
 198 .B repl
 199 uses a forms file to direct it how to construct
 200 the beginning of the draft, it uses a message filter file to direct
 201 it as to how the message to which you are replying should be filtered
 202 (re\-formatted) in the body of the draft.  The filter file for
 203 .B repl
 204 should be a standard form file for
 205 .BR mhl ,
 206 as
 207 .B repl
 208 will invoke
 209 .B mhl
 210 to format the message to which you are replying.
 211 .PP
 212 The switches
 213 .BR \-noformat ,
 214 .BR \-format ,
 215 and
 216 .B \-filter
 217 .I filterfile
 218 specify
 219 which message filter file to use.
 220 .PP
 221 If the switch
 222 .B \-noformat
 223 is given (it is the default), then the message
 224 to which you are replying is not included in the body of the draft.
 225 .PP
 226 If the switch
 227 .B \-format
 228 is given, then a default message filter file
 229 is used.  This default message filter should be adequate for most users.
 230 This default filter
 231 .RI \*(lq mhl.reply \*(rq
 232 is:
 233 .PP
 234 .RS 5
 235 .nf
 236 %mhl_reply%
 237 .fi
 238 .RE
 239 .PP
 240 which outputs each line of the body of the message prefaced with the
 241 \*(lq>\*(rq character and a space.
 242 .PP
 243 If a file named
 244 .RI \*(lq mhl.reply \*(rq
 245 exists in the user's
 246 .B mmh
 247 directory,
 248 it will be used instead of this form.  You may specify an alternate
 249 message filter file with the switch
 250 .B \-filter
 251 .IR filterfile .
 252 .PP
 253 Other reply filters are commonly used, such as:
 254 .PP
 255 .RS 5
 256 .nf
 257 :
 258 body:nocomponent,compwidth=9,offset=9
 259 .fi
 260 .RE
 261 .PP
 262 which says to output a blank line and then the body of the message
 263 being replied\-to, indented by one tab\-stop.  Another popular format
 264 is:
 265 .PP
 266 .RS 5
 267 .nf
 268 message-id:nocomponent,\|nonewline,\\
 269 formatfield=\*(lqIn message %{text},\ \*(rq
 270 from:nocomponent,\|formatfield=\*(lq%(decode(friendly{text})) writes:\*(rq
 271 body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
 272 .fi
 273 .RE
 274 .PP
 275 This message filter file cites the Message-ID and author of the message
 276 being replied\-to, and then outputs each line of the body prefaced with
 277 the \*(lq>\*(rq character.
 278 .PP
 279 To use the MIME rules for encapsulation, specify the
 280 .B \-mime
 281 switch.
 282 This directs
 283 .B repl
 284 to add an attachment header field, for which
 285 .B send
 286 will care.
 287 .PP
 288 If the
 289 .B \-annotate
 290 switch is given, the message being replied\-to will
 291 be annotated with the lines
 292 .PP
 293 .RS 5
 294 Replied:\ date
 295 Replied:\ addrs
 296 .RE
 297 .PP
 298 where the address list contains one line for each addressee.
 299 The annotation will be done only if the message is sent directly from
 300 .BR repl .
 301 If the message is not sent immediately from
 302 .BR repl ,
 303 .RB \*(lq "comp\ \-use" \*(rq
 304 may be used to re\-edit and send the constructed
 305 message, but the annotations won't take place.  Normally annotations are
 306 done inplace in order to preserve any links to the message.  You may use
 307 the
 308 .B \-noinplace
 309 switch to change this.
 310 .PP
 311 Although the default template specifies that a copy of the reply will be
 312 put in
 313 the folder 'sent',
 314 if the
 315 .B \-fcc
 316 .I +folder
 317 switch is given it will override the default value.
 318 More than one folder, each preceded by
 319 .B \-fcc
 320 can
 321 be named.
 322 .PP
 323 In addition to the standard
 324 .BR mh\-format (5)
 325 escapes,
 326 .B repl
 327 also recognizes the following additional
 328 .I component
 329 escape:
 330 .PP
 331 .RS 5
 332 .nf
 333 .ta \w'Escape  'u +\w'Returns  'u
 334 .I Escape       Returns Description
 335 fcc     string  Any folders specified with `\-fcc\ folder'
 336 .fi
 337 .RE
 338 .PP
 339 To avoid reiteration,
 340 .B repl
 341 strips any leading `Re: ' strings from
 342 the
 343 .I subject
 344 component.
 345 .PP
 346 Consult the
 347 .BR mh-draft (7)
 348 man page for more
 349 information.
 350 .PP
 351 Upon exiting from the editor,
 352 .B repl
 353 will invoke the
 354 .B whatnow
 355 program.  See
 356 .BR whatnow (1)
 357 for a discussion of available
 358 options.  The invocation of this program can be inhibited by using the
 359 .B \-nowhatnowproc
 360 switch.  (In truth of fact, it is the
 361 .B whatnow
 362 program which starts the initial edit.  Hence,
 363 .B \-nowhatnowproc
 364 will
 365 prevent any edit from occurring.)
 366 .PP
 367 The
 368 .B \-build
 369 switch is intended to be used by the Emacs mh-e interface
 370 to
 371 .BR nmh ,
 372 and is only present if
 373 .B nmh
 374 was compiled with support
 375 for mh-e. It implies
 376 .BR \-nowhatnowproc .
 377 It causes a file
 378 .I reply (in the mail storage root)
 379 to be created, containing the draft message that would normally be presented
 380 to the user for editing.
 381 No mail is actually sent. Note that this switch is not guaranteed to
 382 be present or to have the same effects in future versions of
 383 .BR nmh :
 384 it is documented here only for completeness.
 385 .PP
 386 The
 387 .B \-file
 388 .I msgfile
 389 switch specifies the message to be replied to as an
 390 exact filename rather than as an
 391 .B nmh
 392 folder and message number. It is
 393 intended to be used by the
 394 .B msh
 395 interface to
 396 .BR nmh .
 397 The same caveats apply to this option as to the
 398 .B \-build
 399 switch.
 400
 401 .SH FILES
 402 .fc ^ ~
 403 .nf
 404 .ta \w'%etcdir%/ExtraBigFileName  'u
 405 ^%etcdir%/replcomps~^The standard reply template
 406 ^or $HOME/.mmh/replcomps~^Rather than the standard template
 407 ^%etcdir%/replgroupcomps~^The standard `reply -group' template
 408 ^or $HOME/.mmh/replgroupcomps~^Rather than the standard template
 409 ^%etcdir%/mhl.reply~^The standard message filter
 410 ^or $HOME/.mmh/mhl.reply~^Rather than the standard filter
 411 ^$HOME/.mmh/profile~^The user profile
 412 ^+drafts~^The draft folder
 413 .fi
 414
 415 .SH "PROFILE COMPONENTS"
 416 .fc ^ ~
 417 .nf
 418 .ta 2.4i
 419 .ta \w'ExtraBigProfileName  'u
 420 ^Path:~^To determine the user's mail storage
 421 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
 422 ^Current\-Folder:~^To find the default current folder
 423 ^Draft\-Folder:~^To set the default draft\-folder
 424 ^Editor:~^To override the default editor
 425 ^Msg\-Protect:~^To set mode when creating a new message (draft)
 426 ^fileproc:~^Program to refile the message
 427 ^mhlproc:~^Program to filter message being replied\-to
 428 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 429 .fi
 430
 431 .SH "SEE ALSO"
 432 mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
 433
 434 .SH DEFAULTS
 435 .nf
 436 .RB ` +folder "' defaults to the current folder"
 437 .RB ` msg "' defaults to cur"
 438 .RB ` \-nogroup '
 439 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
 440 .RB ` \-noannotate '
 441 .RB ` \-noformat '
 442 .RB ` \-inplace '
 443 .RB ` \-nomime '
 444 .RB ` \-noquery '
 445 .fi
 446
 447 .SH CONTEXT
 448 If a folder is given, it will become the current folder.  The message
 449 replied\-to will become the current message.
 450
 451 .SH BUGS
 452 If any addresses occur in the reply template, addresses in the template
 453 that do not contain hosts are defaulted incorrectly.  Instead of using
 454 the localhost for the default,
 455 .B repl
 456 uses the sender's host.
 457 Moral of the story: if you're going to include addresses in a reply
 458 template, include the host portion of the address.
 459 .PP
 460 If
 461 .I whatnowproc
 462 is
 463 .BR whatnow ,
 464 then
 465 .B repl
 466 uses a built\-in
 467 .BR whatnow ,
 468 it does not actually run the
 469 .B whatnow
 470 program.
 471 Hence, if you define your own
 472 .IR whatnowproc ,
 473 don't call it
 474 .B whatnow
 475 since
 476 .B repl
 477 won't run it.
 478 .PP
 479 If your current working directory is not writable, the link named
 480 \*(lq@\*(rq is not available.