very roughly, here we go...

0 - if you are running Ultrix, see trix-for-ultrix and if you are planning
	to run X11 on the Vaxstation 2000, see xqvss.bug
1 - edit the directory paths in include/gshdirs.h to your liking making
	sure they have a trailing "/"
	edit the defunct msg in defunct.h to your liking
	you may also want to change the default font by editting the FONT def
	in include/xgshstate.h
	#define	FONT	"9x15"
	(to be safe, use a fixed width font)
	If you are running 4.3BSD, take -DULTRIX off of CFLAGS in
	xgsh/Makefile
	If you are running Ultrix V2, make sure it is defined.
	for non-dec systems you can try it either way, since i
	don't know what their vhangup() behaviour will be
	{ if it is wrong, either vif will not start up properly, ie.
	no access to pty, or xgsh will be stopped and put in background
	at least when started by csh}
2 - make the libraries in stuff and libXgoo
	% cd stuff; make
	% cd ../libXgoo; make
3 - make the clients xgsh, vif and dirb
	if you are concerned about running out of memory, set -DSAFE in the
	xgsh/Makefile CFLAGS
	% cd xgsh; make
	% cd ../vif; make
	% cd ../dirb; make
4 - make the sample configs for xgsh and vif
	% cd xgsh/configs; MAKEALL
	% cd ../../vif/configs; MAKEALL
5 - and the help libraries
	% cd xgsh/helplib; MAKEALL
	% cd ../../vif/helplib; MAKEALL
	% cd ../../dirb/helplib; MAKEALL
steps 2-5 are done by the mickey mouse shell script ./MAKEALL
6 - copy the clients, configs and helplibs to the directories in
	include/gshdirs.h as follows:
	xgsh, vif and dirb to the XDIR
	configs to the CONFLIB
	helplibs to the HELPDIR
	- make sure the CONFLIB/* and HELPDIR/* have world read protection
	  and the XDIR clients have world execute
	  (also, check that your unix domain server socket /tmp/.X11-unix/X0
	   has world read/write)
7 - copy the little subtree tryit/... to a convenient place
	owned by a user other than root

8 - set the user's homedir at that place

9 - give em a shot logged in as that user

nb. you can run them from a command line separately, or in the demo case:
	% /usr/lib/X11/xgsh -display unix:0 -config icon.xgs

(nb. running as root can be tedious, since dirb will be started from the
 user's home dir (in this case /) and it can take a lonnggg... time
 to get started. (not to mention run like its on valium after it
 gets started))

the left mouse button does principal selections
the middle mouse button should pop up help windows just about everywhere
and the right mouse button pops up auxiliary stuff in some cases
(basically, full names when the name won't fit in the button as indicated
 by a trailing .. and a pull down process control menu on process windows)

if you want to make your own configs the file configs in this dir. may
help. if you want to use xgsh as a login shell you must make a link
to the "xgsh" a.out with the name of the config that should be run and
use that name for the login shell in /etc/passwd.

for the example config:
	% ln /usr/lib/X11/xgsh /usr/local/bin/icon.xgs
	- and make /usr/local/bin/icon.xgs the last field of a /etc/passwd
		entry

(the sortdemo is independent of the rest and can be compiled and run on
	its own)
actually dirb can be run independently and so can vif, but vif must be
set up attached to the client process using a pty ala xgsh/Xttylib.c
