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;
-
 }