diff --git a/libjava/ChangeLog b/libjava/ChangeLog index 5724512702e95c2de1f641c12eb7090ae910030f..f4001489d427e7e4c38cbdeccc1bb4562a564105 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 3d11c4a4b04e25ae762a1a8499a6776f49bb99d7..cfc36b312f6eb6f3dfc02e2221501f513897ca95 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 a2482f9237f5350c539c222cebc76dd9f3799a36..2140f454f435ad8cafd1a5146763d92a2bfecc5d 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 064e8e78983a3662869b0942875da1c42eecc8d6..7fc21ff73f4d1ffd47cc61c6cfa4f453a9c58f0b 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 e929e5006ffce3e4f5fa1a217cf1814bb6a103d1..260088dfe058ee8efd4261fdf1e37a7d40f033ec 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 e29c81265fa0aafad6331ee4e751ec9389686551..538dbe8e19a80a2d78d1abd0c8fdf9da2fc29e62 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 84e9468dfc29ae0439675b44acdeba31b6441255..c106ed26fc246ff305299e5cddcf5cd76058b956 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 c542b8002254fb7041d61a0a1e662abb305a8faf..6db6baff9dd0c08494908f5e6c700ccd681080a6 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 a2b3434352dfe07d1168d591cc260c9502437df9..f0b3b5df34390336b7e608116f5ed9e6d4501bea 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 4528de1ebed96e44c7f038836b999f0c914ac428..7381a866d557906790da30c0e32931a1117a23ef 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 e6d87a5431c4517db6d8d09011fa48633769c811..0c4faa543986a58d70de954bcd3b375a602c5eb9 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 f383c448e9464a7ebee1d34a6b6f2bd7250525cd..788057d13848612ec91df6b5e863d3103d561cfb 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 aa929b0b68307fb2368c9d0ef870f789ce862ede..6c0df5402b4ff3bb39999b14eaa5cf9e8c53470b 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 eeec8821316836193bc1646b341f9e92fb2fa602..4fce6250e4afae8f2afdf2309ec002ee2bfe63e3 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 6ee41aa57761bbca803161a39bce52adefb9f5ea..b3bebba00f20ded4ce2f2031f6be941a39968ff1 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