From b1979531b07dc70d1eb27eab92e970812701f119 Mon Sep 17 00:00:00 2001 From: wisberg Date: Mon, 6 Jan 2003 23:45:51 +0000 Subject: [PATCH] explaining more properties, basics of testing. --- build/readme-build-module.html | 45 +++++++++++++++++++++++++--------- 1 file changed, 34 insertions(+), 11 deletions(-) diff --git a/build/readme-build-module.html b/build/readme-build-module.html index bca0d78a5..fdf97054f 100644 --- a/build/readme-build-module.html +++ b/build/readme-build-module.html @@ -14,10 +14,23 @@ scripts and libraries. Consider defining the following flag properties:

- + + +
PropertyEffect of setting it to any value
PropertyMeaning
module.name + To build any module (esp. those not directly supported + by a target), use the "any-module" target and define + the module name. e.g., + ant any-module -Dmodule.name=ajde. +
check.build.jar - fail if build.jar is out of date + any value cause build to fail if build.jar is out of date +
build.config + override default configuration in build.xml. + Significant values include "verbose" for more output + and "useEclipseCompiles" to assume that Eclipse has + compiled modules into their bin directories, and just + assemble those classes.

@@ -55,18 +68,27 @@ This affects build products (e.g., installers) which are run under eclipse (e.g., by opening with the "default system editor") and libraries used when compiling under Javac (if not zip products or input). This problem presents as files not being writable, i.e., deleted or modified. -You might get no notice of the problem when -deleting with quiet="on". (The alternative to that is to create any -directories being deleted before deleting them). +Ant provides no notice of the problem when +deleting with quiet="on" (often used to avoid unnecessary errors caused +by trying to delete directories that do not exist).

-Currently BuildModule taskdefs fork the Javac command to work around +Currently BuildModule tasks forks the Javac command to work around this problem, but the Zip commands do not work around it. If under Eclipse, you get strange behavior with Ant builds, clear out everything and build from the command line. In some cases, you have to exit Eclipse before files can be deleted. (*sigh*) +

Running the test harness

+The build-testing-drivers target builds a single jar with +the AspectJ binaries and a test harness as the main class. +It reads test suite files like + ../tests/ajcTests.xml. +

+JUnit tests may be run under eclipse or by using Ant to "build" + ../tests/junitModules.xml +(which uses the eclipse module bin directories as its classpath).

Development

BuildModule task

@@ -90,15 +112,16 @@ module jar file. These have an install directory for installer resources and a dist directory containing all files belonging in the distribution, including 0-length placeholders for the module build -results. +results. These placeholder file names are mapped to the originating +module by the task itself (yes, an awful hack).

Build notes

Directory names: Top-level temporary build directories are prefixed "aj-", so you can safely destroy any such directory or ignore it in CVS or the Eclipse package explorer. By default the build script -puts them at the same level as other modules. Property names follow -a similar convention; those prefixed "aj-" may be deleted at will, while +puts them at the same level as other modules. In build scripts, property names +follow a similar convention; those prefixed "aj-" may be deleted at will, while "aspectj-" names are source directories which should never be deleted.

@@ -119,8 +142,8 @@ To avoid updating Version.java whenever src/org/aspectj/internal/tools/ant/taskdefs/VersionUptodate.java determines whether Version.java has the same version by scanning the source file. -(Do not change the lines flagged in the template without also -changing the scanning code in the task.) +The scan is dim-witted; do not change the lines flagged in the template +without also changing the scanning code in the task.

-- 2.39.5