4.3BSD-UWisc/man/catl/vmh.l

VMH(1)              UNIX Programmer's Manual               VMH(1)



NAME
     vmh - visual front-end to MH

SYNOPSIS
     vmh [-prompt string] [-vmhproc program] [-novmhproc]
          [switches for _v_m_h_p_r_o_c] [-help]
9     _v_m_h is a program which implements the server side of the _M_H
     window management protocol and uses _c_u_r_s_e_s (3) routines to
     maintain a split-screen interface to any program which
     implements the client side of the protocol.  This latter
     program, called the _v_m_h_p_r_o_c, is specified using the
     `-vmhproc program' switch.

     The upshot of all this is that one can run _m_s_h on a display
     terminal and get a nice visual interface.  To do this, for
     example, just add the line

          mshproc: vmh

     to your .mh_profile.  (This takes advantage of the fact that
     _m_s_h is the default _v_m_h_p_r_o_c for _v_m_h.)

     In order to facilitate things, if the `-novmhproc' switch is
     given, and _v_m_h can't run on the user's terminal, the _v_m_h_p_r_o_c
     is run directly without the window management protocol.

     After initializing the protocol, _v_m_h prompts the user for a
     command to be given to the client.  Usually, this results in
     output being sent to one or more windows.  If a output to a
     window would cause it to scroll, _v_m_h prompts the user for
     instructions, roughly permitting the capabilities of _l_e_s_s or
     _m_o_r_e (e.g., the ability to scroll backwards and forwards):

          SPACE      advance to the next windowful
          RETURN  *  advance to the next line
          y       *  retreat to the previous line
          d       *  advance to the next ten lines
          u       *  retreat to the previous ten lines
          g       *  go to an arbitrary line
                     (preceed g with the line number)
          G       *  go to the end of the window
                     (if a line number is given, this acts like `g')
          CTRL-L     refresh the entire screen
          h          print a help message
          q          abort the window

     (A `*' indicates that a numeric prefix is meaningful for
     this command.)

     Note that if a command resulted in more than one window's
     worth of information being displayed, and you allow the com-
     mand which is generating information for the window to



Printed 1/10/87                MH                               1


9


VMH(1)              UNIX Programmer's Manual               VMH(1)



     gracefully finish (i.e., you don't use the `q' command to
     abort information being sent to the window), then _v_m_h will
     give you one last change to peruse the window.  This is use-
     ful for scrolling back and forth.  Just type `q' when you're
     done.

     To abnormally terminate _v_m_h (without core dump), use <QUIT>
     (usually CTRL-\).  For instance, this does the "right" thing
     with _b_b_c and _m_s_h.

FILES
     $HOME/.mh_profile                  The user profile

PROFILE COMPONENTS
     Path:                To determine the user's MH directory

SEE ALSO
     msh(1)

DEFAULTS
     `-prompt (vmh) '
     `-vmhproc msh'

CONTEXT
     None

BUGS
     The argument to the `-prompt' switch must be interpreted as
     a single token by the shell that invokes _v_m_h.  Therefore,
     one must usually place the argument to this switch inside
     double-quotes.

     At present, there is no way to pass signals (e.g., inter-
     rupt, quit) to the client.  However, generating QUIT when
     _v_m_h is reading a command from the terminal is sufficient to
     tell the client to go away quickly.

     Acts strangely (loses peer or botches window management pro-
     tocol with peer) on random occasions.
















Printed 1/10/87                MH                               2