I've only tested this program on Linux, a few versions of Solaris of
varying vintge, and Windows.  However, it should be pretty portable.

If you're running a Unix platform, or CygWin, jump to the section
"Generic Install" below.

WINDOWS (Visual Studio Install)
-------------------------------
If you are running Windows and using VC++ 5.0 or later, untar the
distribution and run "make".  Note that wildcards aren't supported on
the command line in this environment.  If you want to use ITS4
directly from MS Visual Studio, this is supported.  Follow the
directions:

1) Go to the Tools menu, and choose Customize.
2) Go to the Tools tab, and hit the icon for new item.
3) Name the new tool '&ITS4'.
4) In the command field, browse to your its4.exe location.
5) For arguments: -W $(FileName)$(FileExt)
6) For Initial directory: $(FileDir)

From now on, hitting Ctrl-T then I will run ITS4 on the file being
actively edited.  You can get to it through menus, too.


GENERIC INSTALL (i.e., Not Visual Studio)
1) On a Unix system,    type: ./configure
   On a Windows system, type: bash ./configure
   There are some options you can set from the command line that
   will affect the installation, including:
       --prefix=PATH           Set base directory for installation to directory
                               specified by PATH.  Default is '/usr/local'.
       --with-cpp=PATH         Use the C++ compiler located at PATH.
                               Default is to try g++ then CC.
       --help                  A list of all options that can be set.

2) Follow the directions given when ./configure finishes.
   Generally, this consists of two things:
     a) Running 'make'
     b) Running 'make install'
   
   When running 'make install', make sure you log in as a user with
   enough privileges to write to the place you chose in step 1.  If 
   you're installing to a system directory (such as the default,
   /usr/local), then you'll probably need to become root.

That should be it.  However, you may have:

ISSUES:

Currently, ITS4 gives up on some language extensions, particularly on
Mac extensions.  I've been meaning to fix this, but haven't had time.
Please submit a patch if you encounter the problem, or at least drop
me a line, letting me know that you ran into it.  The more I hear
about it, the more likely I am to fix it.

Please me know about any other problems you have at the address below.

John Viega
viega@cigital.com
viega@list.org
http://www.list.org/~viega/
