jdk-sandbox: comparison jdk/src/java.base/share/classes/java/nio/channels/package-info.java

equal deleted inserted replaced

-:b3e220a04d3f
+:047bdc4d771d
 * performing I/O operations, such as files and sockets; defines selectors, for
 * multiplexed, non-blocking I/O operations.
 *
 * <a id="channels"></a>
 *
-* <blockquote><table class="borderless">
+* <table class="striped" style="text-align:left; margin-left:2em">
 *     <caption style="display:none">Lists channels and their descriptions</caption>
-* <tr><th style="text-align:left">Channels</th>
+* <thead>
-*     <th style="text-align:left">Description</th></tr>
+* <tr><th scope="col">Channels</th>
-* <tr><td style="vertical-align:top"><i>{@link java.nio.channels.Channel}</i></td>
+*     <th scope="col">Description</th></tr>
+* </thead>
+* <tbody>
+* <tr><th scope="row"><i>{@link java.nio.channels.Channel}</i></th>
 *     <td>A nexus for I/O operations</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;<i>{@link java.nio.channels.ReadableByteChannel}</i></td>
+*     <span style="padding-left:1em"><i>{@link java.nio.channels.ReadableByteChannel}</i></span></th>
 *     <td>Can read into a buffer</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;&nbsp;&nbsp;<i>{@link java.nio.channels.ScatteringByteChannel}&nbsp;&nbsp;</i></td>
+*     <span style="padding-left:2em"><i>{@link java.nio.channels.ScatteringByteChannel}</i></span></th>
-*     <td>Can read into a sequence of&nbsp;buffers</td></tr>
+*     <td>Can read into a sequence of buffers</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;<i>{@link java.nio.channels.WritableByteChannel}</i></td>
+*     <span style="padding-left:1em"><i>{@link java.nio.channels.WritableByteChannel}</i></span></th>
 *     <td>Can write from a buffer</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;&nbsp;&nbsp;<i>{@link java.nio.channels.GatheringByteChannel}</i></td>
+*     <span style="padding-left:2em"><i>{@link java.nio.channels.GatheringByteChannel}</i></span></th>
-*     <td>Can write from a sequence of&nbsp;buffers</td></tr>
+*     <td>Can write from a sequence of buffers</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;<i>{@link java.nio.channels.ByteChannel}</i></td>
+*     <span style="padding-left:1em"><i>{@link java.nio.channels.ByteChannel}</i></span></th>
-*     <td>Can read/write to/from a&nbsp;buffer</td></tr>
+*     <td>Can read/write to/from a buffer</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;&nbsp;&nbsp;<i>{@link java.nio.channels.SeekableByteChannel}</i></td>
+*     <span style="padding-left:2em"><i>{@link java.nio.channels.SeekableByteChannel}</i></span></th>
 *     <td>A {@code ByteChannel} connected to an entity that contains a variable-length
 *         sequence of bytes</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;<i>{@link java.nio.channels.AsynchronousChannel}</i></td>
+*     <span style="padding-left:1em"><i>{@link java.nio.channels.AsynchronousChannel}</i></span></th>
 *     <td>Supports asynchronous I/O operations.</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;&nbsp;&nbsp;<i>{@link java.nio.channels.AsynchronousByteChannel}</i></td>
+*     <span style="padding-left:2em"><i>{@link java.nio.channels.AsynchronousByteChannel}</i></span></th>
 *     <td>Can read and write bytes asynchronously</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;<i>{@link java.nio.channels.NetworkChannel}</i></td>
+*     <span style="padding-left:1em"><i>{@link java.nio.channels.NetworkChannel}</i></span></th>
 *     <td>A channel to a network socket</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;&nbsp;&nbsp;<i>{@link java.nio.channels.MulticastChannel}</i></td>
+*     <span style="padding-left:2em"><i>{@link java.nio.channels.MulticastChannel}</i></span></th>
 *     <td>Can join Internet Protocol (IP) multicast groups</td></tr>
-* <tr><td style="vertical-align:top">{@link java.nio.channels.Channels}</td>
+* <tr><th scope="row">{@link java.nio.channels.Channels}</th>
 *     <td>Utility methods for channel/stream interoperation</td></tr>
-* </table></blockquote>
+* </tbody>
+* </table>
 *
 * <p> A <i>channel</i> represents an open connection to an entity such as a
 * hardware device, a file, a network socket, or a program component that is
 * capable of performing one or more distinct I/O operations, for example reading
 * or writing.  As specified in the {@link java.nio.channels.Channel} interface,
 * java.io.Reader} can be constructed that uses a given charset to decode bytes
 * from a given readable byte channel, and conversely a {@link java.io.Writer} can
 * be constructed that uses a given charset to encode characters into bytes and
 * write them to a given writable byte channel.
 *
-* <blockquote><table class="borderless">
+* <table class="striped" style="margin-left:2em; text-align:left">
 *     <caption style="display:none">
 *         Lists file channels and their descriptions</caption>
-* <tr><th style="text-align:left">File channels</th>
+* <thead>
-*     <th style="text-align:left">Description</th></tr>
+* <tr><th scope="col">File channels</th>
-* <tr><td style="vertical-align:top">
+*     <th scope="col">Description</th></tr>
-*     {@link java.nio.channels.FileChannel}</td>
+* </thead>
+* <tbody>
+* <tr><th scope="row">
+*     {@link java.nio.channels.FileChannel}</th>
 *     <td>Reads, writes, maps, and manipulates files</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     {@link java.nio.channels.FileLock}</td>
+*     {@link java.nio.channels.FileLock}</th>
 *     <td>A lock on a (region of a) file</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     {@link java.nio.MappedByteBuffer}&nbsp;&nbsp;</td>
+*     {@link java.nio.MappedByteBuffer}</th>
-*     <td>A direct byte buffer mapped to a region of a&nbsp;file</td></tr>
+*     <td>A direct byte buffer mapped to a region of a file</td></tr>
-* </table></blockquote>
+* </tbody>
+* </table>
 *
 * <p> The {@link java.nio.channels.FileChannel} class supports the usual
 * operations of reading bytes from, and writing bytes to, a channel connected to
 * a file, as well as those of querying and modifying the current file position
 * and truncating the file to a specific size.  It defines methods for acquiring
 * java.io.FileOutputStream}, or {@link java.io.RandomAccessFile} to return a
 * file channel connected to the same underlying file as the {@link java.io}
 * class.
 *
 * <a id="multiplex"></a>
-* <blockquote><table class="borderless">
+* <table class="striped" style="margin-left:2em; text-align:left">
 *     <caption style="display:none">
 *         Lists multiplexed, non-blocking channels and their descriptions</caption>
-* <tr><th style="text-align:left">Multiplexed, non-blocking I/O</th>
+* <thead>
-*     <th style="text-align:left">Description</th></tr>
+* <tr><th scope="col">Multiplexed, non-blocking I/O</th>
-* <tr><td style="vertical-align:top">{@link java.nio.channels.SelectableChannel}</td>
+*     <th scope="col">Description</th></tr>
+* </thead>
+* <tbody>
+* <tr><th scope="row">{@link java.nio.channels.SelectableChannel}</th>
 *     <td>A channel that can be multiplexed</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;{@link java.nio.channels.DatagramChannel}</td>
+*     <span style="padding-left:2em">{@link java.nio.channels.DatagramChannel}</span></th>
 *     <td>A channel to a datagram-oriented socket</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;{@link java.nio.channels.Pipe.SinkChannel}</td>
+*     <span style="padding-left:2em">{@link java.nio.channels.Pipe.SinkChannel}</span></th>
 *     <td>The write end of a pipe</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;{@link java.nio.channels.Pipe.SourceChannel}</td>
+*     <span style="padding-left:2em">{@link java.nio.channels.Pipe.SourceChannel}</span></th>
 *     <td>The read end of a pipe</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;{@link java.nio.channels.ServerSocketChannel}&nbsp;&nbsp;</td>
+*     <span style="padding-left:2em">{@link java.nio.channels.ServerSocketChannel}</span></th>
 *     <td>A channel to a stream-oriented listening socket</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     &nbsp;&nbsp;{@link java.nio.channels.SocketChannel}</td>
+*     <span style="padding-left:2em">{@link java.nio.channels.SocketChannel}</span></th>
 *     <td>A channel for a stream-oriented connecting socket</td></tr>
-* <tr><td style="vertical-align:top">{@link java.nio.channels.Selector}</td>
+* <tr><th scope="row">{@link java.nio.channels.Selector}</th>
 *     <td>A multiplexor of selectable channels</td></tr>
-* <tr><td style="vertical-align:top">{@link java.nio.channels.SelectionKey}</td>
+* <tr><th scope="row">{@link java.nio.channels.SelectionKey}</th>
-*     <td>A token representing the registration <br> of a channel
+*     <td>A token representing the registration of a channel
-*     with&nbsp;a&nbsp;selector</td></tr>
+*     with a selector</td></tr>
-* <tr><td style="vertical-align:top">{@link java.nio.channels.Pipe}</td>
+* <tr><th scope="row">{@link java.nio.channels.Pipe}</th>
-*     <td>Two channels that form a unidirectional&nbsp;pipe</td></tr>
+*     <td>Two channels that form a unidirectional pipe</td></tr>
-* </table></blockquote>
+* </tbody>
+* </table>
 *
 * <p> Multiplexed, non-blocking I/O, which is much more scalable than
 * thread-oriented, blocking I/O, is provided by <i>selectors</i>, <i>selectable
 * channels</i>, and <i>selection keys</i>.
 *
 * directly; custom channel classes should extend the appropriate {@link
 * java.nio.channels.SelectableChannel} subclasses defined in this package.
 *
 * <a id="async"></a>
 *
-* <blockquote><table class="borderless">
+* <table class="striped" style="padding-left:2em; text-align:left">
 *     <caption style="display:none">
 *         Lists asynchronous channels and their descriptions</caption>
-* <tr><th style="text-align:left">
+* <thead>
-*     Asynchronous I/O</th><th style="text-align:left">Description</th></tr>
+* <tr><th scope="col">Asynchronous I/O</th>
-* <tr><td style="vertical-align:top">
+*     <th scope="col">Description</th></tr>
-*     {@link java.nio.channels.AsynchronousFileChannel}</td>
+* </thead>
+* <tbody>
+* <tr><th scope="row">
+*     {@link java.nio.channels.AsynchronousFileChannel}</th>
 *     <td>An asynchronous channel for reading, writing, and manipulating a file</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     {@link java.nio.channels.AsynchronousSocketChannel}</td>
+*     {@link java.nio.channels.AsynchronousSocketChannel}</th>
 *     <td>An asynchronous channel to a stream-oriented connecting socket</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     {@link java.nio.channels.AsynchronousServerSocketChannel}&nbsp;&nbsp;</td>
+*     {@link java.nio.channels.AsynchronousServerSocketChannel}</th>
 *     <td>An asynchronous channel to a stream-oriented listening socket</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     {@link java.nio.channels.CompletionHandler}</td>
+*     {@link java.nio.channels.CompletionHandler}</th>
 *     <td>A handler for consuming the result of an asynchronous operation</td></tr>
-* <tr><td style="vertical-align:top">
+* <tr><th scope="row">
-*     {@link java.nio.channels.AsynchronousChannelGroup}</td>
+*     {@link java.nio.channels.AsynchronousChannelGroup}</th>
 *     <td>A grouping of asynchronous channels for the purpose of resource sharing</td></tr>
-* </table></blockquote>
+* </tbody>
+* </table>
 *
 * <p> {@link java.nio.channels.AsynchronousChannel Asynchronous channels} are a
 * special type of channel capable of asynchronous I/O operations. Asynchronous
 * channels are non-blocking and define methods to initiate asynchronous
 * operations, returning a {@link java.util.concurrent.Future} representing the

changeset 46147	047bdc4d771d
parent 45437	c48b8edad8dd