0
|
1 .\" This file is automatically generated. Do not edit!
|
|
2 .\" @(#)$Id$
|
|
3 .SC VMH 1
|
|
4 .NA
|
|
5 vmh \- visual front-end to MH
|
|
6 .SY
|
|
7 vmh
|
|
8 \%[\-prompt\ string]
|
|
9 \%[\-vmhproc\ program] \%[\-novmhproc]
|
|
10 \%[switches\ for\ \fIvmhproc\fR]
|
|
11 \%[\-help]
|
|
12 .DE
|
|
13 \fIvmh\fR is a program which implements the server side of
|
|
14 the \fIMH\fR window management protocol
|
|
15 and uses \fIcurses\fR\0(3) routines to maintain a split\-screen interface to
|
|
16 any program which implements the client side of the protocol.
|
|
17 This latter program, called the \fIvmhproc\fR,
|
|
18 is specified using the `\-vmhproc\ program' switch.
|
|
19
|
|
20 The upshot of all this is that one can run \fImsh\fR on a display terminal
|
|
21 and get a nice visual interface.
|
|
22 To do this, for example, just add the line
|
|
23
|
|
24 .ti +.5i
|
|
25 mshproc: vmh
|
|
26
|
|
27 to your \&.mh\(ruprofile.
|
|
28 (This takes advantage of the fact that
|
|
29 \fImsh\fR is the default \fIvmhproc\fR for \fIvmh\fR.)
|
|
30
|
|
31 In order to facilitate things,
|
|
32 if the `\-novmhproc' switch is given,
|
|
33 and \fIvmh\fR can't run on the user's terminal,
|
|
34 the \fIvmhproc\fR is run directly without the window management protocol.
|
|
35
|
|
36 After initializing the protocol,
|
|
37 \fIvmh\fR prompts the user for a command to be given to the client.
|
|
38 Usually, this results in output being sent to one or more windows.
|
|
39 If a output to a window would cause it to scroll,
|
|
40 \fIvmh\fR prompts the user for instructions,
|
|
41 roughly permitting the capabilities of \fIless\fR or \fImore\fR
|
|
42 (e.g., the ability to scroll backwards and forwards):
|
|
43
|
|
44 .nf
|
|
45 .in +.5i
|
|
46 .ta \w'RETURN 'u +\w'* 'u
|
|
47 SPACE advance to the next windowful
|
|
48 RETURN * advance to the next line
|
|
49 y * retreat to the previous line
|
|
50 d * advance to the next ten lines
|
|
51 u * retreat to the previous ten lines
|
|
52 g * go to an arbitrary line
|
|
53 (preceed g with the line number)
|
|
54 G * go to the end of the window
|
|
55 (if a line number is given, this acts like `g')
|
|
56 CTRL\-L refresh the entire screen
|
|
57 h print a help message
|
|
58 q abort the window
|
|
59 .re
|
|
60 .in -.5i
|
|
61 .fi
|
|
62
|
|
63 (A `*' indicates that a numeric prefix is meaningful for this command.)
|
|
64
|
|
65 Note that if a command resulted in more than one window's worth of
|
|
66 information being displayed,
|
|
67 and you allow the command which is generating information for the window to
|
|
68 gracefully finish
|
|
69 (i.e., you don't use the `q' command to abort information being sent to the
|
|
70 window),
|
|
71 then \fIvmh\fR will give you one last change to peruse the window.
|
|
72 This is useful for scrolling back and forth.
|
|
73 Just type `q' when you're done.
|
|
74
|
|
75 To abnormally terminate \fIvmh\fR (without core dump),
|
|
76 use <QUIT> (usually CTRL\-\\).
|
|
77 For instance,
|
|
78 this does the \*(lqright\*(rq thing with \fIbbc\fR and \fImsh\fR.
|
|
79 .Fi
|
|
80 ^$HOME/\&.mh\(ruprofile~^The user profile
|
|
81 .Pr
|
|
82 ^Path:~^To determine the user's MH directory
|
|
83 .Sa
|
|
84 msh(1)
|
|
85 .De
|
|
86 `\-prompt\ (vmh)\ '
|
|
87 .Ds
|
|
88 `\-vmhproc\ msh'
|
|
89 .Co
|
|
90 None
|
|
91 .Bu
|
|
92 The argument to the `\-prompt' switch must be interpreted as a single token
|
|
93 by the shell that invokes \fIvmh\fR.
|
|
94 Therefore,
|
|
95 one must usually place the argument to this switch inside double\-quotes.
|
|
96
|
|
97 At present,
|
|
98 there is no way to pass signals (e.g., interrupt, quit) to the client.
|
|
99 However,
|
|
100 generating QUIT when \fIvmh\fR is reading a command from the terminal is
|
|
101 sufficient to tell the client to go away quickly.
|
|
102
|
|
103 Acts strangely (loses peer or botches window management protocol with peer)
|
|
104 on random occasions.
|
|
105 .En
|