Updating documentation

This commit is contained in:
clay_shooter
2006-10-13 23:29:26 +00:00
parent 4a1ebd4298
commit a7668bfadd
4 changed files with 135 additions and 70 deletions

View File

@@ -1,32 +1,46 @@
<?xml version="1.0"?>
<!-- ======================================================================
Feb 4, 2005 1:23:05 PM
Ant build file for JACOB.
Tested on Eclipse 3.0.1 and Ant 1.6.1, with MS Visual C++ 6.0
Created Feb 4, 2005 1:23:05 PM as part of migration from ANT
Last Modified October 13, 2005
Eclipse users are pretty lucky. This works with the version of ANT
that comes with Eclipse 3.0.1 (maybe 3.0.0). The whole project
can be built inside eclipse.
Tested on Eclipse 3.1.0 with the CDT plugin, Ant 1.6.1 and MS Visual C++ 6.0
Eclipse users are pretty lucky because the whole project
can be built inside eclipse due to their built in ANT support.
If you do not have a C++ environment check out the following sites
http://msdn.microsoft.com/visualc/vctoolkit2003/
http://www.eclipse.org/cdt/
http://eclipsewiki.editme.com/InstallingCDTWithMSVisualC
Developers will need to find a copy of MS Visual C++ 6.0.
The build proces defined in this build.xml file does support
MS Visual C++ 8.0 (Visual C++ 2005 Express) when combined with the M SDK.
The problem is that SafeArray.cpp will not compile
with that 64 bit aware environment.
====================================================================== -->
<project name="jacob" default="default" basedir=".">
<property file="compilation_tools.properties" />
<!-- sets a default for properties that were not in the file -->
<!-- relies on the fact that properties cannot be reset once set -->
<property name="JDK" value="JDK not set in compilation_tools properties file"/>
<property name="MSDEVDIR" value="MSDEVDIR not set in compilation_tools properties file"/>
<property name="MSSDKDIR" value="${MSDEVDIR}"/>
<echo message="MSDEVDIR=${MSDEVDIR} MSSDKDIR=${MSSDKDIR}"/>
<!-- =v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=v=
YOU MUST define a file named compilation_tools.properties
and looking like this:
YOU MUST define a file named compilation_tools.properties!
The file for MS Visual C++ 6.0 looks something like
JDK=D:/J2SDK-1_4_2
MSDEVDIR=C:/Program Files/Microsoft Visual Studio/VC98
version=1.9
JDK=d:/j2sdk1.4.2_09
MSDEVDIR=d:\\apps\\Microsoft Visual Studio\\VC98
version=1.11-pre1
DO NOT check this file into source control as the values are specific
to YOUR environment.
The file for MS Visual Studio 8 Express with SDK looks something like:
JDK=d:/j2sdk1.4.2_09
MSDEVDIR=D:\\Apps\\Microsoft Visual Studio 8\\VC
MSSDKDIR=D:\\Apps\\Microsoft Platform SDK for Windows Server 2003 R2
version=1.11-pre1
DO NOT check compilation_tools.properties into source control as the
values are specific to YOUR environment.
the version.properties file is now completely autogenerated
@@ -66,6 +80,8 @@
Writes out a version file to be included in the jar
================================================================== -->
<target name="IncrementBuildNumber">
<!-- sets a default for properties that were not in the file -->
<!-- relies on the fact that properties cannot be reset once set -->
<property name="version" value="version not set in compilation_tools properties file"/>
<propertyfile file="version.properties">
<entry key="version" type="string" value="${version}" />
@@ -168,16 +184,31 @@
<apply executable="${compiler}" dir="${cpp.bin}" parallel="false" verbose="true" failonerror="true">
<arg value="-c" />
<arg value="/nologo" />
<!-- create a multi threaded library -->
<!-- <arg value="/MT" /> -->
<!-- raise the warning level from the default -->
<arg value="/W2" />
<!-- sets the exception model -->
<arg value="/EHsc" />
<!-- optimize build for speed. (is this VC specific? -->
<arg value="/O2" />
<!-- next two wipe out a lot of deprecated warnings about strings when using VC++ 8.0 and SDK-->
<arg value="/D" />
<arg value="_CRT_SECURE_NO_DEPRECATE" />
<arg value="/D" />
<arg value="_CRT_NONSTDC_NO_DEPRECATE" />
<arg value="/D" />
<arg value="_STATIC_CPPLIB" />
<arg value="-I" />
<arg value="${JDK}\include" />
<arg value="-I" />
<arg value="${JDK}\include\win32" />
<arg value="-I" />
<arg value="-I" /> <!-- hopefully 6.0 won't barf including same dir twice -->
<arg value="${MSDEVDIR}\Include" />
<arg value="-I" />
<arg value="${MSDEVDIR}\ATL\Include" />
<arg value="${MSSDKDIR}\Include" />
<arg value="-I" />
<arg value="${MSSDKDIR}\\Include\\ATL" />
<fileset dir="${cpp.src}">
<include name="*.cpp" />
</fileset>
@@ -195,7 +226,7 @@
<arg value="/dll" />
<arg value="/version:${version}" />
<arg value="/out:${dll_fullpath}" />
<arg value="/libpath:${MSDEVDIR}/lib" />
<arg value="/libpath:${MSSDKDIR}/lib" />
<srcfile />
<arg value="${JDK}\lib\jvm.lib" />
<arg value="oleaut32.lib" />