United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-6501749 Filer should state connection between created files and root elements
JDK-6501749 : Filer should state connection between created files and root elements

Details
Type:
Bug
Submit Date:
2006-12-07
Status:
Closed
Updated Date:
2011-07-15
Project Name:
JDK
Resolved Date:
2011-07-15
Component:
core-libs
OS:
generic
Sub-Component:
javax.annotation.processing
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
6
Fixed Versions:

Related Reports
Relates:

Sub Tasks

Description
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
EVALUATION

A fine idea.
                                     
2006-12-07
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.
                                     
2009-02-25



Hardware and Software, Engineered to Work Together