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

*** 148,157 ****
--- 148,160 ----
       *
       * @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,176 ****
--- 170,182 ----
       * 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,189 ****
--- 186,198 ----
       *          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,633 ****
       * @throws  ClosedChannelException     {@inheritDoc}
       * @throws  IOException                {@inheritDoc}
       */
      @Override
      public abstract SocketAddress getLocalAddress() throws IOException;
- 
  }
--- 636,641 ----