annotate doc/wmh.me @ 0:bce86c4163a3

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