src/share/classes/java/lang/reflect/Executable.java

*** 382,391 ****
--- 382,393 ----
      }
  
      /**
       * Returns a string describing this {@code Executable}, including
       * any type parameters.
+      * @return a string describing this {@code Executable}, including
+      * any type parameters
       */
      public abstract String toGenericString();
  
      /**
       * Returns {@code true} if this executable was declared to take a
*** 494,503 ****
--- 496,507 ----
       * represents the type of the constructed object.
       *
       * If this Executable represents a method, the AnnotatedType object
       * represents the use of a type to specify the return type of the method.
       *
+      * @return an object representing the return type of this method
+      * or constructor
       * @since 1.8
       */
      public abstract AnnotatedType getAnnotatedReturnType();
  
      /* Helper for subclasses of Executable.
*** 529,538 ****
--- 533,545 ----
       * declares a formal parameter called 'this' with no annotations on its
       * type.
       *
       * Returns null if this Executable represents a static method.
       *
+      * @return an object representing the receiver type of the
+      * method or constructor represented by this Executable
+      *
       * @since 1.8
       */
      public AnnotatedType getAnnotatedReceiverType() {
          return TypeAnnotationParser.buildAnnotatedType(getTypeAnnotationBytes(),
                  sun.misc.SharedSecrets.getJavaLangAccess().
*** 551,560 ****
--- 558,570 ----
       * declaration of the method/constructor.
       *
       * Returns an array of length 0 if the method/constructor declares no
       * parameters.
       *
+      * @return an array of objects representing the types of the
+      * formal parameters of this method or constructor
+      *
       * @since 1.8
       */
      public AnnotatedType[] getAnnotatedParameterTypes() {
          return TypeAnnotationParser.buildAnnotatedTypes(getTypeAnnotationBytes(),
                  sun.misc.SharedSecrets.getJavaLangAccess().
*** 573,582 ****
--- 583,595 ----
       * the method/constructor.
       *
       * Returns an array of length 0 if the method/constructor declares no
       * exceptions.
       *
+      * @return an array of objects representing the declared
+      * exceptions of this method or constructor
+      *
       * @since 1.8
       */
      public AnnotatedType[] getAnnotatedExceptionTypes() {
          return TypeAnnotationParser.buildAnnotatedTypes(getTypeAnnotationBytes(),
                  sun.misc.SharedSecrets.getJavaLangAccess().