[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[cp-patches] Patch: FYI: more javadoc fixes
From: |
Tom Tromey |
Subject: |
[cp-patches] Patch: FYI: more javadoc fixes |
Date: |
13 Sep 2005 16:08:34 -0600 |
User-agent: |
Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 |
I'm checking this in.
This fixes a bunch more javadoc issues in java.util, java.lang, and
java.io.
Tom
2005-09-13 Tom Tromey <address@hidden>
* java/util/regex/Matcher.java (matches): Javadoc fix.
(start): Likewise.
* java/lang/reflect/Proxy.java (equals): Javadoc fix.
* java/io/ObjectInputStream.java (inputGetObjectStreamClasses): Javadoc
fix.
* java/util/zip/ZipFile.java (getEntry): Javadoc fix.
* java/util/logging/XMLFormatter.java (getHead): Javadoc fix.
* java/util/logging/LogManager.java (getLevelProperty): Javadoc fix.
* java/util/logging/Handler.java (getEncoding): Javadoc fix.
(setFilter): Likewise.
* java/util/logging/FileHandler.java: Organized imports.
* java/util/jar/Manifest.java (Manifest): Javadoc fix.
* java/util/TreeMap.java (putFromObjStream): Javadoc fix.
* java/util/SimpleTimeZone.java (isBefore): Javadoc fix.
* java/util/ResourceBundle.java (tryBundle): Javadoc fix.
* java/util/Random.java (seed): Javadoc fix.
* java/util/Collections.java (SynchronizedSortedSet): Javadoc fix.
(SingletonMap): Likewise.
(addAll): Javadoc fix.
* java/lang/reflect/UndeclaredThrowableException.java: Javadoc fix.
* java/lang/reflect/Member.java (DECLARED, PUBLIC): Javadoc fix.
* java/lang/ref/WeakReference.java: Javadoc fix.
* java/lang/ref/Reference.java: Javadoc fix.
(Reference): Likewise.
* java/lang/Thread.java (setContextClassLoader): Javadoc fix.
(getContextClassLoader): Likewise.
(stop): Likewise.
* java/lang/System.java (runFinalizersOnExit): Javadoc fix.
* java/lang/String.java (upperExpand): Javadoc fix.
* java/lang/StrictMath.java: Javadoc fixes.
* java/lang/SecurityManager.java: Added imports for javadoc.
(currentClassLoader): Javadoc fix.
(classLoaderDepth): Likewise.
(currentLoadedClass): Likewise.
(checkRead): Likewise.
(checkWrite): Likewise.
(checkAccess): Likewise.
* java/lang/RuntimePermission.java: Added import for javadoc.
* java/lang/Readable.java (read): Added import for javadoc.
Index: java/io/ObjectInputStream.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/io/ObjectInputStream.java,v
retrieving revision 1.65
diff -u -r1.65 ObjectInputStream.java
--- java/io/ObjectInputStream.java 13 Sep 2005 21:25:08 -0000 1.65
+++ java/io/ObjectInputStream.java 13 Sep 2005 22:11:13 -0000
@@ -807,7 +807,7 @@
/**
* Reconstruct class hierarchy the same way
- * address@hidden
java.io.ObjectStreamClass.getObjectStreamClasses(java.lang.Class)} does
+ * address@hidden java.io.ObjectStreamClass#getObjectStreamClasses(Class)}
does
* but using lookupClass instead of ObjectStreamClass.lookup. This
* dup is necessary localize the lookup table. Hopefully some future
* rewritings will be able to prevent this.
Index: java/lang/Readable.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/Readable.java,v
retrieving revision 1.3
diff -u -r1.3 Readable.java
--- java/lang/Readable.java 2 Jul 2005 20:32:38 -0000 1.3
+++ java/lang/Readable.java 13 Sep 2005 22:11:13 -0000
@@ -39,6 +39,7 @@
import java.io.IOException;
import java.nio.CharBuffer;
+import java.nio.ReadOnlyBufferException;
/**
* A <code>Readable</code> object is simply a source for Unicode character
Index: java/lang/RuntimePermission.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/RuntimePermission.java,v
retrieving revision 1.9
diff -u -r1.9 RuntimePermission.java
--- java/lang/RuntimePermission.java 2 Jul 2005 20:32:38 -0000 1.9
+++ java/lang/RuntimePermission.java 13 Sep 2005 22:11:13 -0000
@@ -39,6 +39,7 @@
package java.lang;
import java.security.BasicPermission;
+import java.security.Permission;
/**
* A <code>RuntimePermission</code> contains a permission name, but no
Index: java/lang/SecurityManager.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/SecurityManager.java,v
retrieving revision 1.30
diff -u -r1.30 SecurityManager.java
--- java/lang/SecurityManager.java 2 Jul 2005 20:32:38 -0000 1.30
+++ java/lang/SecurityManager.java 13 Sep 2005 22:11:13 -0000
@@ -41,19 +41,35 @@
import gnu.classpath.VMStackWalker;
import java.awt.AWTPermission;
+import java.awt.Frame;
+import java.awt.Toolkit;
+import java.awt.Window;
import java.io.File;
import java.io.FileDescriptor;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
import java.io.FilePermission;
+import java.io.RandomAccessFile;
import java.lang.reflect.Member;
import java.net.InetAddress;
+import java.net.ServerSocket;
+import java.net.Socket;
+import java.net.SocketImplFactory;
import java.net.SocketPermission;
+import java.net.URL;
+import java.net.URLStreamHandlerFactory;
import java.security.AccessControlContext;
+import java.security.AccessControlException;
import java.security.AccessController;
import java.security.AllPermission;
+import java.security.BasicPermission;
import java.security.Permission;
+import java.security.Policy;
import java.security.PrivilegedAction;
+import java.security.ProtectionDomain;
import java.security.Security;
import java.security.SecurityPermission;
+import java.util.Properties;
import java.util.PropertyPermission;
import java.util.StringTokenizer;
@@ -196,7 +212,7 @@
* <ul>
* <li>All methods on the stack are from system classes</li>
* <li>All methods on the stack up to the first "privileged" caller, as
- * created by address@hidden
AccessController.doPrivileged(PrivilegedAction)},
+ * created by address@hidden
AccessController#doPrivileged(PrivilegedAction)},
* are from system classes</li>
* <li>A check of <code>java.security.AllPermission</code> succeeds.</li>
* </ul>
@@ -219,7 +235,7 @@
* <ul>
* <li>All methods on the stack are from system classes</li>
* <li>All methods on the stack up to the first "privileged" caller, as
- * created by address@hidden
AccessController.doPrivileged(PrivilegedAction)},
+ * created by address@hidden
AccessController#doPrivileged(PrivilegedAction)},
* are from system classes</li>
* <li>A check of <code>java.security.AllPermission</code> succeeds.</li>
* </ul>
@@ -258,7 +274,7 @@
* <ul>
* <li>All methods on the stack are from system classes</li>
* <li>All methods on the stack up to the first "privileged" caller, as
- * created by address@hidden
AccessController.doPrivileged(PrivilegedAction)},
+ * created by address@hidden
AccessController#doPrivileged(PrivilegedAction)},
* are from system classes</li>
* <li>A check of <code>java.security.AllPermission</code> succeeds.</li>
* </ul>
@@ -431,7 +447,7 @@
* @throws SecurityException if permission is denied
* @throws NullPointerException if g is null
* @see Thread#Thread()
- * @see ThreadGroup#ThreadGroup()
+ * @see ThreadGroup#ThreadGroup(String)
* @see ThreadGroup#stop()
* @see ThreadGroup#suspend()
* @see ThreadGroup#resume()
@@ -537,7 +553,7 @@
* @throws NullPointerException if filename is null
* @see File
* @see FileInputStream#FileInputStream(String)
- * @see RandomAccessFile#RandomAccessFile(String)
+ * @see RandomAccessFile#RandomAccessFile(String, String)
*/
public void checkRead(String filename)
{
@@ -602,9 +618,9 @@
* @see File
* @see File#canWrite()
* @see File#mkdir()
- * @see File#renameTo()
+ * @see File#renameTo(File)
* @see FileOutputStream#FileOutputStream(String)
- * @see RandomAccessFile#RandomAccessFile(String)
+ * @see RandomAccessFile#RandomAccessFile(String, String)
*/
public void checkWrite(String filename)
{
Index: java/lang/StrictMath.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/StrictMath.java,v
retrieving revision 1.5
diff -u -r1.5 StrictMath.java
--- java/lang/StrictMath.java 2 Jul 2005 20:32:39 -0000 1.5
+++ java/lang/StrictMath.java 13 Sep 2005 22:11:14 -0000
@@ -1254,7 +1254,7 @@
/**
* Super precision for 2/pi in 24-bit chunks, for use in
- * address@hidden #remPiOver2()}.
+ * address@hidden #remPiOver2(double, double[])}.
*/
private static final int TWO_OVER_PI[] = {
0xa2f983, 0x6e4e44, 0x1529fc, 0x2757d1, 0xf534dd, 0xc0db62,
@@ -1272,7 +1272,7 @@
/**
* Super precision for pi/2 in 24-bit chunks, for use in
- * address@hidden #remPiOver2()}.
+ * address@hidden #remPiOver2(double, double[])}.
*/
private static final double PI_OVER_TWO[] = {
1.570796251296997, // Long bits 0x3ff921fb40000000L.
@@ -1286,8 +1286,8 @@
};
/**
- * More constants related to pi, used in address@hidden #remPiOver2()} and
- * elsewhere.
+ * More constants related to pi, used in
+ * address@hidden #remPiOver2(double, double[])} and elsewhere.
*/
private static final double
PI_L = 1.2246467991473532e-16, // Long bits 0x3ca1a62633145c07L.
@@ -1301,7 +1301,7 @@
/**
* Natural log and square root constants, for calculation of
* address@hidden #exp(double)}, address@hidden #log(double)} and
- * address@hidden #power(double, double)}. CP is 2/(3*ln(2)).
+ * address@hidden #pow(double, double)}. CP is 2/(3*ln(2)).
*/
private static final double
SQRT_1_5 = 1.224744871391589, // Long bits 0x3ff3988e1409212eL.
Index: java/lang/String.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/String.java,v
retrieving revision 1.69
diff -u -r1.69 String.java
--- java/lang/String.java 13 Sep 2005 21:25:11 -0000 1.69
+++ java/lang/String.java 13 Sep 2005 22:11:14 -0000
@@ -98,7 +98,7 @@
/**
* Stores unicode multi-character uppercase expansion table.
- * @see #toUpperCase(char)
+ * @see #toUpperCase(Locale)
* @see CharData#UPPER_EXPAND
*/
private static final char[] upperExpand
Index: java/lang/System.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/System.java,v
retrieving revision 1.52
diff -u -r1.52 System.java
--- java/lang/System.java 2 Jul 2005 20:32:39 -0000 1.52
+++ java/lang/System.java 13 Sep 2005 22:11:15 -0000
@@ -464,7 +464,7 @@
*
* @param finalizeOnExit whether to run finalizers on exit
* @throws SecurityException if permission is denied
- * @see Runtime#runFinalizersOnExit()
+ * @see Runtime#runFinalizersOnExit(boolean)
* @since 1.1
* @deprecated never rely on finalizers to do a clean, thread-safe,
* mop-up from your code
Index: java/lang/Thread.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/Thread.java,v
retrieving revision 1.14
diff -u -r1.14 Thread.java
--- java/lang/Thread.java 2 Jul 2005 20:32:39 -0000 1.14
+++ java/lang/Thread.java 13 Sep 2005 22:11:16 -0000
@@ -38,6 +38,7 @@
package java.lang;
+import java.security.Permission;
import java.util.Map;
import java.util.WeakHashMap;
@@ -704,7 +705,7 @@
*
* @return the context class loader
* @throws SecurityException when permission is denied
- * @see setContextClassLoader(ClassLoader)
+ * @see #setContextClassLoader(ClassLoader)
* @since 1.2
*/
public synchronized ClassLoader getContextClassLoader()
@@ -726,7 +727,7 @@
*
* @param classloader the new context class loader
* @throws SecurityException when permission is denied
- * @see getContextClassLoader()
+ * @see #getContextClassLoader()
* @since 1.2
*/
public synchronized void setContextClassLoader(ClassLoader classloader)
Index: java/lang/ref/Reference.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/ref/Reference.java,v
retrieving revision 1.7
diff -u -r1.7 Reference.java
--- java/lang/ref/Reference.java 2 Jul 2005 20:32:39 -0000 1.7
+++ java/lang/ref/Reference.java 13 Sep 2005 22:11:16 -0000
@@ -68,7 +68,7 @@
* work. It is useful to keep track, when an object is finalized.
*
* @author Jochen Hoenicke
- * @see java.util.WeakHashtable
+ * @see java.util.WeakHashMap
*/
public abstract class Reference
{
@@ -104,7 +104,7 @@
* Creates a new reference that is not registered to any queue.
* Since it is package private, it is not possible to overload this
* class in a different package.
- * @param referent the object we refer to.
+ * @param ref the object we refer to.
*/
Reference(Object ref)
{
@@ -115,7 +115,7 @@
* Creates a reference that is registered to a queue. Since this is
* package private, it is not possible to overload this class in a
* different package.
- * @param referent the object we refer to.
+ * @param ref the object we refer to.
* @param q the reference queue to register on.
* @exception NullPointerException if q is null.
*/
Index: java/lang/ref/WeakReference.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/ref/WeakReference.java,v
retrieving revision 1.4
diff -u -r1.4 WeakReference.java
--- java/lang/ref/WeakReference.java 2 Jul 2005 20:32:39 -0000 1.4
+++ java/lang/ref/WeakReference.java 13 Sep 2005 22:11:16 -0000
@@ -52,7 +52,7 @@
* automatically cleared, and you may remove it from the set. <br>
*
* @author Jochen Hoenicke
- * @see java.util.WeakHashtable
+ * @see java.util.WeakHashMap
*/
public class WeakReference
extends Reference
Index: java/lang/reflect/Member.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/reflect/Member.java,v
retrieving revision 1.8
diff -u -r1.8 Member.java
--- java/lang/reflect/Member.java 2 Jul 2005 20:32:39 -0000 1.8
+++ java/lang/reflect/Member.java 13 Sep 2005 22:11:16 -0000
@@ -60,7 +60,7 @@
* package-protected, but only which are declared in this class.
* Used in SecurityManager.checkMemberAccess() to determine the
* type of members to access.
- * @see SecurityManager#checkMemberAccess()
+ * @see SecurityManager#checkMemberAccess(Class, int)
*/
int DECLARED = 1;
@@ -68,7 +68,7 @@
* Represents public members only, but includes all inherited members.
* Used in SecurityManager.checkMemberAccess() to determine the type of
* members to access.
- * @see SecurityManager#checkMemberAccess()
+ * @see SecurityManager#checkMemberAccess(Class, int)
*/
int PUBLIC = 0;
Index: java/lang/reflect/Proxy.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/reflect/Proxy.java,v
retrieving revision 1.22
diff -u -r1.22 Proxy.java
--- java/lang/reflect/Proxy.java 9 Sep 2005 12:14:08 -0000 1.22
+++ java/lang/reflect/Proxy.java 13 Sep 2005 22:11:16 -0000
@@ -100,7 +100,7 @@
* belongs to the classloader you designated.</li>
* <li>Reflection works as expected: address@hidden Class#getInterfaces()} and
* address@hidden Class#getMethods()} work as they do on normal
classes.</li>
- * <li>The method address@hidden #isProxyClass()} will distinguish between
+ * <li>The method address@hidden #isProxyClass(Class)} will distinguish
between
* true proxy classes and user extensions of this class. It only
* returns true for classes created by address@hidden
#getProxyClass}.</li>
* <li>The address@hidden ProtectionDomain} of a proxy class is the same as
for
@@ -126,7 +126,7 @@
* a address@hidden ClassCastException}.</li>
* <li>Each proxy instance has an invocation handler, which can be
* accessed by address@hidden #getInvocationHandler(Object)}. Any call
- * to an interface method, including address@hidden Object#hashcode()},
+ * to an interface method, including address@hidden Object#hashCode()},
* address@hidden Object#equals(Object)}, or address@hidden
Object#toString()},
* but excluding the public final methods of Object, will be
* encoded and passed to the address@hidden InvocationHandler#invoke}
@@ -436,7 +436,7 @@
/**
* Calculates equality.
*
- * @param the object to compare to
+ * @param other object to compare to
* @return true if it is a ProxyType with same data
*/
public boolean equals(Object other)
@@ -586,7 +586,7 @@
/**
* Calculates equality.
*
- * @param the object to compare to
+ * @param other object to compare to
* @return true if it is a ProxySignature with same data
*/
public boolean equals(Object other)
Index: java/lang/reflect/UndeclaredThrowableException.java
===================================================================
RCS file:
/cvsroot/classpath/classpath/java/lang/reflect/UndeclaredThrowableException.java,v
retrieving revision 1.5
diff -u -r1.5 UndeclaredThrowableException.java
--- java/lang/reflect/UndeclaredThrowableException.java 2 Jul 2005 20:32:39
-0000 1.5
+++ java/lang/reflect/UndeclaredThrowableException.java 13 Sep 2005 22:11:16
-0000
@@ -65,7 +65,7 @@
/**
* The immutable exception that this wraps. This field is redundant
- * with address@hidden Throwable#cause}, but is necessary for serial
compatibility.
+ * with address@hidden Throwable#getCause()}, but is necessary for serial
compatibility.
*
* @serial the chained exception
*/
Index: java/util/Collections.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/Collections.java,v
retrieving revision 1.37
diff -u -r1.37 Collections.java
--- java/util/Collections.java 5 Jul 2005 10:28:03 -0000 1.37
+++ java/util/Collections.java 13 Sep 2005 22:11:17 -0000
@@ -1731,8 +1731,8 @@
}
/**
- * The implementation of address@hidden #singletonMap(Object)}. This class
name
- * is required for compatibility with Sun's JDK serializability.
+ * The implementation of address@hidden #singletonMap(Object, Object)}. This
class
+ * name is required for compatibility with Sun's JDK serializability.
*
* @author Eric Blake (address@hidden)
*/
@@ -2518,12 +2518,13 @@
}
/**
- * Add an element to the end of the underlying list (optional operation).
- * If the list imposes restraints on what can be inserted, such as no null
- * elements, this should be documented. A lock is obtained on the mutex
before
- * any of the elements are added.
+ * Add the contents of a collection to the underlying list at the given
+ * index (optional operation). If the list imposes restraints on what
+ * can be inserted, such as no null elements, this should be documented.
+ * A lock is obtained on the mutex before any of the elements are added.
*
- * @param o the object to add
+ * @param index the index at which to insert
+ * @param c the collection to add
* @return <code>true</code>, as defined by Collection for a modified list
* @throws UnsupportedOperationException if this list does not support the
* add operation
@@ -3858,7 +3859,7 @@
/**
* Called only by trusted code to specify the mutex as well as the set.
* @param sync the mutex
- * @param l the list
+ * @param ss the set
*/
SynchronizedSortedSet(Object sync, SortedSet ss)
{
Index: java/util/Random.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/Random.java,v
retrieving revision 1.14
diff -u -r1.14 Random.java
--- java/util/Random.java 2 Jul 2005 20:32:42 -0000 1.14
+++ java/util/Random.java 13 Sep 2005 22:11:18 -0000
@@ -102,7 +102,7 @@
* in next.
*
* @serial the internal state of this generator
- * @see #next()
+ * @see #next(int)
*/
private long seed;
Index: java/util/ResourceBundle.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/ResourceBundle.java,v
retrieving revision 1.34
diff -u -r1.34 ResourceBundle.java
--- java/util/ResourceBundle.java 5 Jul 2005 10:28:03 -0000 1.34
+++ java/util/ResourceBundle.java 13 Sep 2005 22:11:18 -0000
@@ -508,8 +508,7 @@
*
* @param baseName the raw bundle name, without locale qualifiers
* @param locale the locale
- * @param classloader the classloader
- * @param bundle the backup (parent) bundle
+ * @param classLoader the classloader
* @param wantBase whether a resource bundle made only from the base name
* (with no locale information attached) should be returned.
* @return the resource bundle if it was loaded, otherwise the backup
Index: java/util/SimpleTimeZone.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/SimpleTimeZone.java,v
retrieving revision 1.27
diff -u -r1.27 SimpleTimeZone.java
--- java/util/SimpleTimeZone.java 5 Jul 2005 10:28:03 -0000 1.27
+++ java/util/SimpleTimeZone.java 13 Sep 2005 22:11:18 -0000
@@ -796,7 +796,7 @@
* dst and standard time.
* @param calYear the year of the date to check (for leap day checking).
* @param calMonth the month of the date to check.
- * @param calDay the day of month of the date to check.
+ * @param calDayOfMonth the day of month of the date to check.
* @param calDayOfWeek the day of week of the date to check.
* @param calMillis the millis of day of the date to check (standard time).
* @param mode the change mode; same semantic as startMode.
Index: java/util/TreeMap.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/TreeMap.java,v
retrieving revision 1.28
diff -u -r1.28 TreeMap.java
--- java/util/TreeMap.java 5 Jul 2005 10:28:04 -0000 1.28
+++ java/util/TreeMap.java 13 Sep 2005 22:11:18 -0000
@@ -1146,7 +1146,7 @@
*
* @param s the stream to read from
* @param count the number of keys to read
- * @param readValue true to read values, false to insert "" as the value
+ * @param readValues true to read values, false to insert "" as the value
* @throws ClassNotFoundException if the underlying stream fails
* @throws IOException if the underlying stream fails
* @see #readObject(ObjectInputStream)
Index: java/util/jar/Manifest.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/jar/Manifest.java,v
retrieving revision 1.9
diff -u -r1.9 Manifest.java
--- java/util/jar/Manifest.java 2 Jul 2005 20:32:44 -0000 1.9
+++ java/util/jar/Manifest.java 13 Sep 2005 22:11:19 -0000
@@ -80,10 +80,10 @@
/**
* Creates a Manifest from the supplied input stream.
*
- * @see read(Inputstream)
- * @see write(OutputStream)
+ * @see #read(InputStream)
+ * @see #write(OutputStream)
*
- * @param InputStream the input stream to read the manifest from
+ * @param in the input stream to read the manifest from
* @exception IOException when an i/o exception occurs or the input stream
* does not describe a valid manifest
*/
@@ -102,7 +102,7 @@
* a particular entry also changes the attributes of that entry in the
* original manifest.
*
- * @see clone()
+ * @see #clone()
* @param man the Manifest to copy from
*/
public Manifest(Manifest man)
Index: java/util/logging/FileHandler.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/logging/FileHandler.java,v
retrieving revision 1.9
diff -u -r1.9 FileHandler.java
--- java/util/logging/FileHandler.java 13 Jul 2005 23:22:31 -0000 1.9
+++ java/util/logging/FileHandler.java 13 Sep 2005 22:11:19 -0000
@@ -43,10 +43,6 @@
import java.io.FilterOutputStream;
import java.io.IOException;
import java.io.OutputStream;
-
-import java.nio.channels.FileChannel;
-import java.nio.channels.FileLock;
-
import java.util.LinkedList;
import java.util.ListIterator;
Index: java/util/logging/Handler.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/logging/Handler.java,v
retrieving revision 1.8
diff -u -r1.8 Handler.java
--- java/util/logging/Handler.java 2 Jul 2005 20:32:44 -0000 1.8
+++ java/util/logging/Handler.java 13 Sep 2005 22:11:19 -0000
@@ -191,8 +191,8 @@
* Returns the character encoding which this handler uses for publishing
* log records.
*
- * @param encoding the name of a character encoding, or <code>null</code>
- * for the default platform encoding.
+ * @return the name of a character encoding, or <code>null</code>
+ * for the default platform encoding.
*/
public String getEncoding()
{
@@ -252,7 +252,7 @@
* Sets the <code>Filter</code> for controlling which
* log records will be published by this <code>Handler</code>.
*
- * @return the <code>Filter</code> to use, or
+ * @param filter the <code>Filter</code> to use, or
* <code>null</code> to filter log records purely based
* on their severity level.
*/
Index: java/util/logging/LogManager.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/logging/LogManager.java,v
retrieving revision 1.15
diff -u -r1.15 LogManager.java
--- java/util/logging/LogManager.java 14 Jul 2005 13:16:58 -0000 1.15
+++ java/util/logging/LogManager.java 13 Sep 2005 22:11:19 -0000
@@ -682,7 +682,7 @@
*
* @param defaultValue the value that will be returned if the
* property is not defined, or if
- * address@hidden Level.parse(java.lang.String)} does not like
+ * address@hidden Level#parse(java.lang.String)} does not like
* the property value.
*/
static Level getLevelProperty(String propertyName, Level defaultValue)
Index: java/util/logging/XMLFormatter.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/logging/XMLFormatter.java,v
retrieving revision 1.8
diff -u -r1.8 XMLFormatter.java
--- java/util/logging/XMLFormatter.java 2 Jul 2005 20:32:44 -0000 1.8
+++ java/util/logging/XMLFormatter.java 13 Sep 2005 22:11:19 -0000
@@ -307,7 +307,7 @@
*
* @return a string for the header.
*
- * @param handler the handler which will prepend the returned
+ * @param h the handler which will prepend the returned
* string in front of the first log record. This method
* will inspect certain properties of the handler, for
* example its encoding, in order to construct the header.
Index: java/util/regex/Matcher.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/regex/Matcher.java,v
retrieving revision 1.9
diff -u -r1.9 Matcher.java
--- java/util/regex/Matcher.java 2 Jul 2005 20:32:44 -0000 1.9
+++ java/util/regex/Matcher.java 13 Sep 2005 22:11:19 -0000
@@ -227,9 +227,9 @@
* If the match succeeds then more information can be obtained via the
* start, end, and group methods.
*
- * @see #start
- * @see #end
- * @see #group
+ * @see #start()
+ * @see #end()
+ * @see #group()
*/
public boolean matches ()
{
@@ -267,7 +267,7 @@
}
/**
- * @param group The index of a capturing group in this matcher's pattern
+ * @returns the index of a capturing group in this matcher's pattern
*
* @exception IllegalStateException If no match has yet been attempted,
* or if the previous match operation failed
Index: java/util/zip/ZipFile.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/zip/ZipFile.java,v
retrieving revision 1.25
diff -u -r1.25 ZipFile.java
--- java/util/zip/ZipFile.java 13 Sep 2005 21:25:10 -0000 1.25
+++ java/util/zip/ZipFile.java 13 Sep 2005 22:11:19 -0000
@@ -395,7 +395,7 @@
/**
* Searches for a zip entry in this archive with the given name.
*
- * @param the name. May contain directory components separated by
+ * @param name the name. May contain directory components separated by
* slashes ('/').
* @return the zip entry, or null if no entry with that name exists.
*
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [cp-patches] Patch: FYI: more javadoc fixes,
Tom Tromey <=