git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/doc/prompter.me

   1 .\"     This file is automatically generated.  Do not edit!
   2 .\" @(#)$Id: prompter.rf,v 1.8 1992/05/12 22:23:34 jromine Exp $
   3 .SC PROMPTER 1
   4 .NA
   5 prompter \- prompting editor front-end for MH
   6 .SY
   7 prompter
   8 \%[\-erase\ chr]
   9 \%[\-kill\ chr]
  10 \%[\-prepend] \%[\-noprepend]
  11 \%[\-rapid] \%[\-norapid]
  12 \%[\-doteof] \%[\-nodoteof]
  13 file
  14 \%[\-help]
  15 .DE
  16 This program is normally not invoked directly by users
  17 but takes the place of an editor and acts as an editor front\-end.
  18 It operates on an 822\-style message draft skeleton specified by file,
  19 normally provided by \fIcomp\fR, \fIdist\fR, \fIforw\fR, or \fIrepl\fR.
  20
  21 \fIPrompter\fR is an editor which allows rapid composition of
  22 messages.
  23 It is particularly useful to network and low\-speed
  24 (less than 2400 baud) users of \fIMH\fR.
  25 It is an \fIMH\fR program in that
  26 it can have its own profile entry with switches,
  27 but it is not invoked directly by the user.
  28 The commands \fIcomp\fR, \fIdist\fR, \fIforw\fR, and \fIrepl\fR
  29 invoke \fIprompter\fR as an editor,
  30 either when invoked with `\-editor\ prompter',
  31 or by the profile entry \*(lqEditor:\ prompter\*(rq,
  32 or when given the command `edit\ prompter' at \*(lqWhat now?\*(rq level.
  33
  34 For each empty component \fIprompter\fR finds in the draft,
  35 the user is prompted for a response;
  36 A <RETURN> will cause the whole component to be left out.
  37 Otherwise,
  38 a `\\' preceding a <RETURN> will continue the response on the next line,
  39 allowing for multiline components.
  40 Continuation lines \fBmust\fR begin with a space or tab.
  41
  42 Each non\-empty component is copied to the draft and displayed on the
  43 terminal.
  44
  45 The start of the message body is denoted by a blank line or a line of dashes.
  46 If the body is non\-empty, the prompt, which isn't written to the file, is
  47
  48     \*(lq--------Enter additional text\*(rq,
  49
  50 or (if `\-prepend' was given)
  51
  52     \*(lq--------Enter initial text\*(rq.
  53
  54 Message\-body typing is terminated with an end\-of\-file (usually CTRL\-D).
  55 With the `\-doteof' switch, a period on a line all by itself also signifies
  56 end\-of\-file.
  57 At this point control is returned to the calling program,
  58 where the user is asked \*(lqWhat now?\*(rq.
  59 See \fIwhatnow\fR for the valid options to this query.
  60
  61 By using the `\-prepend' switch, the user can add type\-in to the beginning
  62 of the message body and have the rest of the body follow.
  63 This is useful for the \fIforw\fR command.
  64
  65 By using the `\-rapid' switch,
  66 if the draft already contains text in the message\-body,
  67 it is not displayed on the user's terminal.
  68 This is useful for low\-speed terminals.
  69
  70 The line editing characters for kill and erase may be
  71 specified by the user via the arguments `\-kill\ chr' and `\-erase\ chr',
  72 where chr may be a character; or `\\nnn', where \*(lqnnn\*(rq is the
  73 octal value for the character.
  74
  75 An interrupt (usually CTRL\-C) during component typing will abort
  76 \fIprompter\fR and the \fIMH\fR command that invoked it.
  77 An interrupt during message\-body typing is equivalent to CTRL\-D,
  78 for historical reasons.
  79 This means that \fIprompter\fR should finish up and exit.
  80
  81 The first non\-flag argument to \fIprompter\fR
  82 is taken as the name of the draft file, and
  83 subsequent non\-flag arguments are ignored.
  84 .\" (\fIRepl\fR invokes editors with two file arguments:
  85 .\" the draft file name and the replied\-to message file name.)
  86 .Fi
  87 ^$HOME/\&.mh\(ruprofile~^The user profile
  88 ^/tmp/prompter*~^Temporary copy of message
  89 .Pr
  90 prompter\-next: To name the editor to be used on exit from \fIprompter\fR
  91 .Ps
  92 ^Msg\-Protect:~^To set mode when creating a new draft
  93 .Sa
  94 comp(1), dist(1), forw(1), repl(1), whatnow(1)
  95 .De
  96 `\-prepend'
  97 .Ds
  98 `\-norapid'
  99 .Ds
 100 `\-nodoteof'
 101 .Co
 102 None
 103 .Hh
 104 The `\-rapid' option is particularly useful with \fIforw\fP, and
 105 `\-noprepend' is useful with \fIcomp\ \-use\fP.
 106
 107 The user may wish to link \fIprompter\fR under several names
 108 (e.g., \*(lqrapid\*(rq) and give appropriate switches
 109 in the profile entries under these names (e.g., \*(lqrapid: -rapid\*(rq).
 110 This facilitates invoking prompter differently for
 111 different \fIMH\fP commands (e.g., \*(lqforw: -editor rapid\*(rq).
 112 .Bu
 113 \fIPrompter\fR uses \fIstdio\fR\0(3), so it will lose if you edit files
 114 with nulls in them.
 115 .En