|THow to use this program|T
		    Copyright 1989, 1991, Sansaska Systems.

HeLPyoURSeLF is designed as a TSR to allow instant access by means of a 
|shot key|s. It comes with another program, hcompile, which allows you to 
create your own hyper text files for use with HeLPyoURSeLF.

To use the files that came with HeLPyoURSeLF you first "|spop up|s" the 
window using the |shot key|ss then using the movement keys (arrow keys) 
you move the cursor to the hot spot you are interested in and press the 
EnterΔΩ key and the information is displayed for you. Pressing the Ctrl 
EnterΔΩ key will return you to where you were when you pressed EnterΔΩ.
	
To create your own HeLPyoURSeLF files you follow these simple guidelines:
    1.  Create a text file or whatever as you  normally  would.  The  file 
	must  have  a .hyp extension. Lines longer than 74 characters will 
	be truncated.
PgDn for more...
.pg	
    2.  Where you want to create a target place ||T or ||t at the 
	beginning of the target and ||T or ||t at the end of the target. 
	Both T's should be upper or lower case but if they aren't the 
	first one is the one that controls. "T" requires the spots to 
	match the case of the target and "t" does not.

    3.	Run the program hcompile to "compile" the text file to generate an 
	index file for use by HeLPyoURSeLF. All text strings that match 
	your designated targets and are ALL ON ONE LINE will be found and 
	indexed as |shot spot|ss.

    4.	If you restart HeLPyoURSeLF with a new mainhelp file use the full 
	path name: "HLPURSLF c:\hlpurslf\mainhelp" on the command line. 
	The .hyp extension is not required. |TNOTE|T: if you are using 
	MS-DOS 5.00 and start HeLPyoURSeLF from a batch file you may need 
	to use "HLPURSLF cc:\hlpurslf\mainhelp".
    
    5.	The file may be conveniently divided into page length sections by 
	placing .pg at the start of a line.
PgDn for more...
.pg
Advanced concepts:	
    6.	Sometimes it is necessary to mark text as a hot spot because it is 
	not otherwise recognizable. For example "|shot spot|ss" is marked 
	this way so it will match "|shot spot|s". You do this by putting 
	||s before and after the part that is an EXACT match of the 
	|starget|s. This is also necessary if the spot is preceded and/or 
	followed by some punctuation marks as here where "|starget|s" is 
	surrounded by quotes. Look at this paragraph with a standard 
    	editor to see how it is done.

    7.	Sometimes it is necessary to prevent something from being 
	recognized as a hot spot. This is done by placing ||n's around the 
	text that is an EXACT match of a |starget|s. For example this 
	|nhot spot|n is marked that way. Look at this paragraph with a 
	standard editor to see how it is done.
PgDn for more...
.pg
Really advanced concepts: 
    8.	It is possible to have targets in other files. This is a little 
	messy but... First create a target in the current file, follow it 
	with the name of the definition file that contains the true 
	target, then put the same target in the definition file. For 
	example assume the target is foobar and is defined and explained 
	in the file foobardf.hyp.
	
	The target and filename in this file should look like:

	||tfoobar||t||ffoobardf||f	(this should be the only thing on
					 the line. NOTE no extension.)
	The file foobardf.hyp MUST have somewhere in it:

			||tfoobar||t
	
	Now run the batch file "makeindx" which will compile all the .hyp 
	files in the current directory twice to establish all linkages 
	between them.
PgDn for more...
.pg
    9.	If you have a situation where a one hot spot is a substring (part) 
	of another or you want to have several identical hot spots then 
	you can use ||0 - ||9 as non displaying characters to break up the 
	hot spots. These breaks MUST NOT BE AT EITHER END OF THE SPOT OR 
	|nTARGET|n and must be in both the SPOT(s) and |nTARGET|n. For 
	example this ho|1t spot won't match the usual |nhot spot|n but 
	will match this |tho|1t spot|t. Look at this paragraph with a 
	standard editor to see how it is done.

    10.	For additional information look at the .hyp files that came with 
	this.

    11.	Files that aren't .hyp files can be referenced as described above 
	in 8 except that the full pathname must be given 
	("||fc:\xyz\readme.doc||f"). A marked target may or may not be 
	present in the definition file and of course it can't be indexed. 
	Look at this paragraph with a standard editor to see how the file 
	name marking was done. Use this technique when you have to make 
	the escape character, ||, visible in a .hyp file.
.pg
Glossary
|tarrow keys|t	The 4 keys grouped like an inverted T to the right of the 
		right shift key or the 2, 4, 6 or 8 keys on the numeric 
		keypad when NumLock is off. The right arrow moves to the 
		next hot spot or target; the left arrow to the previous 
		one; the down arrow to the first one on the next line; and 
		the up arrow to the last one on the previous line.

|tcursor|t		A "block" that can be moved around the screen with the
		arrow keys. On a color screen it appears as a black 
		background to the text which is normally on a cyan
		background. On a monochrome screen it is the reverse of 
		the normal background and when it is behind a target the 
		target is underlined.

|thome screen|t	The first screen to appear when the hot key is pressed the
		first time.		
PgDn for more...
.pg
|thot key|t		The  key  or  keys  that are used to pop up or pop down
		a TSR program when you want to make use of the program. For
		this program they are "Ctrl ?" Ctrl held while ? is pressed.

|thot spot|t	Points on the screen that connect to |starget|s. If you place
		the cursor on it and press the EnterΔΩ key the target will
		be displayed. On monochrome screens they are bright text, 
		on color screens they are bright cyan in contrast to 
		normal text which is black on cyan.

|Thyper text|T	A form of data/text presentation that allows the reader 
		to have immediate access to text or data in a 
		nonsequential order. Access, in this program, is 
		provided by placing the cursor over a hot spot and 
		pressing the EnterΔΩ key.

|tindex file|t	A file containing information describing the locations of 
		the |shot spot|ss and targets in the text file. This file has 
		the extension .inx.
PgDn for more...
.pg	
|tmovement keys|t	The keys that move you around the data. They are:
		Key		Action
		Arrow keys	move the cursor from hot spot to hot spot or
				target
		|tEnterΔΩ|t	brings up the underlying target
		Esc		pop down the current screen and bring up the
				home screen when the hot key is next pressed.
		|tCtrl EnterΔΩ|t	returns you the hot spot from which you
				accessed the current target
		Home		returns to the point at which your entered
				the current file
		Ctrl Home	returns you to the to of the home screen
		PageUp		moves up one page in the current file
		Ctrl PageUp	moves to the first page in the currently
				displayed file
		PageDn		moves down one page in the file
		Other keys	Any key that generates a displayable
				character will move the cursor to the next
				hot spot that starts with that character.
PgDn for more...
.pg
|tpop up|t		The HeLPyoURSeLF screen that appears when you press the 
		|shot keys|s. It replaces the current screen. When the
		hot keys are pressed again, or the Esc key is pressed, the
		current screen will pop down and the original screen will 
		be restored.

|tpop down|t	Remove the TSR screen and restore the original screen.
		The HelpYourself TSR can be popped down with the original
		hot key, which will preserve the currently displayed screen
		for display on the next pop up or it can be popped down with
		the Esc key which will cause the initial screen to be
		displayed the next time it is popped up.
PgDn for more...
.pg		
|ttarget|t		A target is usually an explanation of or clarification of 
		something. For example this is the explanation of what a 
		target is. Targets, in HeLPyoURSeLF, are surrounded by ||T or 
		||t's. When by ||T the corresponding |shot spot|s(s) must 
		match in case, when by ||t the case of the |shot spot|s 
		doesn't matter. Targets are white on cyan or reverse video 
		on monochrome.

|TTSR|T		Terminate and Stay Resident program, one that is loaded 
		and remains in memory ready to be called up by a
		"|shot key|s" for instant use.

PgDn for more...
.pg







			  |tSansaska Systems|t
			 3311 Concord Blvd.
			 Concord, CA  94519
			   (415) 676-2268
                       Compuserve  71140,3727