8 date 92.05.12.22.23.34; author jromine; state Exp;
13 date 90.04.05.15.15.32; author sources; state Exp;
18 date 90.03.22.11.31.54; author sources; state Exp;
23 date 90.03.20.19.42.37; author sources; state Exp;
28 date 90.03.20.17.36.52; author sources; state Exp;
33 date 90.03.20.17.21.32; author sources; state Exp;
44 @fixup for nroff problems
48 .\" @@(#)$Id: vmh.rf,v 1.5 1990/04/05 15:15:32 sources Exp jromine $
51 vmh \- visual front-end to MH
55 \%[\-vmhproc\ program] \%[\-novmhproc]
56 \%[switches\ for\ \fIvmhproc\fR]
59 \fIvmh\fR is a program which implements the server side of
60 the \fIMH\fR window management protocol
61 and uses \fIcurses\fR\0(3) routines to maintain a split\-screen interface to
62 any program which implements the client side of the protocol.
63 This latter program, called the \fIvmhproc\fR,
64 is specified using the `\-vmhproc\ program' switch.
66 The upshot of all this is that one can run \fImsh\fR on a display terminal
67 and get a nice visual interface.
68 To do this, for example, just add the line
73 to your \&.mh\(ruprofile.
74 (This takes advantage of the fact that
75 \fImsh\fR is the default \fIvmhproc\fR for \fIvmh\fR.)
77 In order to facilitate things,
78 if the `\-novmhproc' switch is given,
79 and \fIvmh\fR can't run on the user's terminal,
80 the \fIvmhproc\fR is run directly without the window management protocol.
82 After initializing the protocol,
83 \fIvmh\fR prompts the user for a command to be given to the client.
84 Usually, this results in output being sent to one or more windows.
85 If a output to a window would cause it to scroll,
86 \fIvmh\fR prompts the user for instructions,
87 roughly permitting the capabilities of \fIless\fR or \fImore\fR
88 (e.g., the ability to scroll backwards and forwards):
92 .ta \w'RETURN 'u +\w'* 'u
93 SPACE advance to the next windowful
94 RETURN * advance to the next line
95 y * retreat to the previous line
96 d * advance to the next ten lines
97 u * retreat to the previous ten lines
98 g * go to an arbitrary line
99 (preceed g with the line number)
100 G * go to the end of the window
101 (if a line number is given, this acts like `g')
102 CTRL\-L refresh the entire screen
103 h print a help message
109 (A `*' indicates that a numeric prefix is meaningful for this command.)
111 Note that if a command resulted in more than one window's worth of
112 information being displayed,
113 and you allow the command which is generating information for the window to
115 (i.e., you don't use the `q' command to abort information being sent to the
117 then \fIvmh\fR will give you one last change to peruse the window.
118 This is useful for scrolling back and forth.
119 Just type `q' when you're done.
121 To abnormally terminate \fIvmh\fR (without core dump),
122 use <QUIT> (usually CTRL\-\\).
124 this does the \*(lqright\*(rq thing with \fIbbc\fR and \fImsh\fR.
126 ^$HOME/\&.mh\(ruprofile~^The user profile
128 ^Path:~^To determine the user's MH directory
138 The argument to the `\-prompt' switch must be interpreted as a single token
139 by the shell that invokes \fIvmh\fR.
141 one must usually place the argument to this switch inside double\-quotes.
144 there is no way to pass signals (e.g., interrupt, quit) to the client.
146 generating QUIT when \fIvmh\fR is reading a command from the terminal is
147 sufficient to tell the client to go away quickly.
149 Acts strangely (loses peer or botches window management protocol with peer)
165 vmh \- visual front\-end to MH
171 @put things back, do .NA stuff another way
185 .TH VMH 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
195 @fixup for makewhatis