This is the mail archive of the
java-patches@gcc.gnu.org
mailing list for the Java project.
FYI: Patch: java.net documentation merges from classpath.
- From: Michael Koch <konqueror at gmx dot de>
- To: java-patches at gcc dot gnu dot org
- Date: Mon, 26 May 2003 15:00:34 +0200
- Subject: FYI: Patch: java.net documentation merges from classpath.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Hi list,
I commited the attached patch to trunk to merge some new documentation
fixes in classpath into libgcj.
Michael
- --
Homepage: http://www.worldforge.org/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (GNU/Linux)
iD8DBQE+0g/1WSOgCCdjSDsRAqrVAJ4pj8ZIsfxF8Uo1GZfDWd7mEpTZpgCgjKqd
2kA/xGkHrsjMhIggNAZPDv8=
=uHk0
-----END PGP SIGNATURE-----
Index: ChangeLog
===================================================================
RCS file: /cvs/gcc/gcc/libjava/ChangeLog,v
retrieving revision 1.1906
diff -u -b -B -r1.1906 ChangeLog
--- ChangeLog 25 May 2003 11:40:18 -0000 1.1906
+++ ChangeLog 26 May 2003 12:55:55 -0000
@@ -1,3 +1,11 @@
+2003-05-26 Michael Koch <konqueror@gmx.de>
+
+ * java/net/NetPermission.java,
+ java/net/NetworkInterface.java,
+ java/net/PasswordAuthentication.java,
+ java/net/SocketPermission.java:
+ New versions from classpath.
+
2003-05-25 Michael Koch <konqueror@gmx.de>
* java/io/PushbackInputStream.java,
Index: java/net/NetPermission.java
===================================================================
RCS file: /cvs/gcc/gcc/libjava/java/net/NetPermission.java,v
retrieving revision 1.6
diff -u -b -B -r1.6 NetPermission.java
--- java/net/NetPermission.java 2 Mar 2003 21:25:59 -0000 1.6
+++ java/net/NetPermission.java 26 May 2003 12:55:55 -0000
@@ -41,9 +41,21 @@
/**
* This class is used to model miscellaneous network permissions. It is
- * a subclass of BasicPermission. This means that it models a "boolean"
- * permission. One that you either have or do not have. Thus there is
- * no permitted action list associated with this object.
+ * a subclass of <code>BasicPermission</code>. This means that it models a
+ * "boolean" permission. One that you either have or do not have. Thus
+ * there is no permitted action list associated with this object.
+ *
+ * The following permission names are defined for this class:
+ *
+ * <ul>
+ * <li>setDefaultAuthenticator - Grants the ability to install a facility
+ * to collect username and password information when requested by a
+ * web site or proxy server.
+ * <li>requestPasswordAuthentication - Grants the ability to ask the
+ * authentication facility for the user's password.
+ * <li>specifyStreamHandler - Grants the permission to specify the
+ * stream handler class used when loading from a URL.
+ * </ul>
*
* @author Aaron M. Renn (arenn@urbanophile.com)
*/
Index: java/net/NetworkInterface.java
===================================================================
RCS file: /cvs/gcc/gcc/libjava/java/net/NetworkInterface.java,v
retrieving revision 1.6
diff -u -b -B -r1.6 NetworkInterface.java
--- java/net/NetworkInterface.java 5 May 2003 20:18:31 -0000 1.6
+++ java/net/NetworkInterface.java 26 May 2003 12:55:55 -0000
@@ -41,6 +41,12 @@
import java.util.Vector;
/**
+ * This class models a network interface on the host computer. A network
+ * interface contains a name (typically associated with a specific
+ * hardware adapter) and a list of addresses that are bound to it.
+ * For example, an ethernet interface may be named "eth0" and have the
+ * address 192.168.1.101 assigned to it.
+ *
* @author Michael Koch <konqueror@gmx.de>
* @since 1.4
*/
@@ -62,6 +68,8 @@
/**
* Returns the name of the network interface
+ *
+ * @return The name of the interface.
*/
public String getName ()
{
@@ -73,8 +81,8 @@
*
* If a @see SecurityManager is available all addresses are checked
* with @see SecurityManager::checkConnect() if they are available.
- * Only InetAddresses are returned where the security manager doesn't
- * thrown an exception.
+ * Only <code>InetAddresses</code> are returned where the security manager
+ * doesn't throw an exception.
*
* @return An enumeration of all addresses.
*/
@@ -106,6 +114,8 @@
/**
* Returns the display name of the interface
+ *
+ * @return The display name of the interface
*/
public String getDisplayName ()
{
@@ -168,7 +178,7 @@
}
/**
- * Return an Enumeration of all available network interfaces
+ * Return an <code>Enumeration</code> of all available network interfaces
*
* @exception SocketException If an error occurs
*/
Index: java/net/PasswordAuthentication.java
===================================================================
RCS file: /cvs/gcc/gcc/libjava/java/net/PasswordAuthentication.java,v
retrieving revision 1.3
diff -u -b -B -r1.3 PasswordAuthentication.java
--- java/net/PasswordAuthentication.java 27 Aug 2002 17:47:27 -0000 1.3
+++ java/net/PasswordAuthentication.java 26 May 2003 12:55:55 -0000
@@ -1,5 +1,5 @@
/* PasswordAuthentication.java -- Container class for username/password pairs
- Copyright (C) 1998,2000 Free Software Foundation, Inc.
+ Copyright (C) 1998, 2000, 2003 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@@ -45,72 +45,64 @@
*/
public final class PasswordAuthentication
{
-
-/*************************************************************************/
-
-/*
+ /*
* Instance Variables
*/
-/**
+ /**
* The username
*/
-private String username;
+ private String username;
-/**
+ /**
* The password
*/
-private char[] password;
+ private char[] password;
-/*************************************************************************/
+ /*************************************************************************/
-/*
+ /*
* Constructors
*/
-/**
- * Creates a new PasswordAuthentication object from the specified username
- * and password.
+ /**
+ * Creates a new <code>PasswordAuthentication</code> object from the
+ * specified username and password.
*
* @param username The username for this object
* @param password The password for this object
*/
-public
-PasswordAuthentication(String username, char[] password)
-{
+ public PasswordAuthentication(String username, char[] password)
+ {
this.username = username;
this.password = password;
-}
+ }
-/*************************************************************************/
+ /*************************************************************************/
-/*
+ /*
* Instance Methods
*/
-/**
+ /**
* Returns the username associated with this object
*
* @return The username
*/
-public String
-getUserName()
-{
+ public String getUserName()
+ {
return(username);
-}
-
-/*************************************************************************/
+ }
-/**
+ /**
* Returns the password associated with this object
*
* @return The password
*/
-public char[]
-getPassword()
-{
+ public char[] getPassword()
+ {
return(password);
-}
+ }
} // class PasswordAuthentication
Index: java/net/SocketPermission.java
===================================================================
RCS file: /cvs/gcc/gcc/libjava/java/net/SocketPermission.java,v
retrieving revision 1.8
diff -u -b -B -r1.8 SocketPermission.java
--- java/net/SocketPermission.java 13 Feb 2003 07:33:40 -0000 1.8
+++ java/net/SocketPermission.java 26 May 2003 12:55:55 -0000
@@ -96,6 +96,9 @@
* Can accept connections from 197.197.20.1
* </pre><p>
*
+ * This class also supports IPv6 addresses. These should be specified
+ * in either RFC 2732 format or in full uncompressed form.
+ *
* @since 1.2
*
* @author Aaron M. Renn (arenn@urbanophile.com)
@@ -159,7 +162,7 @@
/**
* Returns a hash code value for this object. Overrides the
- * Permission.hashCode()
+ * <code>Permission.hashCode()</code>.
*
* @return A hash code
*/
@@ -233,7 +236,7 @@
* Returns true if the permission object passed it is implied by the
* this permission. This will be true if
* <p><ul>
- * <li>The argument is of type SocketPermission
+ * <li>The argument is of type <code>SocketPermission</code>
* <li>The actions list of the argument are in this object's actions
* <li>The port range of the argument is within this objects port range
* <li>The hostname is equal to or a subset of this objects hostname
@@ -247,7 +250,7 @@
* wildcards
* </ul>
*
- * @param perm The Permission to check against
+ * @param perm The <code>Permission</code> to check against
*
* @return <code>true</code> if the <code>Permission</code> is implied by
* this object, <code>false</code> otherwise.