From 3556a2a33100520c708c71b786e87f086234ddfa Mon Sep 17 00:00:00 2001 From: wisberg Date: Wed, 5 Mar 2003 23:00:02 +0000 Subject: [PATCH] updates for eclipse and sense --- .../org/aspectj/testing/drivers/package.html | 27 +++++++++++++++---- 1 file changed, 22 insertions(+), 5 deletions(-) diff --git a/testing-drivers/src/org/aspectj/testing/drivers/package.html b/testing-drivers/src/org/aspectj/testing/drivers/package.html index 8a098f798..8c795bdd3 100644 --- a/testing-drivers/src/org/aspectj/testing/drivers/package.html +++ b/testing-drivers/src/org/aspectj/testing/drivers/package.html @@ -1,12 +1,26 @@ -These harnesses drive ajc compiler tests. Following is information on how to use them. +This harness drives ajc compiler tests. +You can run it from the command-line or programmatically. +It works through a chain of responsibility roughly mapped to +the schematic of a test definition: +
+   general harness
+      subclass feature harness
+        ajc-test run component
+          compile {sub-} run component
+          inc-compile {sub-} run component
+          run {sub-} run component
+          ...
+
+This tells you how to run the harness and which options are supported +by each component.

Use Harness.main(String[]) from the command-line, or Harness.getHarness() programmatically. Harness.runMain(String[]) takes arguments that -each component in the chain may accept and interpret. +each component in the chain may accept and interpret:

@@ -27,8 +41,8 @@ each component in the chain may accept and interpret.
ComponentOptions
*- variants: Options with a trailing "-" cause two sets of option lists to be produced, one with and one without the corresponding - option. E.g., "-usejavac-" will run the suite twice, once with and - once without the "-usejavac" flag. + option. E.g., "-emacssym-" will run the suite twice, once with and + once without the "-emacssym" flag. That means if you use this on each of three options, you will get 8 variant sets (1 with no options, 1 with all 3 options, 3 with 2 options, and 3 with 1 option). @@ -99,6 +113,8 @@ each component in the chain may accept and interpret.
compiler selectors: Use -ajc or -eclipse to select the old (ajc 1.0) or new (eajc 1.1) compilers. + Note that the old compiler is not + available in the CVS source tree at eclipse.org.
option dominance -!^: Some tests require or prohibit certain options; @@ -178,7 +194,7 @@ Following are some sample configurations: If you have a set of options you use often, you can define a single-word option alias for it; see Harness.optionAliases. -

Configuration: most tests use the library jars in +

Configuration: Most tests use the library jars in aspectj/modules/lib/test, defined in org.aspectj.testing.harness.bridge.Globals. Normally the harness finds these by relative path @@ -189,6 +205,7 @@ define the environment variable harness.libdir - e.g., $ cd aspectj/tests $ java -Dharness.libdir=../modules/lib/test -jar eajctesting.jar ajcTests.xml +

\ No newline at end of file -- 2.39.5