src/share/classes/javax/annotation/processing/Filer.java
Print this page
rev 223 : 6501749: 6501749 Filer should state connection between created files and root elements
Reviewed-by: jjg
*** 33,45 ****
/**
* This interface supports the creation of new files by an annotation
* 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.
*
* Three kinds of files are distinguished: source files, class files,
* and auxiliary resource files.
*
* <p> There are two distinguished supported locations (subtrees
--- 33,47 ----
/**
* This interface supports the creation of new files by an annotation
* 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 {@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.
*
* <p> There are two distinguished supported locations (subtrees