git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/conf/doc/RCS/wmh.rf,v

   1 head     1.5;
   2 branch   ;
   3 access   ;
   4 symbols  ;
   5 locks    ; strict;
   6 comment  @@;
   7
   8
   9 1.5
  10 date     90.04.05.15.15.38;  author sources;  state Exp;
  11 branches ;
  12 next     1.4;
  13
  14 1.4
  15 date     90.03.22.11.31.57;  author sources;  state Exp;
  16 branches ;
  17 next     1.3;
  18
  19 1.3
  20 date     90.03.20.19.42.41;  author sources;  state Exp;
  21 branches ;
  22 next     1.2;
  23
  24 1.2
  25 date     90.03.20.17.36.55;  author sources;  state Exp;
  26 branches ;
  27 next     1.1;
  28
  29 1.1
  30 date     90.03.20.17.21.34;  author sources;  state Exp;
  31 branches ;
  32 next     ;
  33
  34
  35 desc
  36 @@
  37
  38
  39 1.5
  40 log
  41 @add ID
  42 @
  43 text
  44 @.\"    @@(MHWARNING)
  45 .\" @@(#)$Id:$
  46 .SC WMH 1
  47 .NA
  48 wmh \- window front\-end to MH
  49 .SY
  50 wmh
  51 \%[\-prompt\ string]
  52 \%[\-vmhproc\ program] \%[\-novmhproc]
  53 \%[switches\ for\ \fIvmhproc\fR]
  54 \%[\-help]
  55 .DE
  56 \fIwmh\fR is a program which implements the server side of
  57 the \fIMH\fR window management protocol
  58 and uses the Integrated Solutions Graphics Workstation desktop to maintain a
  59 multiple window interface to
  60 any program which implements the client side of the protocol.
  61 This latter program, called the \fIvmhproc\fR,
  62 is specified using the `\-vmhproc\ program' switch.
  63
  64 The upshot of all this is that one can run \fImsh\fR on an IS desktop
  65 and get a nice window interface.
  66 To do this, for example, just add the line
  67
  68 .ti +.5i
  69 mshproc: wmh
  70
  71 to your \&.mh\(ruprofile.
  72 (This takes advantage of the fact that
  73 \fImsh\fR is the default \fIvmhproc\fR for \fIwmh\fR.)
  74
  75 In order to facilitate things,
  76 if the `\-novmhproc' switch is given,
  77 and \fIwmh\fR can't run on the user's terminal
  78 (i.e., the terminal is not a desktop),
  79 the \fIvmhproc\fR is run directly without the window management protocol.
  80
  81 After initializing the protocol,
  82 \fIwmh\fR prompts the user for a command to be given to the client.
  83 Usually, this results in output being sent to one or more windows.
  84 If output to a window would cause it to scroll,
  85 \fIwmh\fR uses an elevator bar to scroll through the window.
  86 If click left is used inside the elevator bar,
  87 the user can direct \fIwmh\fR as to what portion of the output should be
  88 displayed;
  89 if click middle is used,
  90 the \*(lqpaging\*(rq menu is displayed;
  91 and,
  92 if click right is used,
  93 the window scrolls to the next page
  94 (or, the user explicitly moved to the end, the previous page).
  95
  96 The mouse can also be used while in the command window:
  97 click left does nothing;
  98 click middle brings up the \*(lqwmh\*(rq menu;
  99 and,
 100 click right shows the next message (a moby hack for timesavings).
 101 To abnormally terminate \fIwmh\fR (without core dump),
 102 use <QUIT> (usually CTRL\-\\).
 103 For instance,
 104 this does the \*(lqright\*(rq thing with \fIbbc\fR and \fImsh\fR.
 105 .Fi
 106 ^$HOME/\&.mh\(ruprofile~^The user profile
 107 .Pr
 108 ^Path:~^To determine the user's MH directory
 109 .Sa
 110 msh(1)
 111 .De
 112 `\-prompt\ (wmh)\ '
 113 .Ds
 114 `\-vmhproc\ msh'
 115 .Co
 116 None
 117 .Bu
 118 The argument to the `\-prompt' switch must be interpreted as a single token
 119 by the shell that invokes \fIwmh\fR.
 120 Therefore,
 121 one must usually place the argument to this switch inside double\-quotes.
 122
 123 At present,
 124 there is no way to pass signals (e.g., interrupt, quit) to the client.
 125 However,
 126 generating QUIT when \fIwmh\fR is reading a command from the terminal is
 127 sufficient to tell the client to go away quickly.
 128
 129 Acts strangely (loses peer or botches window management protocol with peer)
 130 on random occasions.
 131 .En
 132 @
 133
 134
 135 1.4
 136 log
 137 @put things back, do .NA stuff another way
 138 @
 139 text
 140 @d2 1
 141 @
 142
 143
 144 1.3
 145 log
 146 @typo
 147 @
 148 text
 149 @d2 2
 150 a3 2
 151 .TH WMH 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
 152 .SH .NA
 153 d5 1
 154 a5 1
 155 .SH .SY
 156 @
 157
 158
 159 1.2
 160 log
 161 @fixup for makewhatis
 162 @
 163 text
 164 @d2 1
 165 a2 1
 166 .TH WMH 1 [mh.6] MH
 167 @
 168
 169
 170 1.1
 171 log
 172 @Initial revision
 173 @
 174 text
 175 @d2 2
 176 a3 2
 177 .SC WMH 1
 178 .NA
 179 d5 1
 180 a5 1
 181 .SY
 182 @