JDK-6501749 : Filer should state connection between created files and root elements
Type:Bug
Component:core-libs
Sub-Component:javax.annotation.processing
Affected Version:6
Priority:P4
Status:Closed
Resolution:Fixed
OS:generic
CPU:generic
Submitted:2006-12-07
Updated:2011-07-15
Resolved:2011-07-15
The Version table provides details related to the release that this issue/RFE will be addressed.
Unresolved : Release in which this issue/RFE will be addressed. Resolved: Release in which this issue/RFE has been resolved. Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.
It would be clearer if the javax.annotation.processing.Filer more explicitly stated that the created files show up as the root elements of some subsequent round.
Comments
SUGGESTED FIX
--- old/src/share/classes/javax/annotation/processing/Filer.java Tue Feb 24 17:16:35 2009
+++ new/src/share/classes/javax/annotation/processing/Filer.java Tue Feb 24 17:16:34 2009
@@ -35,9 +35,11 @@
* processor. Files created in this way will be known to the
* annotation processing tool implementing this interface, better
* enabling the tool to manage them. Source and class files so
- * created will be considered for processing by the tool after the
- * {@code close} method has been called on the {@code Writer} or
- * {@code OutputStream} used to write the contents of the file.
+ * created will be {@linkplain RoundEnvironment#getRootElements
+ * considered for processing} by the tool in a subsequent {@linkplain
+ * RoundEnvironment round of processing} after the {@code close}
+ * method has been called on the {@code Writer} or {@code
+ * OutputStream} used to write the contents of the file.
*
* Three kinds of files are distinguished: source files, class files,
* and auxiliary resource files.