added provisional message reader for specifying expected messages in a separate file.

  http://dev.eclipse.org/bugs/show_bug.cgi?id=31724
declare warning context.
Note context itself untested -- need to check/upgrade message checking.

Still has links to porting guide and progguide.pdf.

- fixed tracing examples using wrong main class
- added descriptions to targets so Ant 1.5 lists then using -projecthelp
- removed references to vestigial aspectj-ant.jar

- discussed the .ajbrowser file
  and setting classpath using options
- discussed config files separately
- added caveat about only displaying static crosscutting

fixed aspectj.org and MPL references in about box.

Also now setting some options only if not empty (was resetting options if not null).

- XLint handled in two if legs?
- corrected error messages
- pushed handling of -incremental down
- using handler rather than printing to System.out (per !!! comment)
- permitting both .zip and .jar suffixes in
  outjar, injar, and aspectpath
- requires sourceroots to be readable
- added incremental and incrementalFile
  (even though caller should handle?)
- did not remove options no longer supported in 1.1?
  (bootclasspath and extdirs)

  (include -Xlinkfile file variant)
- added bytecode weaving example

warning: using hokey programlisting formatting and
not emphasizing special terms because I didn't
feel like looking up the docbook variants.

- added external local link to programming guide

- removed "-d none" as unimplemented
- added -Xlint variants
- Note difference from 1.1 changes doc
  from: "-XLintfile:foo"
    to: "-XLinefile foo"
  per implementation
- re-aligned and cleaned up wording

To keep alignment, prefix each line with \t but
do alignment with spaces only (and don't edit with
editor that replaces spaces with tabs).

http://bugs.eclipse.org/bugs/show_bug.cgi?id=29769

clinit has run, noting that 1/3 remaining failures is in bugzilla

clinit has run

   Incremental: Commenting out conflict yeilds NullPointerException

   Incremental: Commenting out conflict yeilds NullPointerException

   VerifyError on accessing objects not accessible to the weaver: Incompatible object argument for invokespecial

this design is confiined to the aspect containing the around entirely which
makes for cleaner implementation issues and lets things like super calls
be implemented correctly.

   Declare precedence should not allow multiple * patterns

   Declare precedence should not allow multiple * patterns

declare precedence

   Use of within with declare soft yeilds VerifyError 1.1b4

   Use of within with declare soft yeilds VerifyError 1.1b4

   Static inner aspects cannot reference user defined pointcuts

   Static inner aspects cannot reference user defined pointcuts