FindDoc © May 1991 By Talin. Freely re-distributable.

An autodoc/include reference utility for TurboText users.

	FindDoc is a set of C programs and ARexx macros which allow you to
quickly locate any AutoDoc function entry or structure name. You can place
the cursor on the name to be looked up, or alternatively have a string
requester ask for the name of the entry, and it will open a TurboText
window containing the definition of that entry.
	The program consists of the following parts:

	ParseAuto - a C program which parses the autodoc files
	ParseInc - a C program which parses the include files
	FindDoc - a C program which is a resident ARexx host. It maintains
		an index and accepts requests from ARexx to locate entries in the
		index.
	FindAutoDoc.ttx - an ARexx program to be launched from TurboText,
		which will request the name of the entry to be looked up.
	FindAutoDocWord.ttx - similar to above, but uses the word under the
		cursor as the entry to look up.

	Note that I gave not included the source to the C programs simply
because they will only compile in my environment (they make use of my
extensive personal function libraries).

To install FindDoc:
	1. Copy the two rexx program to your REXX: directory.
	2. Copy FindDoc to somewhere in your path (somewhere that can be called by
		arexx)
	3. execute the command:
		ParseAuto <directory where your autodocs are> S:AutoDocs.index
	4. execute the command:
		ParseInc <directory where your includes are> S:Includes.index
	5. Edit your TTX_Startup.dfn file to attach the two ARexx programs to
		the function key of your choice.
	6. Try it out! Edit any of your C source files, put the cursor on the
		name of an Amiga ROM function, and hit the function key that executes
		"FindAutoDocWord.ttx".

Program usage:

	ParseAuto <directory to scan> <index file to build>

		For example:

			ParseAuto dh0:docs S:AutoDoc.index


	ParseInc <directory to scan> <index file to build>

		For example:

			ParseAuto dh0:include S:Includes.index


	FindDoc <index file> <index file> ...

		Example:

			Run >NIL: <NIL: FindDoc S:AutoDoc.index S:Include.index

		Note that you don't have to run this program as the ARexx scripts
			will call it if not already running.
		To terminate the FindDoc server, either send it a control-C, or
			send "quit" to it's rexx port.
		The only other ARexx command it responds to is "find <entryname>". It
			will return a string containing the file to look in and the
			line number. If multiple entries are found, then the result
			strings will be concatenated.
			The entry name can be quoted.