src/java.base/share/classes/java/net/MulticastSocket.java

@@ -76,11 +76,49 @@
  * members of the group and port.  A socket relinquishes membership
  * in a group by the leaveGroup(InetAddress addr) method.  <B>
  * Multiple MulticastSocket's</B> may subscribe to a multicast group
  * and port concurrently, and they will all receive group datagrams.
  * <P>
- * Currently applets are not allowed to use multicast sockets.
+ *
+ * <p> The {@code DatagramSocket} and {@code MulticastSocket} classes offer
+ * some convenience methods (such as {@link DatagramSocket#setReuseAddress(boolean)
+ * setReuseAddress}) to get and set some commonly used options. However, socket
+ * options can be more generally configured using the
+ * {@link #setOption(SocketOption, Object) setOption} method.
+ *  In addition to the socket options supported by
+ * <a href="DatagramSocket.html#SocketOptions">{@code DatagramSocket}</a>, a
+ * {@code MulticastSocket} supports the following socket options:
+ * <blockquote>
+ * <a id="MulticastOptions"></a>
+ * <table class="striped">
+ * <caption style="display:none">Socket options</caption>
+ * <thead>
+ *   <tr>
+ *     <th scope="col">Option Name</th>
+ *     <th scope="col">Description</th>
+ *   </tr>
+ * </thead>
+ * <tbody>
+ *   <tr>
+ *     <th scope="row"> {@link java.net.StandardSocketOptions#IP_MULTICAST_IF IP_MULTICAST_IF} </th>
+ *     <td> The network interface for Internet Protocol (IP) multicast datagrams </td>
+ *   </tr>
+ *   <tr>
+ *     <th scope="row"> {@link java.net.StandardSocketOptions#IP_MULTICAST_TTL
+ *       IP_MULTICAST_TTL} </th>
+ *     <td> The <em>time-to-live</em> for Internet Protocol (IP) multicast
+ *       datagrams </td>
+ *   </tr>
+ *   <tr>
+ *     <th scope="row"> {@link java.net.StandardSocketOptions#IP_MULTICAST_LOOP
+ *       IP_MULTICAST_LOOP} </th>
+ *     <td> Loopback for Internet Protocol (IP) multicast datagrams </td>
+ *   </tr>
+ * </tbody>
+ * </table>
+ * </blockquote>
+ * Additional (implementation specific) options may also be supported.
  *
  * @author Pavani Diwanji
  * @since  1.1
  */
 public class MulticastSocket extends DatagramSocket {