src/java.base/share/classes/java/nio/channels/spi/SelectorProvider.java

*** 266,38 ***
       * on UNIX systems, the Internet services daemon (<i>inetd</i>) is used to
       * start programs to service requests when a request arrives on an
       * associated network port. In this example, the process that is started,
       * inherits a channel representing a network socket.
       *
!      * <p> In cases where the inherited channel represents a network socket
!      * then the {@link java.nio.channels.Channel Channel} type returned
       * by this method is determined as follows:
       *
       * <ul>
       *
!      *  <li><p> If the inherited channel represents a stream-oriented connected
!      *  socket then a {@link java.nio.channels.SocketChannel SocketChannel} is
!      *  returned. The socket channel is, at least initially, in blocking
!      *  mode, bound to a socket address, and connected to a peer.
       *  </p></li>
       *
!      *  <li><p> If the inherited channel represents a stream-oriented listening
!      *  socket then a {@link java.nio.channels.ServerSocketChannel
!      *  ServerSocketChannel} is returned. The server-socket channel is, at
!      *  least initially, in blocking mode, and bound to a socket address.
       *  </p></li>
       *
!      *  <li><p> If the inherited channel is a datagram-oriented socket
!      *  then a {@link java.nio.channels.DatagramChannel DatagramChannel} is
!      *  returned. The datagram channel is, at least initially, in blocking
-      *  mode, and bound to a socket address.
       *  </p></li>
       *
       * </ul>
       *
!      * <p> In addition to the network-oriented channels described, this method
!      * may return other kinds of channels in the future.
       *
       * <p> The first invocation of this method creates the channel that is
       * returned. Subsequent invocations of this method return the same
       * channel. </p>
       *
--- 266,42 ---
       * on UNIX systems, the Internet services daemon (<i>inetd</i>) is used to
       * start programs to service requests when a request arrives on an
       * associated network port. In this example, the process that is started,
       * inherits a channel representing a network socket.
       *
!      * <p> In cases where the inherited channel is for an <i>Internet protocol</i>
!      * socket then the {@link Channel Channel} type returned
       * by this method is determined as follows:
       *
       * <ul>
       *
!      *  <li><p> If the inherited channel is for a stream-oriented connected
!      *  socket then a {@link SocketChannel SocketChannel} is returned. The
!      *  socket channel is, at least initially, in blocking mode, bound
!      *  to a socket address, and connected to a peer.
       *  </p></li>
       *
!      *  <li><p> If the inherited channel is for a stream-oriented listening
!      *  socket then a {@link ServerSocketChannel ServerSocketChannel} is returned.
!      *  The server-socket channel is, at least initially, in blocking mode,
!      *  and bound to a socket address.
       *  </p></li>
       *
!      *  <li><p> If the inherited channel is a datagram-oriented socket then a
!      *  {@link DatagramChannel DatagramChannel} is returned. The datagram channel
!      *  is, at least initially, in blocking mode, and bound to a socket address.
       *  </p></li>
       *
       * </ul>
       *
!      * <p> In cases where the inherited channel is for a <i>Unix domain</i>
!      * socket then the {@link Channel} type returned is the same as for
+      * <i>Internet protocol</i> sockets as described above, except that
+      * datagram-oriented sockets are not supported.
+      *
+      * <p> In addition to the two types of socket just described, this method
+      * may return other types in the future.
       *
       * <p> The first invocation of this method creates the channel that is
       * returned. Subsequent invocations of this method return the same
       * channel. </p>
       *