--- old/src/java.base/share/classes/java/nio/channels/package-info.java 2017-08-09 16:52:59.072698254 -0700 +++ new/src/java.base/share/classes/java/nio/channels/package-info.java 2017-08-09 16:52:58.856688758 -0700 @@ -30,46 +30,50 @@ * * * - *
+ *
* **
+ * + * - *- * Channels - *Description + * {@link java.nio.channels.Channel} + * + *+ * + * Channels + *Description - * {@link java.nio.channels.Channel} *A nexus for I/O operations - * {@link java.nio.channels.ReadableByteChannel} + *- * + * {@link java.nio.channels.ReadableByteChannel} *Can read into a buffer - * - * {@link java.nio.channels.ScatteringByteChannel} - *Can read into a sequence of buffers - * {@link java.nio.channels.WritableByteChannel} + *+ * + * {@link java.nio.channels.ScatteringByteChannel} + *Can read into a sequence of buffers - * + * {@link java.nio.channels.WritableByteChannel} *Can write from a buffer - * - * {@link java.nio.channels.GatheringByteChannel} - *Can write from a sequence of buffers - * - * {@link java.nio.channels.ByteChannel} - *Can read/write to/from a buffer - * {@link java.nio.channels.SeekableByteChannel} + *+ * + * {@link java.nio.channels.GatheringByteChannel} + *Can write from a sequence of buffers + * + * {@link java.nio.channels.ByteChannel} + *Can read/write to/from a buffer - * + * {@link java.nio.channels.SeekableByteChannel} *A {@code ByteChannel} connected to an entity that contains a variable-length * sequence of bytes - * {@link java.nio.channels.AsynchronousChannel} + *- * + * {@link java.nio.channels.AsynchronousChannel} *Supports asynchronous I/O operations. - * {@link java.nio.channels.AsynchronousByteChannel} + *- * + * {@link java.nio.channels.AsynchronousByteChannel} *Can read and write bytes asynchronously - * {@link java.nio.channels.NetworkChannel} + *- * + * {@link java.nio.channels.NetworkChannel} *A channel to a network socket - * {@link java.nio.channels.MulticastChannel} + *- * + * {@link java.nio.channels.MulticastChannel} *Can join Internet Protocol (IP) multicast groups {@link java.nio.channels.Channels} + *- * {@link java.nio.channels.Channels} *Utility methods for channel/stream interoperation A channel represents an open connection to an entity such as a * hardware device, a file, a network socket, or a program component that is @@ -122,21 +126,25 @@ * be constructed that uses a given charset to encode characters into bytes and * write them to a given writable byte channel. * - *
+ *
* **
+ * - *- * File channels - *Description + * - * {@link java.nio.channels.FileChannel} + * + *+ * + * File channels + *Description - * + * {@link java.nio.channels.FileChannel} *Reads, writes, maps, and manipulates files - * {@link java.nio.channels.FileLock} + *- * + * {@link java.nio.channels.FileLock} *A lock on a (region of a) file - * - * {@link java.nio.MappedByteBuffer} - *A direct byte buffer mapped to a region of a file + * + * + * {@link java.nio.MappedByteBuffer} + *A direct byte buffer mapped to a region of a file The {@link java.nio.channels.FileChannel} class supports the usual * operations of reading bytes from, and writing bytes to, a channel connected to @@ -156,36 +164,40 @@ * class. * * - *
+ *
* **
+ * - *- * Multiplexed, non-blocking I/O - *Description + * {@link java.nio.channels.SelectableChannel} + * + *+ * + * Multiplexed, non-blocking I/O + *Description - * {@link java.nio.channels.SelectableChannel} *A channel that can be multiplexed - * {@link java.nio.channels.DatagramChannel} + *- * + * {@link java.nio.channels.DatagramChannel} *A channel to a datagram-oriented socket - * {@link java.nio.channels.Pipe.SinkChannel} + *- * + * {@link java.nio.channels.Pipe.SinkChannel} *The write end of a pipe - * {@link java.nio.channels.Pipe.SourceChannel} + *- * + * {@link java.nio.channels.Pipe.SourceChannel} *The read end of a pipe - * {@link java.nio.channels.ServerSocketChannel} + *- * + * {@link java.nio.channels.ServerSocketChannel} *A channel to a stream-oriented listening socket - * {@link java.nio.channels.SocketChannel} + *- * + * {@link java.nio.channels.SocketChannel} *A channel for a stream-oriented connecting socket {@link java.nio.channels.Selector} + *- * {@link java.nio.channels.Selector} *A multiplexor of selectable channels - * {@link java.nio.channels.SelectionKey} - *A token representing the registration
of a channel - * with a selector- * {@link java.nio.channels.Pipe} - *Two channels that form a unidirectional pipe + * {@link java.nio.channels.SelectionKey} + *A token representing the registration of a channel + * with a selector + * + * {@link java.nio.channels.Pipe} + *Two channels that form a unidirectional pipe Multiplexed, non-blocking I/O, which is much more scalable than * thread-oriented, blocking I/O, is provided by selectors, selectable @@ -251,27 +263,31 @@ * * * - *
+ *
* **
+ * + * - *- * - * Asynchronous I/O Description + * - * {@link java.nio.channels.AsynchronousFileChannel} + * + *+ * + * Asynchronous I/O + *Description - * + * {@link java.nio.channels.AsynchronousFileChannel} *An asynchronous channel for reading, writing, and manipulating a file - * {@link java.nio.channels.AsynchronousSocketChannel} + *- * + * {@link java.nio.channels.AsynchronousSocketChannel} *An asynchronous channel to a stream-oriented connecting socket - * {@link java.nio.channels.AsynchronousServerSocketChannel} + *- * + * {@link java.nio.channels.AsynchronousServerSocketChannel} *An asynchronous channel to a stream-oriented listening socket - * {@link java.nio.channels.CompletionHandler} + *- * + * {@link java.nio.channels.CompletionHandler} *A handler for consuming the result of an asynchronous operation - * {@link java.nio.channels.AsynchronousChannelGroup} + *- * + * {@link java.nio.channels.AsynchronousChannelGroup} *A grouping of asynchronous channels for the purpose of resource sharing {@link java.nio.channels.AsynchronousChannel Asynchronous channels} are a * special type of channel capable of asynchronous I/O operations. Asynchronous