1761727 converted unit test programs to JUnit tests and updated the build targets

docs/BuildingJacobFromSource.html

@@ -17,28 +17,47 @@ Unpack the source archive zip file or check the files out of CVS into d:\jacob
 or some other familiar place.  Source Java and JNI files are located in seperate
 packages from the unit tests and the samples.
 <p>
-The java code is in .\src.<BR>
-The C++ code is in .\jni.<br>
-Code is compiled into .\release<br>
+<ul>
+<li>docs: documentation
+<li>jni: c++ code
+<li>lib: libraries needed to compile unit tests
+<li>release: a directory built by the ant script where jacob is constructed
+<li>samples: sample programs
+<li>src:  Jacob Java source files
+<li>unittest:  JUnit 3.8.1 unit test programs. Run from the test target in build.xml
+<li>vstudio: some out of date VC++ project files
+<li>bulid.xml: the ant build script.  It can be run from inside Eclipse
+</ul>
 <p>
 The Servlet examples that required j2ee libraries to compile have temporarily
 been removed.
 <p>
 <H1>Development Environment</h1>
 The simplest build environment includes MS Visual C++ 8.0 (Studio 2005), 
-Eclipse 3.2 with the C/C++ module and JDK 1.4.
+Eclipse 3.3 with the C/C++ module and JDK 1.4.
 In that situation, you would just create the <i>compilation_tools.properties</i>
-using the example build.xml as a template.  All of the releases, up through 1.12, 
-were built using Visual C++ 6.0. 64 bit builds are supported starting with release 1.11.  
-Microsoft Visual C++ 8.0 supports 64 bit builds. so no additional tools are required.
-
+using the example build.xml as a template.  
 <UL>
 <li>	Microsoft Visual C++ 8.0 and it's included library. (to D:\apps in my case)
-<li>	Eclipse 3.2 or later from www.eclipse.org.  I use the C/C++ plugin for 
-		eclipse rather than MS Visual Studio
+<li>	Eclipse 3.3 or later from www.eclipse.org as the Java IDE.  
+<li>	Eclipse 3.3 or later with the C/C++ plugin can be used for C coding in place of VC++ IDE.
 <li>	Java JDK 1.4 (1.12 was built using 1.4.2.13) Compilation using JDK 1.5 has not been tested
 </ul>
 <p>
+<p>
+<table>
+<TR><TD>Release</TD><TD>C Version</TD><TD>Java Version</TD><TD>ANT Version</TD><TD>Eclipse Version Used</TD><TD>generated DLLs</TD></TR>
+<TR><TD>up to 1.6</TD><TD>VC 98 (6.0)</TD><TD>?</TD><td>Used MAKE</td><TD>?</TD><TD>32 bit</TD></TR>
+<TR><TD>1.7</TD><TD>VC 98 (6.0)</TD><TD>1.4</TD><td>1.?</td><TD>?</TD><TD>32 bit</TD></TR>
+<TR><TD>1.8</TD><TD>VC 98 (6.0)</TD><TD>1.4</TD><td>1.?</td><TD>?</TD><TD>32 bit</TD></TR>
+<TR><TD>1.9</TD><TD>VC 98 (6.0)</TD><TD>1.4</TD><td>1.?</td><TD>?</TD><TD>32 bit</TD></TR>
+<TR><TD>1.10</TD><TD>VC 98 (6.0)</TD><TD>1.4</TD><td>1.?</td><TD>3.??</TD><TD>32 bit</TD></TR>
+<TR><TD>1.11</TD><TD>VC 98 (6.0) & 2003 64bit libs</TD><TD>1.4.?</TD><td>1.6.?</td><TD>3.2.1</TD><TD>32 and 64 bit</TD></TR>
+<TR><TD>1.12</TD><TD>VC 98 (6.0) & 2003 64bit libs</TD><TD>1.4.2</TD><td>1.6.5</td><TD>3.2.2</TD><TD>32 and 64 bit</TD></TR>
+<TR><TD>1.13</TD><TD>VC 2005</TD><TD>1.4.2</TD><TD>1.7.0</TD><TD>3.3</TD><TD>32 and 64 bit</TD></TR>
+</table>
+Microsoft Visual C++ 8.0 supports 64 bit builds. so no additional tools are required.
+
 <p>
 
 <H1>Build Process</H1>
@@ -85,18 +104,20 @@ Open up the project properties and go to the "Java Build Path" properties panel.
 <li>	Add folders <code>samples</code>, <code>src</code> and <code>unittest</code> 
 		to the build path in the Source tab.</li>
 <li>	Exclude *.txt from each of the newly added folders.  </li>
-<li>	Set the build output directory to <code>jacob-project/release/java</code></li>
+<li>	Set the default build output directory to <code>jacob-project/release/java</code></li>
 </ul>
 
 
 <h1> Running Samples and Tests </h1>
-Samples and test programs can be found in the source jar or in CVS.  The programs
+Samples and JUnit test programs can be found in the source jar or in CVS.  The programs
 can be run from a bat file or from inside the Eclipse IDE.  The java library
 path variable must be set to include the directory the jacob.dll is in.  The
 simplest way to do that is to add it as a command line option. 
+<p>
+JUnit test programs can be individually run from inside eclipse or en-masse 
+via the <code>ant test</code> target.
 
-
-Last Modified 4/2007
+Last Modified 7/2007 1.13M3
 
 </BODY>
 </HTML>