Mercurial > hg > Applications > mh
comparison doc/wmh.me @ 0:bce86c4163a3
Initial revision
| author | kono |
|---|---|
| date | Mon, 18 Apr 2005 23:46:02 +0900 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| -1:000000000000 | 0:bce86c4163a3 |
|---|---|
| 1 .\" This file is automatically generated. Do not edit! | |
| 2 .\" @(#)$Id$ | |
| 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 |