src/jdk.incubator.vector/share/classes/jdk/incubator/vector/X-Vector.java.template

rev 56969 : Javadoc corrections

*** 522,532 ****
       *         the primitive value {@code e}
       * @throws IllegalArgumentException
       *         if the given {@code long} value cannot
       *         be represented by the vector's {@code ETYPE}
       * @see #broadcast(VectorSpecies,$type$)
!      * @see VectorSpecies#checkValue(VectorSpecies,$type$)
       */
      public static $abstractvectortype$ broadcast(VectorSpecies<$Boxtype$> species, long e) {
          $Type$Species vsp = ($Type$Species) species;
          return vsp.broadcast(e);
      }
--- 522,532 ----
       *         the primitive value {@code e}
       * @throws IllegalArgumentException
       *         if the given {@code long} value cannot
       *         be represented by the vector's {@code ETYPE}
       * @see #broadcast(VectorSpecies,$type$)
!      * @see VectorSpecies#checkValue(VectorSpecies,long)
       */
      public static $abstractvectortype$ broadcast(VectorSpecies<$Boxtype$> species, long e) {
          $Type$Species vsp = ($Type$Species) species;
          return vsp.broadcast(e);
      }
*** 1520,1530 ****
      public final $abstractvectortype$ div($type$ e) {
          return lanewise(DIV, e);
      }
  
      /**
-     /**
       * {@inheritDoc} <!--workaround-->
       * @see #div($type$,VectorMask)
  #if[FP]
       * <p> Because the underlying scalar operator is an IEEE
       * floating point number, division by zero in fact will
--- 1520,1529 ----
*** 1892,1902 ****
       * {@code lanewise}.
       *
       * @return the bitwise complement {@code ~} of this vector
       * @see #and(Vector)
       * @see VectorOperators#NOT
!      * @see #lanewise(VectorOperators.Unary,Vector,VectorMask)
       */
      @ForceInline
      public final $abstractvectortype$ not() {
          return lanewise(NOT);
      }
--- 1891,1901 ----
       * {@code lanewise}.
       *
       * @return the bitwise complement {@code ~} of this vector
       * @see #and(Vector)
       * @see VectorOperators#NOT
!      * @see #lanewise(VectorOperators.Unary,VectorMask)
       */
      @ForceInline
      public final $abstractvectortype$ not() {
          return lanewise(NOT);
      }
*** 2056,2066 ****
       * @return the mask result of testing lane-wise if this vector
       *         compares to the input, according to the selected
       *         comparison operator
       * @see $abstractvectortype$#compare(VectorOperators.Comparison,Vector)
       * @see #eq($type$)
!      * @see #lessThan($type$)
       */
      public abstract
      VectorMask<$Boxtype$> compare(Comparison op, $type$ e);
  
      /*package-private*/
--- 2055,2065 ----
       * @return the mask result of testing lane-wise if this vector
       *         compares to the input, according to the selected
       *         comparison operator
       * @see $abstractvectortype$#compare(VectorOperators.Comparison,Vector)
       * @see #eq($type$)
!      * @see #lt($type$)
       */
      public abstract
      VectorMask<$Boxtype$> compare(Comparison op, $type$ e);
  
      /*package-private*/
*** 3104,3114 ****
       * @param m the mask controlling lane selection
       * @return a vector loaded from a byte array
       * @throws IndexOutOfBoundsException
       *         if {@code offset+N*ESIZE < 0}
       *         or {@code offset+(N+1)*ESIZE > a.length}
!      *         for any lane {@code N} in the vector
       */
      @ForceInline
      public static
      $abstractvectortype$ fromByteArray(VectorSpecies<$Boxtype$> species,
                                         byte[] a, int offset,
--- 3103,3114 ----
       * @param m the mask controlling lane selection
       * @return a vector loaded from a byte array
       * @throws IndexOutOfBoundsException
       *         if {@code offset+N*ESIZE < 0}
       *         or {@code offset+(N+1)*ESIZE > a.length}
!      *         for any lane {@code N} in the vector where
!      *         the mask is set
       */
      @ForceInline
      public static
      $abstractvectortype$ fromByteArray(VectorSpecies<$Boxtype$> species,
                                         byte[] a, int offset,
*** 3362,3372 ****
       * @throws IllegalArgumentException if byte order of bb
       *         is not {@link ByteOrder#LITTLE_ENDIAN}
  #end[!byte]
       * @throws IndexOutOfBoundsException
       *         if {@code offset+N*$sizeInBytes$ < 0}
!      *         or {@code offset+N**$sizeInBytes$ >= bb.limit()}
       *         for any lane {@code N} in the vector
       */
      @ForceInline
      public static
      $abstractvectortype$ fromByteBuffer(VectorSpecies<$Boxtype$> species,
--- 3362,3372 ----
       * @throws IllegalArgumentException if byte order of bb
       *         is not {@link ByteOrder#LITTLE_ENDIAN}
  #end[!byte]
       * @throws IndexOutOfBoundsException
       *         if {@code offset+N*$sizeInBytes$ < 0}
!      *         or {@code offset+N*$sizeInBytes$ >= bb.limit()}
       *         for any lane {@code N} in the vector
       */
      @ForceInline
      public static
      $abstractvectortype$ fromByteBuffer(VectorSpecies<$Boxtype$> species,
*** 3412,3422 ****
       * @throws IllegalArgumentException if byte order of bb
       *         is not {@link ByteOrder#LITTLE_ENDIAN}
  #end[!byte]
       * @throws IndexOutOfBoundsException
       *         if {@code offset+N*$sizeInBytes$ < 0}
!      *         or {@code offset+N**$sizeInBytes$ >= bb.limit()}
       *         for any lane {@code N} in the vector
       *         where the mask is set
       */
      @ForceInline
      public static
--- 3412,3422 ----
       * @throws IllegalArgumentException if byte order of bb
       *         is not {@link ByteOrder#LITTLE_ENDIAN}
  #end[!byte]
       * @throws IndexOutOfBoundsException
       *         if {@code offset+N*$sizeInBytes$ < 0}
!      *         or {@code offset+N*$sizeInBytes$ >= bb.limit()}
       *         for any lane {@code N} in the vector
       *         where the mask is set
       */
      @ForceInline
      public static