8266565: Spec of ForwardingJavaFileManager/ForwardingFileObject/ForwardingJavaFileObject methods should mention delegation instead of being copied

Reviewed-by: vromero

Author: jonathan-gibbons

src/java.compiler/share/classes/javax/tools/ForwardingFileObject.java

@@ -38,14 +38,17 @@
  * might override some of these methods and might also provide
  * additional fields and methods.
  *
+ * <p>Unless stated otherwise, references in this class to "<em>this file object</em>"
+ * should be interpreted as referring indirectly to the {@link #fileObject delegate file object}.
+ *
  * @param <F> the kind of file object forwarded to by this object
  * @author Peter von der Ah&eacute;
  * @since 1.6
  */
 public class ForwardingFileObject<F extends FileObject> implements FileObject {
 
     /**
-     * The file object which all methods are delegated to.
+     * The file object to which all methods are delegated.
      */
     protected final F fileObject;
 

src/java.compiler/share/classes/javax/tools/ForwardingJavaFileManager.java

@@ -37,14 +37,17 @@
  * might override some of these methods and might also provide
  * additional fields and methods.
  *
+ * <p>Unless stated otherwise, references in this class to "<em>this file manager</em>"
+ * should be interpreted as referring indirectly to the {@link #fileManager delegate file manager}.
+ *
  * @param <M> the kind of file manager forwarded to by this object
  * @author Peter von der Ah&eacute;
  * @since 1.6
  */
 public class ForwardingJavaFileManager<M extends JavaFileManager> implements JavaFileManager {
 
     /**
-     * The file manager which all methods are delegated to.
+     * The file manager to which all methods are delegated.
      */
     protected final M fileManager;
 

src/java.compiler/share/classes/javax/tools/ForwardingJavaFileObject.java

@@ -33,6 +33,9 @@
  * might override some of these methods and might also provide
  * additional fields and methods.
  *
+ * <p>Unless stated otherwise, references in this class to "<em>this file object</em>"
+ * should be interpreted as referring indirectly to the {@link #fileObject delegate file object}.
+ *
  * @param <F> the kind of file object forwarded to by this object
  * @author Peter von der Ah&eacute;
  * @since 1.6