classpath-patches
[Top][All Lists]
Advanced

[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.
    *




reply via email to

[Prev in Thread] Current Thread [Next in Thread]