src/jdk.compiler/share/classes/com/sun/tools/javac/file/BaseFileManager.java

*** 64,74 ****
  import com.sun.tools.javac.util.DefinedBy.Api;
  import com.sun.tools.javac.util.Log;
  import com.sun.tools.javac.util.Options;
  
  /**
!  * Utility methods for building a filemanager.
   * There are no references here to file-system specific objects such as
   * java.io.File or java.nio.file.Path.
   */
  public abstract class BaseFileManager implements JavaFileManager {
      protected BaseFileManager(Charset charset) {
--- 64,74 ----
  import com.sun.tools.javac.util.DefinedBy.Api;
  import com.sun.tools.javac.util.Log;
  import com.sun.tools.javac.util.Options;
  
  /**
!  * Utility methods for building a file manager.
   * There are no references here to file-system specific objects such as
   * java.io.File or java.nio.file.Path.
   */
  public abstract class BaseFileManager implements JavaFileManager {
      protected BaseFileManager(Charset charset) {
*** 90,100 ****
          boolean warn = options.isLintSet("path");
          locations.update(log, warn, FSInfo.instance(context));
  
          // Setting this option is an indication that close() should defer actually closing
          // the file manager until after a specified period of inactivity.
!         // This is to accomodate clients which save references to Symbols created for use
          // within doclets or annotation processors, and which then attempt to use those
          // references after the tool exits, having closed any internally managed file manager.
          // Ideally, such clients should run the tool via the javax.tools API, providing their
          // own file manager, which can be closed by the client when all use of that file
          // manager is complete.
--- 90,100 ----
          boolean warn = options.isLintSet("path");
          locations.update(log, warn, FSInfo.instance(context));
  
          // Setting this option is an indication that close() should defer actually closing
          // the file manager until after a specified period of inactivity.
!         // This is to accommodate clients which save references to Symbols created for use
          // within doclets or annotation processors, and which then attempt to use those
          // references after the tool exits, having closed any internally managed file manager.
          // Ideally, such clients should run the tool via the javax.tools API, providing their
          // own file manager, which can be closed by the client when all use of that file
          // manager is complete.