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

@@ -266,38 +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 represents a network socket
-      * then the {@link java.nio.channels.Channel Channel} type returned
+      * <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 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.
+      *  <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 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.
+      *  <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 java.nio.channels.DatagramChannel DatagramChannel} is
-      *  returned. The datagram channel is, at least initially, in blocking
-      *  mode, and bound to a socket address.
+      *  <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 addition to the network-oriented channels described, this method
-      * may return other kinds of channels in the future.
+      * <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>
       *