StarTool notes (Windows version)
4/21/01
mcopenha@cs.ucsd.edu


1. The Windows version of StarTool will only work on WinNT 4.0 and Windows
2000. It will *not* work correctly on Windows 95 and 98 systems due to 
problems with the pipe facilities on these os's. 

2. If you have Cygwin installed on your computer do not run StarTool from
the Cygwin command shell. There's a copy of the cygwin1.dll in the 
StarTool/bin directory that could conflict with the one in /bin. 

3. Make sure you have the directory c:\tmp. Otherwise, cstar will always 
report parse errors and the command window will display "polaris: No such 
file or directory." The reason is that StarTool makes calls to the Unix 
function tmpfile() which requires a tmp directory.

4. Do not install StarTool in a directory path containing spaces (e.g., 
"c:\Program Files"). 

5. As with all current versions, cstar displays preprocessed versions
of source files. We plan on updating cstar in the future to display
the original source text.

6. The Windows version of cstar is only capable of parsing ansi C. It is *not*
capable of parsing C files containing win32 code, mfc, or gnu-like extensions 
to the C language (e.g., the inline directive). 

7. The Unix versions of cstar require a c-preprocessor installed on your 
system. The Windows version comes bundled with cpp, the gnu preprocessor, as
well as the necessary header files, so you shouldn't have to worry about 
installing your own. If you insist on using your own preprocessor, then open 
the cstar.bat file (in StarTool/bin) and change the ICPP variable to point to 
your preprocessor. Note that Microsoft Visual C++'s preprocessor (cl /e) 
cannot produce output that is compatible with cstar's parser. 

8. If you're using the Ada version of StarTool you must install Gnat 3.10 
from ftp://ftp.cs.nyu.edu/pub/gnat/private/old/winnt. Please install this 
in the default location of c:\usr\.  If you've already installed it in a 
different location, edit the adastar.bat file in StarTool\bin and change
the path to gnat.

9. If you plan on using adastar you must have both Gnat 3.10 and the latest
version of Cygwin installed.