Wed, 19 Aug 2009 17:12:36 -0700
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