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

15 files changed, 68 insertions, 10 deletions

diff --git a/libjava/ChangeLog b/libjava/ChangeLog
index 5724512..f400148 100644
--- a/libjava/ChangeLog
+++ b/libjava/ChangeLog
@@ -1,3 +1,20 @@
+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
+	
 2002-08-27  Tony Kimball <alk@pobox.com>
             Tom Tromey  <tromey@redhat.com>
 
diff --git a/libjava/java/net/BindException.java b/libjava/java/net/BindException.java
index 3d11c4a..cfc36b3 100644
--- a/libjava/java/net/BindException.java
+++ b/libjava/java/net/BindException.java
@@ -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
diff --git a/libjava/java/net/DatagramPacket.java b/libjava/java/net/DatagramPacket.java
index a2482f9..2140f45 100644
--- a/libjava/java/net/DatagramPacket.java
+++ b/libjava/java/net/DatagramPacket.java
@@ -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)
   {
diff --git a/libjava/java/net/DatagramSocket.java b/libjava/java/net/DatagramSocket.java
index 064e8e7..7fc21ff 100644
--- a/libjava/java/net/DatagramSocket.java
+++ b/libjava/java/net/DatagramSocket.java
@@ -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)
diff --git a/libjava/java/net/DatagramSocketImpl.java b/libjava/java/net/DatagramSocketImpl.java
index e929e50..260088d 100644
--- a/libjava/java/net/DatagramSocketImpl.java
+++ b/libjava/java/net/DatagramSocketImpl.java
@@ -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
 {
diff --git a/libjava/java/net/FileNameMap.java b/libjava/java/net/FileNameMap.java
index e29c812..538dbe8 100644
--- a/libjava/java/net/FileNameMap.java
+++ b/libjava/java/net/FileNameMap.java
@@ -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
 {
diff --git a/libjava/java/net/HttpURLConnection.java b/libjava/java/net/HttpURLConnection.java
index 84e9468..c106ed2 100644
--- a/libjava/java/net/HttpURLConnection.java
+++ b/libjava/java/net/HttpURLConnection.java
@@ -15,6 +15,7 @@ import java.io.*;
 
 /**
  * @author Warren Levy <warrenl@cygnus.com>
+ * @since 1.1
  * @date March 29, 1999.
  */
 
diff --git a/libjava/java/net/InetSocketAddress.java b/libjava/java/net/InetSocketAddress.java
index c542b80..6db6baf 100644
--- a/libjava/java/net/InetSocketAddress.java
+++ b/libjava/java/net/InetSocketAddress.java
@@ -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
diff --git a/libjava/java/net/JarURLConnection.java b/libjava/java/net/JarURLConnection.java
index a2b3434..f0b3b5d 100644
--- a/libjava/java/net/JarURLConnection.java
+++ b/libjava/java/net/JarURLConnection.java
@@ -18,6 +18,7 @@ import java.util.Hashtable;
 
 /**
  * @author Kresten Krab Thorup <krab@gnu.org>
+ * @since 1.2
  * @date Aug 10, 1999.
  */
 
diff --git a/libjava/java/net/MulticastSocket.java b/libjava/java/net/MulticastSocket.java
index 4528de1..7381a86 100644
--- a/libjava/java/net/MulticastSocket.java
+++ b/libjava/java/net/MulticastSocket.java
@@ -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
diff --git a/libjava/java/net/PasswordAuthentication.java b/libjava/java/net/PasswordAuthentication.java
index e6d87a5..0c4faa5 100644
--- a/libjava/java/net/PasswordAuthentication.java
+++ b/libjava/java/net/PasswordAuthentication.java
@@ -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
 {
diff --git a/libjava/java/net/ServerSocket.java b/libjava/java/net/ServerSocket.java
index f383c44..788057d 100644
--- a/libjava/java/net/ServerSocket.java
+++ b/libjava/java/net/ServerSocket.java
@@ -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
   {
diff --git a/libjava/java/net/Socket.java b/libjava/java/net/Socket.java
index aa929b0..6c0df54 100644
--- a/libjava/java/net/Socket.java
+++ b/libjava/java/net/Socket.java
@@ -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
   {
diff --git a/libjava/java/net/URLClassLoader.java b/libjava/java/net/URLClassLoader.java
index eeec882..4fce625 100644
--- a/libjava/java/net/URLClassLoader.java
+++ b/libjava/java/net/URLClassLoader.java
@@ -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
diff --git a/libjava/java/net/URLConnection.java b/libjava/java/net/URLConnection.java
index 6ee41aa..b3bebba 100644
--- a/libjava/java/net/URLConnection.java
+++ b/libjava/java/net/URLConnection.java
@@ -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