226 * completed as described in the CompilationTask interface. |
226 * completed as described in the CompilationTask interface. |
227 * |
227 * |
228 * <p>If a file manager is provided, it must be able to handle all |
228 * <p>If a file manager is provided, it must be able to handle all |
229 * locations defined in {@link StandardLocation}. |
229 * locations defined in {@link StandardLocation}. |
230 * |
230 * |
|
231 * <p>Note that annotation processing can process both the |
|
232 * compilation units of source code to be compiled, passed with |
|
233 * the {@code compilationUnits} parameter, as well as class |
|
234 * files, whose names are passed with the {@code classes} |
|
235 * parameter. |
|
236 * |
231 * @param out a Writer for additional output from the compiler; |
237 * @param out a Writer for additional output from the compiler; |
232 * use {@code System.err} if {@code null} |
238 * use {@code System.err} if {@code null} |
233 * @param fileManager a file manager; if {@code null} use the |
239 * @param fileManager a file manager; if {@code null} use the |
234 * compiler's standard filemanager |
240 * compiler's standard filemanager |
235 * @param diagnosticListener a diagnostic listener; if {@code |
241 * @param diagnosticListener a diagnostic listener; if {@code |
236 * null} use the compiler's default method for reporting |
242 * null} use the compiler's default method for reporting |
237 * diagnostics |
243 * diagnostics |
238 * @param options compiler options, {@code null} means no options |
244 * @param options compiler options, {@code null} means no options |
239 * @param classes class names (for annotation processing), {@code |
245 * @param classes names of classes to be processed by annotation |
240 * null} means no class names |
246 * processing, {@code null} means no class names |
241 * @param compilationUnits the compilation units to compile, {@code |
247 * @param compilationUnits the compilation units to compile, {@code |
242 * null} means no compilation units |
248 * null} means no compilation units |
243 * @return an object representing the compilation |
249 * @return an object representing the compilation |
244 * @throws RuntimeException if an unrecoverable error |
250 * @throws RuntimeException if an unrecoverable error |
245 * occurred in a user supplied component. The |
251 * occurred in a user supplied component. The |