*** old/src/java.base/share/classes/java/nio/Bits.java	Mon Jan 25 20:47:21 2016
--- new/src/java.base/share/classes/java/nio/Bits.java	Mon Jan 25 20:47:21 2016

*** 817,837 ****
--- 817,912 ----
                                  long length)
      {
          copyToShortArray(srcAddr, dst, dstPos, length);
      }
  
+     /**
+      * Copy and byte swap 16-bit elements from a heap array to off-heap memory
+      *
+      * @param src
+      *        the source array, must be a 16-bit primitive array type
+      * @param srcPos
+      *        byte offset within source array of the first element to read
+      * @param dstAddr
+      *        destination address
+      * @param length
+      *        number of bytes to copy
+      */
      static native void copyFromShortArray(Object src, long srcPos, long dstAddr,
                                            long length);
+ 
+     /**
+      * Copy and byte swap 16-bit elements from off-heap memory to a heap array
+      *
+      * @param srcAddr
+      *        source address
+      * @param dst
+      *        destination array, must be a 16-bit primitive array type
+      * @param dstPos
+      *        byte offset within the destination array of the first element to write
+      * @param length
+      *        number of bytes to copy
+      */
      static native void copyToShortArray(long srcAddr, Object dst, long dstPos,
                                          long length);
  
+     /**
+      * Copy and byte swap 32-bit elements from a heap array to off-heap memory
+      *
+      * @param src
+      *        the source array, must be a 32-bit primitive array type
+      * @param srcPos
+      *        byte offset within source array of the first element to read
+      * @param dstAddr
+      *        destination address
+      * @param length
+      *        number of bytes to copy
+      */
      static native void copyFromIntArray(Object src, long srcPos, long dstAddr,
                                          long length);
+ 
+     /**
+      * Copy and byte swap 32-bit elements from off-heap memory to a heap array
+      *
+      * @param srcAddr
+      *        source address
+      * @param dst
+      *        destination array, must be a 32-bit primitive array type
+      * @param dstPos
+      *        byte offset within the destination array of the first element to write
+      * @param length
+      *        number of bytes to copy
+      */
      static native void copyToIntArray(long srcAddr, Object dst, long dstPos,
                                        long length);
  
+     /**
+      * Copy and byte swap 64-bit elements from a heap array to off-heap memory
+      *
+      * @param src
+      *        the source array, must be a 64-bit primitive array type
+      * @param srcPos
+      *        byte offset within source array of the first element to read
+      * @param dstAddr
+      *        destination address
+      * @param length
+      *        number of bytes to copy
+      */
      static native void copyFromLongArray(Object src, long srcPos, long dstAddr,
                                           long length);
+ 
+     /**
+      * Copy and byte swap 64-bit elements from off-heap memory to a heap array
+      *
+      * @param srcAddr
+      *        source address
+      * @param dst
+      *        destination array, must be a 64-bit primitive array type
+      * @param dstPos
+      *        byte offset within the destination array of the first element to write
+      * @param length
+      *        number of bytes to copy
+      */
      static native void copyToLongArray(long srcAddr, Object dst, long dstPos,
                                         long length);
  
  }