src/java.base/share/classes/java/lang/constant/Constable.java

rev 52981 : 8215300: additional changes to constants API

@@ -63,12 +63,13 @@
  *
  * @since 12
  */
 public interface Constable {
     /**
-     * Returns a nominal descriptor for this instance, if one can be
-     * constructed, or an empty {@link Optional} if one cannot be constructed.
+     * Returns an {@link Optional} containing the nominal descriptor for this
+     * instance, if one can be constructed, or an empty {@link Optional}
+     * if one cannot be constructed.
      *
      * @return An {@link Optional} containing the resulting nominal descriptor,
      * or an empty {@link Optional} if one cannot be constructed.
      */
     Optional<? extends ConstantDesc> describeConstable();