archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-09-21 11:34:38 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

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

Browse source 
Reviewed-by: jjg
This commit is contained in:
Joe Darcy 2009-08-19 17:12:36 -07:00
parent 5c818e4b6a
commit 54aaa7ae7a
1 changed files with 8 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

10
langtools/src/share/classes/javax/tools/JavaCompiler.java
View file

@ -228,6 +228,12 @@ public interface JavaCompiler extends Tool, OptionChecker {
* <p>If a file manager is provided, it must be able to handle all * <p>If a file manager is provided, it must be able to handle all
* locations defined in {@link StandardLocation}. * locations defined in {@link StandardLocation}.
* *
* <p>Note that annotation processing can process both the
* compilation units of source code to be compiled, passed with
* the {@code compilationUnits} parameter, as well as class
* files, whose names are passed with the {@code classes}
* parameter.
*
* @param out a Writer for additional output from the compiler; * @param out a Writer for additional output from the compiler;
* use {@code System.err} if {@code null} * use {@code System.err} if {@code null}
* @param fileManager a file manager; if {@code null} use the * @param fileManager a file manager; if {@code null} use the
@ -236,8 +242,8 @@ public interface JavaCompiler extends Tool, OptionChecker {
* null} use the compiler's default method for reporting * null} use the compiler's default method for reporting
* diagnostics * diagnostics
* @param options compiler options, {@code null} means no options * @param options compiler options, {@code null} means no options
* @param classes class names (for annotation processing), {@code * @param classes names of classes to be processed by annotation
* null} means no class names * processing, {@code null} means no class names
* @param compilationUnits the compilation units to compile, {@code * @param compilationUnits the compilation units to compile, {@code
* null} means no compilation units * null} means no compilation units
* @return an object representing the compilation * @return an object representing the compilation