Using 'hdsrunwm' 
----------------

The 'hdsrunwm' program provides an alternate way of starting a local window
manager on an HDS ViewStation.  If the 'hdsrunwm' program is used on
the host to start the ViewStation window manager, any window manager
menu commands will also be started by the 'hdsrunwm' program.  This
allows these menu commands to inherit the same environment as they
would if the window manager were being run on the host.

The 'hdsrunwm' program requires HDSware Version 3.0.3 or later.

To use the 'hdsrunwm' program:

1. Check the hds-fx/contrib/hdsrunwm/execs directory for an executable
   suitable for your host type.  If you find one, use the 'uncompress'
   command on the file.  For example,

		uncompress hdsrunwm.SUN4.Z
		mv hdsrunwm.SUN4 hdsrunwm

   You may need to set the 'executable' permissions for the file.
   For this, you can use the command:

		chmod +x hdsrunwm

2. If a suitable executable does not already exist for your host type,
   set the current directory to hds-fx/contrib/hdsrunwm/src.  The
   'hdsrunwm.c' source can be used to compile an executable for your host.  

   You will need to know the name of the Remote Shell program on your
   host.  For many machines, this is 'rsh'.  On some System V machines
   the program is 'rcmd'.  On some HP systems it is 'remsh'.  Edit the
   'hdsrunwm.c' source file and set the REMOTE_SHELL_PROGRAM definition
   appropriately.

   To compile, execute the command:

	cc -o hdsrunwm hdsrunwm.c

   If you are using an alternate compiler, such as GNU/C, you may need
   to use a command such as 'gcc'.

   This will produce a 'hdsrunwm' executable file.

3. Copy the 'hdsrunwm' file into a directory which will be included in 
   your execute search path when you want to start the window manager.
   Possibilities include /bin, /usr/bin/X11, /usr/local/bin, etc.

4. The 'hdsrunwm' program uses the DISPLAY environment variable to determine
   the hostname of the ViewStation on which to start the window manager.
  
   The 'hdsrunwm' uses the Remote Shell program to start the command.
   Most Remote Shell programs require a valid hostname instead of a
   numeric IP address.  Therefore, if your Remote Shell program requires
   a hostname (as do most), make sure your DISPLAY environment variable
   will contain a hostname and not simply an IP address.

   The 'hdsrunwm' program will print a warning message if a number IP
   address is present in the DISPLAY variable.

5. Where you would normally start your window manager, substitute the 
   'hdsrunwm' command.

   For example, if you start your 'mwm' in the .xsession file, replace
   the line

   mwm -option1 -option2 -option3

   with 

   hdsrunwm mwm -option1 -option2 -option3
