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

   1 .\"     This file is automatically generated.  Do not edit!
   2 .\" @(#)$Id: wmh.rf,v 1.5 90/04/05 15:15:38 sources Exp $
   3 .SC WMH 1
   4 .NA
   5 wmh \- window front\-end to MH
   6 .SY
   7 wmh
   8 \%[\-prompt\ string]
   9 \%[\-vmhproc\ program] \%[\-novmhproc]
  10 \%[switches\ for\ \fIvmhproc\fR]
  11 \%[\-help]
  12 .DE
  13 \fIwmh\fR is a program which implements the server side of
  14 the \fIMH\fR window management protocol
  15 and uses the Integrated Solutions Graphics Workstation desktop to maintain a
  16 multiple window interface to
  17 any program which implements the client side of the protocol.
  18 This latter program, called the \fIvmhproc\fR,
  19 is specified using the `\-vmhproc\ program' switch.
  20
  21 The upshot of all this is that one can run \fImsh\fR on an IS desktop
  22 and get a nice window interface.
  23 To do this, for example, just add the line
  24
  25 .ti +.5i
  26 mshproc: wmh
  27
  28 to your \&.mh\(ruprofile.
  29 (This takes advantage of the fact that
  30 \fImsh\fR is the default \fIvmhproc\fR for \fIwmh\fR.)
  31
  32 In order to facilitate things,
  33 if the `\-novmhproc' switch is given,
  34 and \fIwmh\fR can't run on the user's terminal
  35 (i.e., the terminal is not a desktop),
  36 the \fIvmhproc\fR is run directly without the window management protocol.
  37
  38 After initializing the protocol,
  39 \fIwmh\fR prompts the user for a command to be given to the client.
  40 Usually, this results in output being sent to one or more windows.
  41 If output to a window would cause it to scroll,
  42 \fIwmh\fR uses an elevator bar to scroll through the window.
  43 If click left is used inside the elevator bar,
  44 the user can direct \fIwmh\fR as to what portion of the output should be
  45 displayed;
  46 if click middle is used,
  47 the \*(lqpaging\*(rq menu is displayed;
  48 and,
  49 if click right is used,
  50 the window scrolls to the next page
  51 (or, the user explicitly moved to the end, the previous page).
  52
  53 The mouse can also be used while in the command window:
  54 click left does nothing;
  55 click middle brings up the \*(lqwmh\*(rq menu;
  56 and,
  57 click right shows the next message (a moby hack for timesavings).
  58 To abnormally terminate \fIwmh\fR (without core dump),
  59 use <QUIT> (usually CTRL\-\\).
  60 For instance,
  61 this does the \*(lqright\*(rq thing with \fIbbc\fR and \fImsh\fR.
  62 .Fi
  63 ^$HOME/\&.mh\(ruprofile~^The user profile
  64 .Pr
  65 ^Path:~^To determine the user's MH directory
  66 .Sa
  67 msh(1)
  68 .De
  69 `\-prompt\ (wmh)\ '
  70 .Ds
  71 `\-vmhproc\ msh'
  72 .Co
  73 None
  74 .Bu
  75 The argument to the `\-prompt' switch must be interpreted as a single token
  76 by the shell that invokes \fIwmh\fR.
  77 Therefore,
  78 one must usually place the argument to this switch inside double\-quotes.
  79
  80 At present,
  81 there is no way to pass signals (e.g., interrupt, quit) to the client.
  82 However,
  83 generating QUIT when \fIwmh\fR is reading a command from the terminal is
  84 sufficient to tell the client to go away quickly.
  85
  86 Acts strangely (loses peer or botches window management protocol with peer)
  87 on random occasions.
  88 .En