BindException.java, [...]: add/update of some @since/@deprecated

2002-08-27 Michael Koch <konqueror@gmx.de> * java/net/BindException.java, java/net/JarURLConnection.java, java/net/FileNameMap.java, java/net/HttpURLConnection.java, java/net/InetSocketAddress.java, java/net/DatagramPacket.java, java/net/DatagramSocket.java, java/net/DatagramSocketImpl.java, java/net/MulticastSocket.java, java/net/PasswordAuthentication.java, java/net/ServerSocket.java, java/net/Socket.java, java/net/URLClassLoader.java, java/net/URLConnection.java: add/update of some @since/@deprecated From-SVN: r56608
2002-08-27 17:47:27 +00:00
parent 1985ef9094
commit 49c3c980ca
15 changed files with 68 additions and 10 deletions
@@ -43,6 +43,7 @@ package java.net;
 *
 * @author Aaron M. Renn <arenn@urbanophile.com>
 * @author Warren Levy <warrenl@cygnus.com>
+ * @since 1.1
 * @status updated to 1.4
 */
 public class BindException extends SocketException
@@ -103,7 +103,7 @@ public final class DatagramPacket
  * @param offset The offset into the buffer to start writing.
  * @param length The maximum number of bytes to read.
  *
-  * @since Java 1.2
+  * @since 1.2
  */
  public DatagramPacket(byte[] buf, int offset, int length)
  {
@@ -146,7 +146,7 @@ public final class DatagramPacket
  * @param addr The address to send to
  * @param port The port to send to
  *
-  * @since Java 1.2
+  * @since 1.2
  */
  public DatagramPacket(byte[] buf, int offset, int length,
 	InetAddress address, int port)
@@ -230,7 +230,7 @@ public final class DatagramPacket
  *
  * @return The buffer offset.
  *
-  * @since Java 1.2
+  * @since 1.2
  */
  public synchronized int getOffset()
  {
@@ -251,6 +251,8 @@ public final class DatagramPacket
  * This sets the address to which the data packet will be transmitted.
  *
  * @param addr The destination address
+  *
+  * @since 1.1
  */
  public synchronized void setAddress(InetAddress iaddr)
  {
@@ -264,6 +266,8 @@ public final class DatagramPacket
  * This sets the port to which the data packet will be transmitted.
  *
  * @param port The destination port
+  *
+  * @since 1.1
  */
  public synchronized void setPort(int iport)
  {
@@ -277,6 +281,8 @@ public final class DatagramPacket
  * Sets the data buffer for this packet.
  *
  * @param buf The new buffer for this packet
+  *
+  * @since 1.1
  */
  public synchronized void setData(byte[] buf)
  {
@@ -295,7 +301,7 @@ public final class DatagramPacket
  * @param offset The offset into the buffer to start reading data from.
  * @param length The number of bytes of data in the buffer.
  *
-  * @since Java 1.2
+  * @since 1.2
  */
  public synchronized void setData(byte[] buf, int offset, int length)
  {
@@ -320,6 +326,8 @@ public final class DatagramPacket
  * Sets the length of the data in the buffer. 
  *
  * @param length The new length.  (Where len <= buf.length)
+  *
+  * @since 1.1
  */
  public synchronized void setLength(int length)
  {
@@ -117,6 +117,9 @@ public class DatagramSocket
    return impl.getLocalPort();
  }

+  /**
+   * @since 1.1
+   */
  public synchronized int getSoTimeout() throws SocketException
  {
    Object timeout = impl.getOption(SocketOptions.SO_TIMEOUT);
@@ -152,6 +155,9 @@ public class DatagramSocket
    impl.send(p);
  }

+  /**
+   * @since 1.1
+   */
  public synchronized void setSoTimeout(int timeout) throws SocketException
  {
    if (timeout < 0)
@@ -53,6 +53,7 @@ import java.io.FileDescriptor;
 *
 * @author Aaron M. Renn (arenn@urbanophile.com)
 * @author Warren Levy <warrenl@cygnus.com>
+ * @since 1.1
 */
 public abstract class DatagramSocketImpl implements SocketOptions
 {
@@ -50,6 +50,7 @@ package java.net;
  *
  * @author Aaron M. Renn (arenn@urbanophile.com)
  * @author Warren Levy <warrenl@cygnus.com>
+  * @since 1.1
  */
 public interface FileNameMap
 {
@@ -15,6 +15,7 @@ import java.io.*;

 /**
 * @author Warren Levy <warrenl@cygnus.com>
+ * @since 1.1
 * @date March 29, 1999.
 */

@@ -41,6 +41,8 @@ package java.net;
 * InetSocketAddress instances represent socket addresses
 * in the java.nio package. They encapsulate a InetAddress and
 * a port number.
+ *
+ * @since 1.4
 */

 public class InetSocketAddress extends SocketAddress
@@ -18,6 +18,7 @@ import java.util.Hashtable;

 /**
 * @author Kresten Krab Thorup <krab@gnu.org>
+ * @since 1.2
 * @date Aug 10, 1999.
 */

@@ -60,6 +60,7 @@ import java.io.IOException;
  *
  * @author Warren Levy <warrenl@cygnus.com>
  * @author Aaron M. Renn (arenn@urbanophile.com) (Documentation comments)
+  * @since 1.1
  * @date May 18, 1999.
  */
 public class MulticastSocket extends DatagramSocket
@@ -41,6 +41,7 @@ package java.net;
  * This class serves a container for username/password pairs.
  *
  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @since 1.2
  */
 public final class PasswordAuthentication
 {
@@ -129,6 +129,8 @@ public class ServerSocket
   * @param bindAddr The address to bind to, or null to bind to all addresses
   *
   * @exception IOException If an error occurs
+   *
+   * @since 1.1
   */
  public ServerSocket (int port, int backlog, InetAddress bindAddr)
    throws java.io.IOException
@@ -192,6 +194,8 @@ public class ServerSocket
   * @param socket The socket that is used for the accepted connection
   *
   * @exception IOException If an error occurs
+   *
+   * @since 1.1
   */
  protected final void implAccept (Socket s)  throws IOException
  {
@@ -217,6 +221,8 @@ public class ServerSocket
   * @param timeout The new SO_TIMEOUT value
   *
   * @exception IOException If an error occurs
+   *
+   * @since 1.1
   */
  public void setSoTimeout (int timeout) throws SocketException
  {
@@ -235,6 +241,8 @@ public class ServerSocket
   * @return The value of SO_TIMEOUT
   *
   * @exception IOException If an error occurs
+   *
+   * @since 1.1
   */
  public int getSoTimeout () throws IOException
  {
@@ -534,7 +534,7 @@ public class Socket
   *
   * @exception SocketException If an error occurs or Socket not connected
   *
-   * @since Java 1.2
+   * @since 1.2
   */
  public void setSendBufferSize (int size) throws SocketException
  {
@@ -556,7 +556,7 @@ public class Socket
   *
   * @exception SocketException If an error occurs or socket not connected
   *
-   * @since Java 1.2
+   * @since 1.2
   */
  public int getSendBufferSize () throws SocketException
  {
@@ -580,7 +580,7 @@ public class Socket
   *
   * @exception SocketException If an error occurs or Socket is not connected
   *
-   * @since Java 1.2
+   * @since 1.2
   */
  public void setReceiveBufferSize (int size) throws SocketException
  {
@@ -602,7 +602,7 @@ public class Socket
   *
   * @exception SocketException If an error occurs or Socket is not connected
   *
-   * @since Java 1.2
+   * @since 1.2
   */
  public int getReceiveBufferSize () throws SocketException
  {
@@ -13,6 +13,9 @@ import java.util.jar.*;
 import java.util.Enumeration;
 import java.util.Vector;

+/**
+ * @since 1.2
+ */
 public class URLClassLoader extends ClassLoader 
 {
  // The URLStreamHandlerFactory
@@ -300,6 +300,9 @@ public abstract class URLConnection
    // default request properties.
  }

+  /**
+   * @deprecated 1.3
+   */
  public static String getDefaultRequestProperty(String key)
  {
    // Overridden by subclasses that support default request properties.
@@ -346,13 +349,17 @@ public abstract class URLConnection

 // TODO12:  protected void parseURL(URL u, String spec, int start, int limit)

-  // JDK1.2
+  /**
+   * @since 1.2
+   */
  public static FileNameMap getFileNameMap()
  {
    return fileNameMap;
  }

-  // JDK1.2
+  /**
+   * @since 1.2
+   */
  public static void setFileNameMap(FileNameMap map)
  {
    // Throw an exception if an extant security mgr precludes