src/java.base/share/classes/java/nio/channels/DatagramChannel.java

@@ -148,10 +148,13 @@
       *
       * @return  A new datagram channel
       *
       * @throws  IOException
       *          If an I/O error occurs
+      *
+      * @see     <a href="../../net/doc-files/net-properties.html#Ipv4IPv6">
+      *          java.net.preferIPv4Stack</a> system property
       */
      public static DatagramChannel open() throws IOException {
          return SelectorProvider.provider().openDatagramChannel();
      }
  

@@ -167,10 +170,13 @@
       * java.nio.channels.spi.SelectorProvider#openDatagramChannel(ProtocolFamily)
       * openDatagramChannel} method of the system-wide default {@link
       * java.nio.channels.spi.SelectorProvider} object.  The channel will not be
       * connected.
       *
+      * @apiNote <a href="package-summary.html#unixdomain">Unix domain</a> sockets
+      * are not supported by DatagramChannel.
+      *
       * @param   family
       *          The protocol family
       *
       * @return  A new datagram channel
       *

@@ -180,10 +186,13 @@
       *          java.net.StandardProtocolFamily#INET6 StandardProtocolFamily.INET6}
       *          but IPv6 is not enabled on the platform.
       * @throws  IOException
       *          If an I/O error occurs
       *
+      * @see     <a href="../../net/doc-files/net-properties.html#Ipv4IPv6">
+      *          java.net.preferIPv4Stack</a> system property
+      *
       * @since   1.7
       */
      public static DatagramChannel open(ProtocolFamily family) throws IOException {
          return SelectorProvider.provider().openDatagramChannel(requireNonNull(family));
      }

@@ -627,7 +636,6 @@
       * @throws  ClosedChannelException     {@inheritDoc}
       * @throws  IOException                {@inheritDoc}
       */
      @Override
      public abstract SocketAddress getLocalAddress() throws IOException;
- 
  }