Tags are a powerful way to quickly look up information in PenPoint
header files.  Editors based on "vi" and "emacs" already have support 
for tags built-in.  The directory \penpoint\sdk\util\tags includes
various support files for tag look-up:
       o  a tags file compatible with vi, emacs, and other
          UNIX-based editors;
       o  a slightly different version of the same file, tags_b,
          and a tag.m macro compatible with the BRIEF editor;
       o  text files referred to by some of the  tags.

This file explains how to set up tags.  For more information on the 
keywords on which you can tag, read \penpoint\sdk\util\tags\help.txt
(or "tag help").

If you have any comments or suggestions or tags macros for other editors,
please contact GO Developer Technical Support.


Setup:

If you are using vi, emacs, or a UNIX-compatible editor, copy 
\penpoint\sdk\util\tags\tags to your work directory.

If you are using BRIEF, 
       o  Copy tag.m and tag.cm to your \brief\macros directory.
       o  In BRIEF, edit the file your_initials.m in
          \brief\macros, for example
          	ssp.m.  This file is created by BRIEF's setup
          program.
       o  your_initials.m should have a macro called
          YOUR_INITIALS.  After the line
               ;** Put your changes here.
          add the following:
          	(autoload "tag" "tag")
          	(assign_to_key "<Ctrl-H>" "tag")
       o  Press <Alt-F10> to recompile your_initials.m.

       If your "tags_b" file is in some other location than
       "\penpoint\sdk\util\tags\", or if your include files are
       elsewhere than "\penpoint\sdk\inc\", then you need to edit
       "tag.m", change where it looks for these, and recompile it
       (press <Alt-F10>).
       
To look up a tag in BRIEF, do one of the following:
       o  Position the cursor anywhere in the word and press
          <Ctrl-H>.
       o  Type <F10>tag tag_name<Return>

       The macro leaves bookmark 9 at the original location, so you can
       press <Alt-J>9 to return to it.


	If you do not have a \penpoint\sdk\util\tags directory, or you keep your
	include files in another directory than \penpoint\sdk\inc, then you need
	to modify tag.m.

	If you map some other macro to <Ctrl-H>, or if you use some program 
	that may cause the <Backspace> key to map to <Ctrl-H>, modify 
	"your_initials".m to assign "tag" to some other keystroke.

To look up a tag in vi, move the cursor to the beginning of the word and
press <Ctrl-]>.

If you come up with a tag macro for some other editor, please consider
posting it on the GO Developer Info bulletin board.


BUGS:
The tags file is so large that lookups are slow.  Perhaps a binary search
algorithm would be faster.

The technology we used misses function prototype typedefs and probably 
misses elaborate C constructs.  The source to it is on the GO Developer Info
bulletin board.

