From 49c3c980cae97f2a0727bf4233f4d565ba8d108f Mon Sep 17 00:00:00 2001 From: Michael Koch Date: Tue, 27 Aug 2002 17:47:27 +0000 Subject: BindException.java, [...]: add/update of some @since/@deprecated 2002-08-27 Michael Koch * 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 --- libjava/ChangeLog | 17 +++++++++++++++++ libjava/java/net/BindException.java | 1 + libjava/java/net/DatagramPacket.java | 16 ++++++++++++---- libjava/java/net/DatagramSocket.java | 6 ++++++ libjava/java/net/DatagramSocketImpl.java | 1 + libjava/java/net/FileNameMap.java | 1 + libjava/java/net/HttpURLConnection.java | 1 + libjava/java/net/InetSocketAddress.java | 2 ++ libjava/java/net/JarURLConnection.java | 1 + libjava/java/net/MulticastSocket.java | 1 + libjava/java/net/PasswordAuthentication.java | 1 + libjava/java/net/ServerSocket.java | 8 ++++++++ libjava/java/net/Socket.java | 8 ++++---- libjava/java/net/URLClassLoader.java | 3 +++ libjava/java/net/URLConnection.java | 11 +++++++++-- 15 files changed, 68 insertions(+), 10 deletions(-) (limited to 'libjava') 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 + + * 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 Tom Tromey 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 * @author Warren Levy + * @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 + * @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 + * @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 + * @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 + * @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 * @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 -- cgit v1.1