Use case 1: developer build (in your local jython copy)
-------------------------------------------------------
- call target 'developer-build' (which is the default for this build.xml)
This build will create directories /build and /dist below basedir.
Use case 2: full build for a release (using cvs checkout)
---------------------------------------------------------
- make sure you have access to anonymous cvs
- override cvs.tag in ant.properties (if necessary)
- call target 'full-build'
This build will create a working directory named full_build_${cvs.tag} at the same
level as your local directories bugtests, jython, sandbox and installer.
It will contain a big jython_${cvs.tag}.jar file suitable for installation.
Use case 3: build only the parser (grammar)
-------------------------------------------
- override javaccHome in ant.properties (if necessary)
- call target 'parser'
or:
- set javaccHome, either on the command line, or inside parser/build.xml
- call parser/build.xml (default target)
This build will only create files inside org/python/parser.
Note on targets
---------------
The following targets are designed for direct invocation:
- usage
- developer-build
- full-build
- clean (uses developer-build settings if called directly)
- parser (uses developer-build settings if called directly)
Following an ant convention, the callable targets have a description attribute.
All other targets may give unpredicted results if called directly.
Where ant.properties are searched
---------------------------------
1. in user.home
2. in the same directory as this build.xml file
The first setting of a property wins, further settings are ignored.
Actions for a release
---------------------
1. determine the new cvs tag to be applied to jython
2. determine the existing cvs tag of the CPython Lib files which should be included
3. change the following properties in this build.xml, if necessary:
- cvs.tag (target: full-init)
- python.cvs.tag (target: full-init)
- jdk.target.version (target: pre-init)
4. if new CPython .py files should be distributed, add them to build.Lib.include.properties
5. adjust the public static String version in PySystemState.java
6. check in all the changes
7. apply the new tag to the jython cvs (all projects)
8. call target 'full-build'
An example ant.properties file:
-------------------------------
# - define the home for javacc (only used for parser grammar)
javaccHome=${basedir}/../externals/javacc-3.2
# - ht2html tool for the doc target (only needed for full-build)
ht2html.dir=${basedir}/../externals/ht2html-2.0
# - define the home of the corresponding CPython version
python.home=c:/Programme/Python/Python22
# - javax.servlet
servlet.jar=c:/workspace/HEAD/CH.obj.commons.core/make_lib/j2ee.jar
# - org.gnu.readline
readline.jar=${basedir}/../externals/external-jars/readline.jar
# - zxJDBC
# (for mysql, see www.mysql.com/downloads/api-jdbc-stable.html)
# (for postgres, see http://jdbc.postgresql.org/)
mysql.jar=${basedir}/../externals/external-jars/mysql-connector-java-3.0.16-ga-bin.jar
postgresql.jar=${basedir}/../externals/external-jars/pg74.215.jdbc2.jar
oracle.jar=C:/workspace/HEAD/for_development/bisdevsrv28/jboss/server/infra/lib/ojdbc14.jar
#informix.jar=
# - option for javac (build.compiler=modern is a global option to use standard jdk 1.3/1.4/1.5)
#build.compiler=modern
#jdk.target.version=1.2
#debug=false
#optimize=off
#deprecation=off
# - the cvs tag to build from; only needed for full-build
#cvs.tag=Release_2_2alpha0
#cvs.tag=HEAD
#cvs.tag=pep302
loading properties from ${user.home}/ant.properties
loading properties from ${basedir}/ant.properties
.
Build environment for ${ant.project.name}
(Note: if ${propertyname} is displayed, then the property is not set)
--- optional libraries ---
collections = '${java2collection.present}'
weakref = '${weakref.present}'
threadlocal = '${threadlocal.present}'
java2 access = '${java2accessible.present}'
secureclassloader = '${secureclassloader.present}'
servlet = '${servlet.present}'
readline = '${readline.present}'
oracle = '${oracle.present}'
informix = '${informix.present}'
mysql = '${mysql.present}'
postgresql = '${postgresql.present}'
jndi = '${jndi.present}'
jdbc = '${javax.sql.present}'
jdbc3.0 = '${jdbc30.present}'
--- properties ---
work.dir = '${work.dir}'
source.dir = '${source.dir}'
parser.dir = '${parser.dir}'
output.dir = '${output.dir}'
dist.dir = '${dist.dir}'
apidoc.dir = '${apidoc.dir}'
python.lib = '${python.lib}'
javaccHome = '${javaccHome}'
ht2html.dir = '${ht2html.dir}'
build.compiler = '${build.compiler}'
jdk.target.version = '${jdk.target.version}'
jdk.source.version = '${jdk.source.version}'
deprecation = '${deprecation}'
debug = '${debug}'
optimize = '${optimize}'
nowarn = '${nowarn}'
--- properties (used for full-build only )---
cvs.tag = '${cvs.tag}'
python.cvs.tag = '${python.cvs.tag}'
cvs.checkout.dir = '${cvs.checkout.dir}'
do.checkout = '${do.checkout}'
python.exe = '${python.exe}'
setting jython password for anonymous
checking out jython with the following command: ${jython.checkout.command} jython
checking out installer with the following command: ${installer.checkout.command} installer
setting python password for anonymous
checking out ${python.module} with the following command: ${python.checkout.command} ${python.module}
processing ${parser.dir}/build.xml
copy misc files from ${source.dir}
copy CPython LICENSE from ${python.home} to ${dist.dir}/LICENSE_CPython.txt
copy sources from ${source.dir}
copy the demo files from ${source.dir}/Demo
copy Tools from ${source.dir}/Tools
copy CPython/Lib *.py files from ${python.lib}
copy the jython *.py modules from ${source.dir}/Lib
compiling installer from ${install.src.dir}
copy installer classes to ${dist.dir}
copy installer icon to ${dist.dir}
building installer .jar file