Override default Javadoc for shape()

Author: karllessard

tensorflow-core/tensorflow-core-api/src/main/java/org/tensorflow/Operand.java

@@ -79,6 +79,9 @@ default T data() {
     return asOutput().tensor().data();
   }
 
+  /**
+   * Returns the (possibly partially known) shape of the tensor referred to by the {@link Output} of this operand.
+   */
   @Override
   default Shape shape() {
     return asOutput().shape();

tensorflow-core/tensorflow-core-api/src/main/java/org/tensorflow/Output.java

@@ -80,6 +80,9 @@ public Tensor<T> tensor() {
     return (Tensor<T>) operation.tensor(index);
   }
 
+  /**
+   * Returns the (possibly partially known) shape of the tensor referred to by this output.
+   */
   @Override
   public Shape shape() {
     return operation.shape(index);

tensorflow-core/tensorflow-core-api/src/main/java/org/tensorflow/Tensor.java

@@ -233,6 +233,7 @@ public long numBytes() {
     return numBytes;
   }
 
+  /** Returns the shape of this tensor. */
   @Override
   public Shape shape() {
     return shape;

tensorflow-core/tensorflow-core-api/src/main/java/org/tensorflow/op/nn/SigmoidCrossEntropyWithLogits.java

@@ -67,7 +67,7 @@ public static <T extends TNumber> Operand<T> sigmoidCrossEntropyWithLogits(
       throw new IllegalArgumentException(
           String.format(
               "logits and labels must have the same shape (%s vs %s)",
-              labels.shape().toString(), logits.shape()));
+              labels.shape(), logits.shape()));
     }
     scope = scope.withSubScope("SigmoidCrossEntropyWithLogits");
 

tensorflow-core/tensorflow-core-api/src/main/java/org/tensorflow/op/nn/SparseSoftmaxCrossEntropyWithLogits.java

@@ -98,7 +98,7 @@ public static <T extends TNumber, U extends TNumber> Operand sparseSoftmaxCrossE
       throw new IllegalArgumentException(
           String.format(
               "Rank mismatch: Rank of labels (received %s) should equal rank of logits minus 1 (received %s).",
-              labelsStaticShape.toString(), logitsShape.toString()));
+              labelsStaticShape, logitsShape));
     }
 
     if (staticShapesFullyDefined && !labelsStaticShape.equals(logitsShortened)) {
@@ -107,7 +107,7 @@ public static <T extends TNumber, U extends TNumber> Operand sparseSoftmaxCrossE
               "Shape mismatch: The shape of labels (received %s) "
                   + "should equal the shape of logits except for the last "
                   + "dimension (received %s).",
-              labelsStaticShape.toString(), logitsShape.toString()));
+              labelsStaticShape, logitsShape));
     }
     // Check if no reshapes are required.
     if (logitsShape.numDimensions() == 2) {