6871291: Please clarify javax.tools.JavaCompiler.getTask() "classes" parameter

Wed, 19 Aug 2009 17:12:36 -0700

author
darcy
date
Wed, 19 Aug 2009 17:12:36 -0700
changeset 375
2ce3597237f0
parent 374
2aa3a1cdb094
child 376
61c1f735df67

6871291: Please clarify javax.tools.JavaCompiler.getTask() "classes" parameter
Reviewed-by: jjg

src/share/classes/javax/tools/JavaCompiler.java file | annotate | diff | comparison | revisions
     1.1 --- a/src/share/classes/javax/tools/JavaCompiler.java	Wed Aug 19 20:44:22 2009 +0100
     1.2 +++ b/src/share/classes/javax/tools/JavaCompiler.java	Wed Aug 19 17:12:36 2009 -0700
     1.3 @@ -228,6 +228,12 @@
     1.4       * <p>If a file manager is provided, it must be able to handle all
     1.5       * locations defined in {@link StandardLocation}.
     1.6       *
     1.7 +     * <p>Note that annotation processing can process both the
     1.8 +     * compilation units of source code to be compiled, passed with
     1.9 +     * the {@code compilationUnits} parameter, as well as class
    1.10 +     * files, whose names are passed with the {@code classes}
    1.11 +     * parameter.
    1.12 +     *
    1.13       * @param out a Writer for additional output from the compiler;
    1.14       * use {@code System.err} if {@code null}
    1.15       * @param fileManager a file manager; if {@code null} use the
    1.16 @@ -236,8 +242,8 @@
    1.17       * null} use the compiler's default method for reporting
    1.18       * diagnostics
    1.19       * @param options compiler options, {@code null} means no options
    1.20 -     * @param classes class names (for annotation processing), {@code
    1.21 -     * null} means no class names
    1.22 +     * @param classes names of classes to be processed by annotation
    1.23 +     * processing, {@code null} means no class names
    1.24       * @param compilationUnits the compilation units to compile, {@code
    1.25       * null} means no compilation units
    1.26       * @return an object representing the compilation

mercurial