Unix-like "help" program.                               version 1.0 by Pat Lynch


GENERAL

	  This is a customizeable help program, which operates on the basic Unix 
	principles used for command searches. The directories used to search for 
	help files can be set in an environmental variable. Additionally, the 
	placement and size of help windows can be set in a similar fashion. The 
	program can be told to display all files found that match the help topic, 
	but the default is to only display the first match.
       
HELP FILE STRUCTURE

	  Files are searched according to the help structure used by Mentor and 
	Apollo for their system helps. The root directory for Mentor help files is 
	/idea/sys/help, for Apollo, /sys/help, for local commands, 
	/local/help. To find help for the topic "quicksim" the program looks for the 
	file "quicksim.hlp" in each of the root help directories in its search path. 
	To find help for the topic "dm commands", the program looks for the file 
	"dm/commands.hlp" in each of the root help directories in its search path. 
	To find help for the topic "mspice bar width" the program looks for the file 
	"mspice/bar/width.hlp" in each of the root help directories in its search 
	path. Easy huh? To use your own personal help files, simply create a help
	directory, and include it in your help path as described below.
                   
CUTOMIZING WINDOW SIZE AND SEARCH PATH

	  The default search path is "/local/help:/idea/sys/help:/sys/help", and the 
	default window coordinates are "0,0:700,600:60,80", where the first two 
	numbers are the x,y coordinates of the upper left corner of the window, the 
	second pair of numbers specifies the x,y coordinates of the lower right 
	corner of the window, and the third pair specifies the tiling offset if 
	multiple windows are to be displayed. Both of these defaults may be over-
	ridden by setting environmental variables in the shell. The environmental 
	variable HELPPATH will be used (if found) to override the default search 
	path, and the environmental variable HELPSIZE will be used (if found) to 
	override the default window size, placement, and tile offset. If you set the
	HELPSIZE variable in your shell, it must contain all 3 pairs of numbers. 
	Each number may be seperated by spaces, commas, colons, or tabs, but may 
	only use a single charcter for the seperation. For example: 

			"0:0,200 300:25,25" is legal,
	but 
			"0:0,200 300::25,25", and "0:0,200,300:25  25" are not.

	  The HELPPATH variable follows the same syntax, and allows up to 32
	directories to searched.
                         

VIEWING MULTIPLE HELP FILES (Same Topic)

	  To specify that all matches of help files found are to be displayed, use 
	the "-a" option. For example, if there were two "dlt" commands, "help dlt -a"
	would display at least two files, perhaps "/local/help/dlt.hlp", and 
	"/sys/help/dlt.hlp". If the shell supports DM commands the files will be 
	viewed in seperate windows in a tiled fashion. If the shell does not support 
	DM commands, the files will be "cat"ed to the screen one after another. Since 
	the general case in which DM commands are not supported is when a session is 
	logged in to the Apollos via telnet, in which the screen can't be scrolled 
	backward to view the transcript, the output of "/bin/cat" is piped to the 
	"/usr/ucb/more" command to allow page-at-a-time viewing.

 

 
BUGS

cat doesn't handle multiple files...
