src/share/classes/javax/lang/model/element/Element.java

*** 177,186 ****
--- 177,190 ----
       * If it represents an {@linkplain TypeElement#getSimpleName
       * anonymous class} or {@linkplain ExecutableElement#getSimpleName
       * instance initializer}, an empty name is returned.
       *
       * @return the simple name of this element
+      * @see PackageElement#getSimpleName
+      * @see ExecutableElement#getSimpleName
+      * @see TypeElement#getSimpleName
+      * @see VariableElement#getSimpleName
       */
      Name getSimpleName();
  
      /**
       * Returns the innermost element
*** 200,209 ****
--- 204,218 ----
       * <li> If this is a {@linkplain
       * TypeParameterElement#getEnclosingElement type parameter},
       * {@linkplain TypeParameterElement#getGenericElement the
       * generic element} of the type parameter is returned.
       *
+      * <li> If this is a {@linkplain
+      * VariableElement#getEnclosingElement method or constructor
+      * parameter}, {@linkplain ExecutableElement the executable
+      * element} which declares the parameter is returned.
+      *
       * </ul>
       *
       * @return the enclosing element, or {@code null} if there is none
       * @see Elements#getPackageOf
       */