harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From telli...@apache.org
Subject svn commit: r628032 - in /harmony/enhanced/classlib/trunk/modules: luni-kernel/src/main/java/java/lang/ luni/src/main/java/java/util/ security-kernel/src/main/java/java/security/
Date Fri, 15 Feb 2008 12:04:11 GMT
Author: tellison
Date: Fri Feb 15 04:04:10 2008
New Revision: 628032

URL: http://svn.apache.org/viewvc?rev=628032&view=rev
Log:
Fixing and formatting JavaDoc comments -- no functional changes.

Modified:
    harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java
    harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java
    harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java
    harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java
    harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java

Modified: harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/Class.java Fri Feb 15 04:04:10 2008
@@ -75,12 +75,14 @@
  * 
  * @since 1.0
  */
-public final class Class<T> implements Serializable, AnnotatedElement, GenericDeclaration, Type {
+public final class Class<T> implements Serializable, AnnotatedElement,
+        GenericDeclaration, Type {
 
     private static final long serialVersionUID = 3206093459760846163L;
-    
-    private Class(){
-        //prevent this class to be instantiated, instance should be created by JVM only
+
+    private Class() {
+        // prevent this class to be instantiated, instance should be created by
+        // JVM only
     }
 
     /**
@@ -110,8 +112,10 @@
      * the caller of this method.</li>
      * </ul>
      * 
-     * @param maxDepth maximum depth to walk the stack, -1 for the entire stack
-     * @param stopAtPrivileged stop at privileged classes
+     * @param maxDepth
+     *            maximum depth to walk the stack, -1 for the entire stack
+     * @param stopAtPrivileged
+     *            stop at privileged classes
      * @return the array of the most recent classes on the stack
      */
     static final Class[] getStackClasses(int maxDepth, boolean stopAtPrivileged) {
@@ -120,32 +124,37 @@
 
     /**
      * Answers a Class object which represents the class named by the argument.
+     * 
      * The name should be the name of a class as described in the class
-     * definition of {@link Class}, however Classes representing base types can
-     * not be found using this method.
+     * definition of <code>Class</code>, however Classes representing base
+     * types can not be found using this method.
      * 
-     * @param className The name of the non-base type class to find
+     * @param className
+     *            The name of the non-base type class to find
      * @return the named Class
-     * @throws ClassNotFoundException If the class could not be found
-     * @see {@link Class}
+     * @throws ClassNotFoundException
+     *             If the class could not be found
      */
-    public static Class<?> forName(String className) throws ClassNotFoundException {
+    public static Class<?> forName(String className)
+            throws ClassNotFoundException {
         return null;
     }
 
     /**
      * Answers a Class object which represents the class named by the argument.
      * The name should be the name of a class as described in the class
-     * definition of {@link Class}, however Classes representing base types can
-     * not be found using this method. Security rules will be obeyed.
+     * definition of <code>Class</code>, however Classes representing base
+     * types can not be found using this method. Security rules will be obeyed.
      * 
-     * @param className The name of the non-base type class to find
-     * @param initializeBoolean A boolean indicating whether the class should be
-     *        initialized
-     * @param classLoader The class loader to use to load the class
+     * @param className
+     *            The name of the non-base type class to find
+     * @param initializeBoolean
+     *            A boolean indicating whether the class should be initialized
+     * @param classLoader
+     *            The class loader to use to load the class
      * @return the named class.
-     * @throws ClassNotFoundException If the class could not be found
-     * @see {@link Class}
+     * @throws ClassNotFoundException
+     *             If the class could not be found
      */
     public static Class<?> forName(String className, boolean initializeBoolean,
             ClassLoader classLoader) throws ClassNotFoundException {
@@ -157,8 +166,8 @@
      * the receiver represents and its super classes and interfaces
      * 
      * @return the class' public class members
-     * @throws SecurityException If member access is not allowed
-     * @see {@link Class}
+     * @throws SecurityException
+     *             If member access is not allowed
      */
     public Class[] getClasses() {
         return null;
@@ -167,7 +176,8 @@
     /**
      * Verify the specified Class using the VM byte code verifier.
      * 
-     * @throws VerifyError if the Class cannot be verified
+     * @throws VerifyError
+     *             if the Class cannot be verified
      */
     void verify() {
         return;
@@ -177,7 +187,8 @@
      * Answers the annotation of the given type. If there is no annotation the
      * method returns <code>null</code>.
      * 
-     * @param annotationClass the annotation type.
+     * @param annotationClass
+     *            the annotation type.
      * @return the annotation of the given type, or <code>null</code> if none.
      * @since 1.5
      */
@@ -211,8 +222,7 @@
      * the receiver. Answer null if the class was loaded by the system class
      * loader
      * 
-     * @return the receiver's class loader or nil
-     * @see {@link ClassLoader}
+     * @return the receiver's class loader or null
      */
     public ClassLoader getClassLoader() {
         return null;
@@ -236,11 +246,10 @@
 
     /**
      * Answers a Class object which represents the receiver's component type if
-     * the receiver represents an array type. Otherwise answers nil. The
+     * the receiver represents an array type. Otherwise answers null. The
      * component type of an array type is the type of the elements of the array.
      * 
      * @return the component type of the receiver.
-     * @see {@link Class}
      */
     public Class<?> getComponentType() {
         return null;
@@ -250,14 +259,17 @@
      * Answers a public Constructor object which represents the constructor
      * described by the arguments.
      * 
-     * @param parameterTypes the types of the arguments.
+     * @param parameterTypes
+     *            the types of the arguments.
      * @return the constructor described by the arguments.
-     * @throws NoSuchMethodException if the constructor could not be found.
-     * @throws SecurityException if member access is not allowed
+     * @throws NoSuchMethodException
+     *             if the constructor could not be found.
+     * @throws SecurityException
+     *             if member access is not allowed
      * @see #getConstructors
      */
-    public Constructor<T> getConstructor(Class... parameterTypes) throws NoSuchMethodException,
-            SecurityException {
+    public Constructor<T> getConstructor(Class... parameterTypes)
+            throws NoSuchMethodException, SecurityException {
         return null;
     }
 
@@ -266,7 +278,8 @@
      * constructors which are visible from the current execution context.
      * 
      * @return all visible constructors starting from the receiver.
-     * @throws SecurityException if member access is not allowed
+     * @throws SecurityException
+     *             if member access is not allowed
      * @see #getMethods
      */
     public Constructor[] getConstructors() throws SecurityException {
@@ -292,8 +305,8 @@
      * not be visible in the current execution context.
      * 
      * @return the class' class members
-     * @throws SecurityException if member access is not allowed
-     * @see {@link Class}
+     * @throws SecurityException
+     *             if member access is not allowed
      */
     public Class[] getDeclaredClasses() throws SecurityException {
         return new Class[0];
@@ -303,10 +316,13 @@
      * Answers a Constructor object which represents the constructor described
      * by the arguments.
      * 
-     * @param parameterTypes the types of the arguments.
+     * @param parameterTypes
+     *            the types of the arguments.
      * @return the constructor described by the arguments.
-     * @throws NoSuchMethodException if the constructor could not be found.
-     * @throws SecurityException if member access is not allowed
+     * @throws NoSuchMethodException
+     *             if the constructor could not be found.
+     * @throws SecurityException
+     *             if member access is not allowed
      * @see #getConstructors
      */
     public Constructor<T> getDeclaredConstructor(Class... parameterTypes)
@@ -321,7 +337,8 @@
      * context.
      * 
      * @return the receiver's constructors.
-     * @throws SecurityException if member access is not allowed
+     * @throws SecurityException
+     *             if member access is not allowed
      * @see #getMethods
      */
     public Constructor[] getDeclaredConstructors() throws SecurityException {
@@ -333,13 +350,17 @@
      * argument. Note that the Constructor may not be visible from the current
      * execution context.
      * 
-     * @param name The name of the field to look for.
+     * @param name
+     *            The name of the field to look for.
      * @return the field in the receiver named by the argument.
-     * @throws NoSuchFieldException if the requested field could not be found
-     * @throws SecurityException if member access is not allowed
+     * @throws NoSuchFieldException
+     *             if the requested field could not be found
+     * @throws SecurityException
+     *             if member access is not allowed
      * @see #getDeclaredFields
      */
-    public Field getDeclaredField(String name) throws NoSuchFieldException, SecurityException {
+    public Field getDeclaredField(String name) throws NoSuchFieldException,
+            SecurityException {
         return null;
     }
 
@@ -349,7 +370,8 @@
      * may not be visible in the current execution context.
      * 
      * @return the receiver's fields.
-     * @throws SecurityException If member access is not allowed
+     * @throws SecurityException
+     *             If member access is not allowed
      * @see #getFields
      */
     public Field[] getDeclaredFields() throws SecurityException {
@@ -361,12 +383,17 @@
      * arguments. Note that the associated method may not be visible from the
      * current execution context.
      * 
-     * @param name the name of the method
-     * @param parameterTypes the types of the arguments.
+     * @param name
+     *            the name of the method
+     * @param parameterTypes
+     *            the types of the arguments.
      * @return the method described by the arguments.
-     * @throws NoSuchMethodException if the method could not be found.
-     * @throws SecurityException If member access is not allowed
-     * @throws NullPointerException if the name parameter is <code>null</code>.
+     * @throws NoSuchMethodException
+     *             if the method could not be found.
+     * @throws SecurityException
+     *             If member access is not allowed
+     * @throws NullPointerException
+     *             if the name parameter is <code>null</code>.
      * @see #getMethods
      */
     public Method getDeclaredMethod(String name, Class... parameterTypes)
@@ -379,7 +406,8 @@
      * are defined by the receiver. Note that some of the methods which are
      * returned may not be visible in the current execution context.
      * 
-     * @throws SecurityException if member access is not allowed
+     * @throws SecurityException
+     *             if member access is not allowed
      * @return the receiver's methods.
      * @see #getMethods
      */
@@ -447,13 +475,17 @@
      * Answers a Field object describing the field in the receiver named by the
      * argument which must be visible from the current execution context.
      * 
-     * @param name The name of the field to look for.
+     * @param name
+     *            The name of the field to look for.
      * @return the field in the receiver named by the argument.
-     * @throws NoSuchFieldException If the given field does not exist
-     * @throws SecurityException If access is denied
+     * @throws NoSuchFieldException
+     *             If the given field does not exist
+     * @throws SecurityException
+     *             If access is denied
      * @see #getDeclaredFields
      */
-    public Field getField(String name) throws NoSuchFieldException, SecurityException {
+    public Field getField(String name) throws NoSuchFieldException,
+            SecurityException {
         return null;
     }
 
@@ -462,7 +494,8 @@
      * visible from the current execution context.
      * 
      * @return all visible fields starting from the receiver.
-     * @throws SecurityException If member access is not allowed
+     * @throws SecurityException
+     *             If member access is not allowed
      * @see #getDeclaredFields
      */
     public Field[] getFields() throws SecurityException {
@@ -504,15 +537,19 @@
      * Answers a Method object which represents the method described by the
      * arguments.
      * 
-     * @param name String the name of the method
-     * @param parameterTypes Class[] the types of the arguments.
+     * @param name
+     *            String the name of the method
+     * @param parameterTypes
+     *            Class[] the types of the arguments.
      * @return Method the method described by the arguments.
-     * @throws NoSuchMethodException if the method could not be found.
-     * @throws SecurityException if member access is not allowed
+     * @throws NoSuchMethodException
+     *             if the method could not be found.
+     * @throws SecurityException
+     *             if member access is not allowed
      * @see #getMethods
      */
-    public Method getMethod(String name, Class... parameterTypes) throws NoSuchMethodException,
-            SecurityException {
+    public Method getMethod(String name, Class... parameterTypes)
+            throws NoSuchMethodException, SecurityException {
         return null;
     }
 
@@ -521,7 +558,8 @@
      * are visible from the current execution context.
      * 
      * @return Method[] all visible methods starting from the receiver.
-     * @throws SecurityException if member access is not allowed
+     * @throws SecurityException
+     *             if member access is not allowed
      * @see #getDeclaredMethods
      */
     public Method[] getMethods() throws SecurityException {
@@ -542,10 +580,9 @@
     /**
      * Answers the name of the class which the receiver represents. For a
      * description of the format which is used, see the class definition of
-     * {@link Class}.
+     * <code>Class</code>.
      * 
      * @return the receiver's name.
-     * @see {@link Class}
      */
     public String getName() {
         return null;
@@ -565,7 +602,7 @@
 
     /**
      * Answers the ProtectionDomain of the receiver.
-     * <p>
+     * 
      * Note: In order to conserve space in embedded targets, we allow this
      * method to answer null for classes in the system protection domain (i.e.
      * for system classes). System classes are always given full permissions
@@ -573,7 +610,6 @@
      * java.security.Policy.
      * 
      * @return ProtectionDomain the receiver's ProtectionDomain.
-     * @see {@link Class}
      */
     public ProtectionDomain getProtectionDomain() {
         return null;
@@ -581,11 +617,10 @@
 
     /**
      * Answers the ProtectionDomain of the receiver.
-     * <p>
+     * 
      * This method is for internal use only.
      * 
      * @return ProtectionDomain the receiver's ProtectionDomain.
-     * @see {@link Class}
      */
     ProtectionDomain getPDImpl() {
         return null;
@@ -596,9 +631,10 @@
      * resName. The mapping between the resource name and the stream is managed
      * by the class' class loader.
      * 
-     * @param resName the name of the resource.
+     * @param resName
+     *            the name of the resource.
      * @return a stream on the resource.
-     * @see {@link ClassLoader}
+     * @see ClassLoader
      */
     public URL getResource(String resName) {
         return null;
@@ -609,9 +645,10 @@
      * resName. The mapping between the resource name and the stream is managed
      * by the class' class loader.
      * 
-     * @param resName the name of the resource.
+     * @param resName
+     *            the name of the resource.
      * @return a stream on the resource.
-     * @see {@link ClassLoader}
+     * @see ClassLoader
      */
     public InputStream getResourceAsStream(String resName) {
         return null;
@@ -664,12 +701,14 @@
     /**
      * Indicates whether or not the given annotation is present for this class.
      * 
-     * @param annotationClass The annotation to look for in this class.
+     * @param annotationClass
+     *            The annotation to look for in this class.
      * @return A value of <code>true</code> if the annotation is present,
      *         otherwise <code>false</code>.
      * @since 1.5
      */
-    public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) {
+    public boolean isAnnotationPresent(
+            Class<? extends Annotation> annotationClass) {
         return false;
     }
 
@@ -703,8 +742,10 @@
      * @return <code>true</code> the argument can be assigned into the
      *         receiver <code>false</code> the argument cannot be assigned
      *         into the receiver
-     * @param cls Class the class to test
-     * @throws NullPointerException if the parameter is null
+     * @param cls
+     *            Class the class to test
+     * @throws NullPointerException
+     *             if the parameter is null
      */
     public boolean isAssignableFrom(Class<?> cls) {
         return false;
@@ -729,7 +770,8 @@
      * @return <code>true</code> the argument can be cast to the type of the
      *         receiver <code>false</code> the argument is null or cannot be
      *         cast to the type of the receiver
-     * @param object Object the object to test
+     * @param object
+     *            Object the object to test
      */
     public boolean isInstance(Object object) {
         return false;
@@ -795,11 +837,13 @@
      * IllegalAccessException is thrown.
      * 
      * @return a new instance of the class represented by the receiver.
-     * @throws IllegalAccessException if the constructor is not visible to the
-     *         sender.
-     * @throws InstantiationException if the instance could not be created.
+     * @throws IllegalAccessException
+     *             if the constructor is not visible to the sender.
+     * @throws InstantiationException
+     *             if the instance could not be created.
      */
-    public T newInstance() throws IllegalAccessException, InstantiationException {
+    public T newInstance() throws IllegalAccessException,
+            InstantiationException {
         return null;
     }
 
@@ -836,26 +880,29 @@
     }
 
     /**
-     * Casts the receiver to a subclass of the given class.  If successful
+     * Casts the receiver to a subclass of the given class. If successful
      * answers the receiver, otherwise if the cast cannot be made throws a
      * <code>ClassCastException</code>.
      * 
-     * @param clazz the required type.
+     * @param clazz
+     *            the required type.
      * @return this class cast as a subclass of the given type.
-     * @throws ClassCastException if the class cannot be cast to the given type.
+     * @throws ClassCastException
+     *             if the class cannot be cast to the given type.
      */
     public <U> Class<? extends U> asSubclass(Class<U> clazz) {
         return null;
     }
 
     /**
-     * Cast the given object to the type <code>T</code>.
-     * If the object is <code>null</code> the result is also
-     * <code>null</code>.
+     * Cast the given object to the type <code>T</code>. If the object is
+     * <code>null</code> the result is also <code>null</code>.
      * 
-     * @param obj the object to cast
+     * @param obj
+     *            the object to cast
      * @return The object that has been cast.
-     * @throws ClassCastException if the object cannot be cast to the given type.
+     * @throws ClassCastException
+     *             if the object cannot be cast to the given type.
      */
     public T cast(Object obj) {
         return null;

Modified: harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni-kernel/src/main/java/java/lang/ClassLoader.java Fri Feb 15 04:04:10 2008
@@ -43,6 +43,7 @@
 
     /**
      * The 'System' ClassLoader; also known as the bootstrap ClassLoader.
+     * 
      * @see #getSystemClassLoader()
      */
     static ClassLoader systemClassLoader;
@@ -68,8 +69,9 @@
      * thrown.
      * 
      * @return The system classLoader.
-     * @throws SecurityException if a security manager exists and it does not
-     *         allow access to the system class loader.
+     * @throws SecurityException
+     *             if a security manager exists and it does not allow access to
+     *             the system class loader.
      */
     public static ClassLoader getSystemClassLoader() {
         return null;
@@ -80,7 +82,8 @@
      * resName using the system class loader's resource lookup algorithm.
      * 
      * @return A URL specifying a system resource or null.
-     * @param resName The name of the resource to find.
+     * @param resName
+     *            The name of the resource to find.
      * @see Class#getResource
      */
     public static URL getSystemResource(String resName) {
@@ -93,9 +96,13 @@
      * lookup algorithm.
      * 
      * @return An Enumeration of URLs containing the system resources
-     * @param resName String the name of the resource to find.
+     * @param resName
+     *            String the name of the resource to find.
+     * @throws IOException
+     *             if an IO exception occurs
      */
-    public static Enumeration<URL> getSystemResources(String resName) throws IOException {
+    public static Enumeration<URL> getSystemResources(String resName)
+            throws IOException {
         return null;
     }
 
@@ -106,7 +113,8 @@
      * matches the specified resource.
      * 
      * @return A stream on the resource or null.
-     * @param resName The name of the resource to find.
+     * @param resName
+     *            The name of the resource to find.
      * @see Class#getResourceAsStream
      */
     public static InputStream getSystemResourceAsStream(String resName) {
@@ -117,8 +125,9 @@
      * Constructs a new instance of this class with the system class loader as
      * its parent.
      * 
-     * @throws SecurityException if a security manager exists and it does not
-     *         allow the creation of new ClassLoaders.
+     * @throws SecurityException
+     *             if a security manager exists and it does not allow the
+     *             creation of new ClassLoaders.
      */
     protected ClassLoader() {
         super();
@@ -128,11 +137,13 @@
      * Constructs a new instance of this class with the given class loader as
      * its parent.
      * 
-     * @param parentLoader The ClassLoader to use as the new class loaders
-     *        parent.
-     * @throws SecurityException if a security manager exists and it does not
-     *         allow the creation of new ClassLoaders.
-     * @throws NullPointerException if the parent is null.
+     * @param parentLoader
+     *            The ClassLoader to use as the new class loaders parent.
+     * @throws SecurityException
+     *             if a security manager exists and it does not allow the
+     *             creation of new ClassLoaders.
+     * @throws NullPointerException
+     *             if the parent is null.
      */
     protected ClassLoader(ClassLoader parentLoader) {
         super();
@@ -142,9 +153,12 @@
      * Constructs a new class from an array of bytes containing a class
      * definition in class file format.
      * 
-     * @param classRep A memory image of a class file.
-     * @param offset The offset into the classRep.
-     * @param length The length of the class file.
+     * @param classRep
+     *            A memory image of a class file.
+     * @param offset
+     *            The offset into the classRep.
+     * @param length
+     *            The length of the class file.
      * @deprecated Use defineClass(String, byte[], int, int)
      */
     @Deprecated
@@ -157,13 +171,17 @@
      * Constructs a new class from an array of bytes containing a class
      * definition in class file format.
      * 
-     * @param className The name of the new class
-     * @param classRep A memory image of a class file
-     * @param offset The offset into the classRep
-     * @param length The length of the class file
+     * @param className
+     *            The name of the new class
+     * @param classRep
+     *            A memory image of a class file
+     * @param offset
+     *            The offset into the classRep
+     * @param length
+     *            The length of the class file
      */
-    protected final Class<?> defineClass(String className, byte[] classRep, int offset,
-            int length) throws ClassFormatError {
+    protected final Class<?> defineClass(String className, byte[] classRep,
+            int offset, int length) throws ClassFormatError {
         return null;
     }
 
@@ -172,15 +190,20 @@
      * definition in class file format and assigns the new class to the
      * specified protection domain.
      * 
-     * @param className The name of the new class.
-     * @param classRep A memory image of a class file.
-     * @param offset The offset into the classRep.
-     * @param length The length of the class file.
-     * @param protectionDomain The protection domain this class should belongs
-     *        to.
-     */
-    protected final Class<?> defineClass(String className, byte[] classRep, int offset,
-            int length, ProtectionDomain protectionDomain) throws java.lang.ClassFormatError {
+     * @param className
+     *            The name of the new class.
+     * @param classRep
+     *            A memory image of a class file.
+     * @param offset
+     *            The offset into the classRep.
+     * @param length
+     *            The length of the class file.
+     * @param protectionDomain
+     *            The protection domain this class should belongs to.
+     */
+    protected final Class<?> defineClass(String className, byte[] classRep,
+            int offset, int length, ProtectionDomain protectionDomain)
+            throws java.lang.ClassFormatError {
         return null;
     }
 
@@ -190,11 +213,15 @@
      * protection domain.
      * </p>
      * 
-     * @param name The name of the class to define.
-     * @param b The byte buffer containing the bytecodes of the new class.
-     * @param protectionDomain The protection domain this class belongs to.
+     * @param name
+     *            The name of the class to define.
+     * @param b
+     *            The byte buffer containing the bytecodes of the new class.
+     * @param protectionDomain
+     *            The protection domain this class belongs to.
      * @return The defined class.
-     * @throws ClassFormatError if an invalid class file is defined.
+     * @throws ClassFormatError
+     *             if an invalid class file is defined.
      * @since 1.5
      */
     protected final Class<?> defineClass(String name, ByteBuffer b,
@@ -210,10 +237,13 @@
      * to find a loaded class of the same name.
      * 
      * @return The class or null.
-     * @param className The name of the class to search for.
-     * @throws ClassNotFoundException if the class cannot be found.
+     * @param className
+     *            The name of the class to search for.
+     * @throws ClassNotFoundException
+     *             if the class cannot be found.
      */
-    protected Class<?> findClass(String className) throws ClassNotFoundException {
+    protected Class<?> findClass(String className)
+            throws ClassNotFoundException {
         return null;
     }
 
@@ -223,7 +253,8 @@
      * caller should call resolveClass() on the result if necessary.
      * 
      * @return The class or null.
-     * @param className The name of the class to search for.
+     * @param className
+     *            The name of the class to search for.
      */
     protected final Class<?> findLoadedClass(String className) {
         return null;
@@ -234,10 +265,13 @@
      * class has already been been linked.
      * 
      * @return The class which was loaded.
-     * @param className The name of the class to search for.
-     * @throws ClassNotFoundException if the class cannot be found.
+     * @param className
+     *            The name of the class to search for.
+     * @throws ClassNotFoundException
+     *             if the class cannot be found.
      */
-    protected final Class<?> findSystemClass(String className) throws ClassNotFoundException {
+    protected final Class<?> findSystemClass(String className)
+            throws ClassNotFoundException {
         return null;
     }
 
@@ -245,8 +279,9 @@
      * Returns the specified ClassLoader's parent.
      * 
      * @return The class or null.
-     * @throws SecurityException if a security manager exists and it does not
-     *         allow the parent loader to be retrieved.
+     * @throws SecurityException
+     *             if a security manager exists and it does not allow the parent
+     *             loader to be retrieved.
      */
     public final ClassLoader getParent() {
         return null;
@@ -258,8 +293,9 @@
      * behavior is just to return null.
      * 
      * @return The location of the resource.
-     * @param resName String the name of the resource to find.
-     * @see Class#getResource
+     * @param resName
+     *            String the name of the resource to find.
+     * @see Class#getResource(String)
      */
     public URL getResource(String resName) {
         return null;
@@ -271,7 +307,10 @@
      * The default behavior is just to return an empty Enumeration.
      * 
      * @return The location of the resources.
-     * @param resName String the name of the resource to find.
+     * @param resName
+     *            String the name of the resource to find.
+     * @throws IOException
+     *             if an IO exception occurs
      */
     public Enumeration<URL> getResources(String resName) throws IOException {
         return null;
@@ -283,7 +322,8 @@
      * return null.
      * 
      * @return A stream on the resource or null.
-     * @param resName String the name of the resource to find.
+     * @param resName
+     *            String the name of the resource to find.
      * @see Class#getResourceAsStream
      */
     public InputStream getResourceAsStream(String resName) {
@@ -295,8 +335,10 @@
      * Equivalent to loadClass(className, false);
      * 
      * @return The Class object.
-     * @param className The name of the class to search for.
-     * @throws ClassNotFoundException if the class could not be found.
+     * @param className
+     *            The name of the class to search for.
+     * @throws ClassNotFoundException
+     *             if the class could not be found.
      */
     public Class<?> loadClass(String className) throws ClassNotFoundException {
         return null;
@@ -309,9 +351,12 @@
      * loader. 3) Call findClass(className) to find the class
      * 
      * @return The Class object.
-     * @param className The name of the class to search for.
-     * @param resolveClass Indicates if class should be resolved after loading.
-     * @throws ClassNotFoundException if the class could not be found.
+     * @param className
+     *            The name of the class to search for.
+     * @param resolveClass
+     *            Indicates if class should be resolved after loading.
+     * @throws ClassNotFoundException
+     *             if the class could not be found.
      */
     protected Class<?> loadClass(String className, boolean resolveClass)
             throws ClassNotFoundException {
@@ -322,28 +367,27 @@
      * Forces a class to be linked (initialized). If the class has already been
      * linked this operation has no effect.
      * 
-     * @param clazz The Class to link.
-     * @throws NullPointerException if clazz is null.
-     * @see Class#getResource
+     * @param clazz
+     *            The Class to link.
+     * @throws NullPointerException
+     *             if clazz is null.
      */
     protected final void resolveClass(Class<?> clazz) {
         return;
     }
 
     /**
-     * <p>
      * This method must be provided by the VM vendor, as it is used by other
      * provided class implementations in this package. A sample implementation
      * of this method is provided by the reference implementation. This method
      * is used by SecurityManager.classLoaderDepth(), currentClassLoader() and
      * currentLoadedClass(). Answers true if the receiver is a system class
      * loader.
-     * </p>
-     * <p>
+     * 
      * Note that this method has package visibility only. It is defined here to
      * avoid the security manager check in getSystemClassLoader, which would be
      * required to implement this method anywhere else.
-     * </p>
+     *
      * 
      * @return <code>true</code> if the receiver is a system class loader
      * @see Class#getClassLoaderImpl()
@@ -362,7 +406,8 @@
      * implement this method anywhere else.
      * </p>
      * 
-     * @param child A child candidate
+     * @param child
+     *            A child candidate
      * @return <code>true</code> if the receiver is ancestor of the parameter
      */
     final boolean isAncestorOf(ClassLoader child) {
@@ -376,7 +421,8 @@
      * ClassLoader.
      * 
      * @return The location of the resource.
-     * @param resName The name of the resource to find.
+     * @param resName
+     *            The name of the resource to find.
      */
     protected URL findResource(String resName) {
         return null;
@@ -387,11 +433,13 @@
      * described by resName, using the class loader's resource lookup algorithm.
      * The default behavior is just to return an empty Enumeration.
      * 
-     * @param resName The name of the resource to find.
+     * @param resName
+     *            The name of the resource to find.
      * 
      * @return The locations of the resources.
      * 
-     * @throws IOException when an error occurs
+     * @throws IOException
+     *             when an error occurs
      */
     protected Enumeration<URL> findResources(String resName) throws IOException {
         return null;
@@ -403,7 +451,8 @@
      * the directories specified by the system property "java.library.path".
      * 
      * @return The library file name or null.
-     * @param libName The name of the library to find.
+     * @param libName
+     *            The name of the library to find.
      */
     protected String findLibrary(String libName) {
         return null;
@@ -413,7 +462,8 @@
      * Attempt to locate the requested package. If no package information can be
      * located, null is returned.
      * 
-     * @param name The name of the package to find
+     * @param name
+     *            The name of the package to find
      * @return The package requested, or null
      */
     protected Package getPackage(String name) {
@@ -432,28 +482,39 @@
     /**
      * Define a new Package using the specified information.
      * 
-     * @param name The name of the package
-     * @param specTitle The title of the specification for the Package
-     * @param specVersion The version of the specification for the Package
-     * @param specVendor The vendor of the specification for the Package
-     * @param implTitle The implementation title of the Package
-     * @param implVersion The implementation version of the Package
-     * @param implVendor The specification vendor of the Package
-     * @param sealBase If sealBase is null, the package is left unsealed.
-     *        Otherwise, the the package is sealed using this URL.
+     * @param name
+     *            The name of the package
+     * @param specTitle
+     *            The title of the specification for the Package
+     * @param specVersion
+     *            The version of the specification for the Package
+     * @param specVendor
+     *            The vendor of the specification for the Package
+     * @param implTitle
+     *            The implementation title of the Package
+     * @param implVersion
+     *            The implementation version of the Package
+     * @param implVendor
+     *            The specification vendor of the Package
+     * @param sealBase
+     *            If sealBase is null, the package is left unsealed. Otherwise,
+     *            the the package is sealed using this URL.
      * @return The Package created
-     * @throws IllegalArgumentException if the Package already exists
+     * @throws IllegalArgumentException
+     *             if the Package already exists
      */
-    protected Package definePackage(String name, String specTitle, String specVersion,
-            String specVendor, String implTitle, String implVersion, String implVendor,
-            URL sealBase) throws IllegalArgumentException {
+    protected Package definePackage(String name, String specTitle,
+            String specVersion, String specVendor, String implTitle,
+            String implVersion, String implVendor, URL sealBase)
+            throws IllegalArgumentException {
         return null;
     }
 
     /**
      * Gets the signers of a class.
      * 
-     * @param c The Class object
+     * @param c
+     *            The Class object
      * @return signers The signers for the class
      */
     final Object[] getSigners(Class<?> c) {
@@ -463,8 +524,10 @@
     /**
      * Sets the signers of a class.
      * 
-     * @param c The Class object
-     * @param signers The signers for the class
+     * @param c
+     *            The Class object
+     * @param signers
+     *            The signers for the class
      */
     protected final void setSigners(Class<?> c, Object[] signers) {
         return;
@@ -496,7 +559,8 @@
      * <li>The item at depth zero is the caller of this method</li>
      * </ul>
      * 
-     * @param depth the stack depth of the requested ClassLoader
+     * @param depth
+     *            the stack depth of the requested ClassLoader
      * @return the ClassLoader at the specified depth
      */
     static final ClassLoader getStackClassLoader(int depth) {
@@ -524,10 +588,14 @@
      * ClassLoader of the calling method. Loads and links the library specified
      * by the argument.
      * 
-     * @param libName the name of the library to load
-     * @param loader the classloader in which to load the library
-     * @throws UnsatisfiedLinkError if the library could not be loaded
-     * @throws SecurityException if the library was not allowed to be loaded
+     * @param libName
+     *            the name of the library to load
+     * @param loader
+     *            the classloader in which to load the library
+     * @throws UnsatisfiedLinkError
+     *             if the library could not be loaded
+     * @throws SecurityException
+     *             if the library was not allowed to be loaded
      */
     static void loadLibraryWithClassLoader(String libName, ClassLoader loader) {
         return;
@@ -540,20 +608,27 @@
      * and links the library specified by the argument. No security check is
      * done.
      * 
-     * @param libName the name of the library to load
-     * @param loader the classloader in which to load the library
-     * @param libraryPath the library path to search, or null
-     * @throws UnsatisfiedLinkError if the library could not be loaded
+     * @param libName
+     *            the name of the library to load
+     * @param loader
+     *            the classloader in which to load the library
+     * @param libraryPath
+     *            the library path to search, or null
+     * @throws UnsatisfiedLinkError
+     *             if the library could not be loaded
      */
-    static void loadLibraryWithPath(String libName, ClassLoader loader, String libraryPath) {
+    static void loadLibraryWithPath(String libName, ClassLoader loader,
+            String libraryPath) {
         return;
     }
 
     /**
      * Sets the assertion status of a class.
      * 
-     * @param cname Class name
-     * @param enable Enable or disable assertion
+     * @param cname
+     *            Class name
+     * @param enable
+     *            Enable or disable assertion
      */
     public void setClassAssertionStatus(String cname, boolean enable) {
         return;
@@ -562,8 +637,10 @@
     /**
      * Sets the assertion status of a package.
      * 
-     * @param pname Package name
-     * @param enable Enable or disable assertion
+     * @param pname
+     *            Package name
+     * @param enable
+     *            Enable or disable assertion
      */
     public void setPackageAssertionStatus(String pname, boolean enable) {
         return;
@@ -572,7 +649,8 @@
     /**
      * Sets the default assertion status of a classloader
      * 
-     * @param enable Enable or disable assertion
+     * @param enable
+     *            Enable or disable assertion
      */
     public void setDefaultAssertionStatus(boolean enable) {
         return;
@@ -594,7 +672,8 @@
      * 0 for disabled.
      * 
      * @return the assertion status.
-     * @param cname the name of class.
+     * @param cname
+     *            the name of class.
      */
     boolean getClassAssertionStatus(String cname) {
         return false;
@@ -607,7 +686,8 @@
      * 0 for disabled.
      * 
      * @return the assertion status.
-     * @param pname the name of package.
+     * @param pname
+     *            the name of package.
      */
     boolean getPackageAssertionStatus(String pname) {
         return false;

Modified: harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Arrays.java Fri Feb 15 04:04:10 2008
@@ -3037,14 +3037,14 @@
     }
 
     /**
-     * <p>
      * Creates a <code>String</code> representation of the <code>byte[]</code>
-     * passed. The result is surrounded by brackets (<code>&quot;[]&quot;</code>),
+     * passed.
+     * 
+     * The result is surrounded by brackets (<code>&quot;[]&quot;</code>),
      * each element is converted to a <code>String</code> via the
-     * {@link String#valueOf(byte)} and separated by <code>&quot;, &quot;</code>.
+     * {@link String#valueOf(int)} and separated by <code>&quot;, &quot;</code>.
      * If the array is <code>null</code>, then <code>&quot;null&quot;</code>
      * is returned.
-     * </p>
      * 
      * @param array
      *            The <code>byte</code> array to convert.
@@ -3235,14 +3235,14 @@
     }
 
     /**
-     * <p>
      * Creates a <code>String</code> representation of the
-     * <code>short[]</code> passed. The result is surrounded by brackets (<code>&quot;[]&quot;</code>),
+     * <code>short[]</code> passed.
+     * 
+     * The result is surrounded by brackets (<code>&quot;[]&quot;</code>),
      * each element is converted to a <code>String</code> via the
-     * {@link String#valueOf(short)} and separated by
-     * <code>&quot;, &quot;</code>. If the array is <code>null</code>,
-     * then <code>&quot;null&quot;</code> is returned.
-     * </p>
+     * {@link String#valueOf(int)} and separated by <code>&quot;, &quot;</code>.
+     * If the array is <code>null</code>, then <code>&quot;null&quot;</code>
+     * is returned.
      * 
      * @param array
      *            The <code>short</code> array to convert.

Modified: harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java (original)
+++ harmony/enhanced/classlib/trunk/modules/luni/src/main/java/java/util/Collections.java Fri Feb 15 04:04:10 2008
@@ -168,12 +168,27 @@
         }
     }
 
+    /**
+     * An immutable, serializable, empty <code>List</code>.
+     *
+     * @see Collections#emptyList()
+     */
     @SuppressWarnings("unchecked")
     public static final List EMPTY_LIST = new EmptyList();
 
+    /**
+     * An immutable, serializable, empty <code>Set</code>.
+     * 
+     * @see Collections#emptySet()
+     */
     @SuppressWarnings("unchecked")
     public static final Set EMPTY_SET = new EmptySet();
 
+    /**
+     * An immutable, serializable, empty <code>Map</code>.
+     * 
+     * @see Collections#emptyMap()
+     */
     @SuppressWarnings("unchecked")
     public static final Map EMPTY_MAP = new EmptyMap();
 
@@ -1505,6 +1520,8 @@
      * Performs a binary search for the specified element in the specified
      * sorted List using the specified Comparator.
      * 
+     * @param <T> The element type
+     * 
      * @param list
      *            the sorted List to search
      * @param object
@@ -2543,7 +2560,7 @@
     /**
      * Returns a dynamically typesafe view of the specified set.
      * 
-     * @param c
+     * @param s
      *            the set
      * @param type
      *            the type of the elements is permitted to insert
@@ -2574,7 +2591,7 @@
     /**
      * Returns a dynamically typesafe view of the specified sorted set.
      * 
-     * @param c
+     * @param s
      *            the sorted set
      * @param type
      *            the type of the elements is permitted to insert
@@ -3235,9 +3252,11 @@
              * Constructs a dynamically typesafe view of the specified map
              * entry.
              * 
-             * @param e -
+             * @param e
              *            the map entry for which a dynamically typesafe view is
              *            to be constructed.
+             * @param valueType
+             *            the type of the value
              */
             public CheckedEntry(Map.Entry<K, V> e, Class<V> valueType) {
                 if (e == null) {

Modified: harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java
URL: http://svn.apache.org/viewvc/harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java?rev=628032&r1=628031&r2=628032&view=diff
==============================================================================
--- harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java (original)
+++ harmony/enhanced/classlib/trunk/modules/security-kernel/src/main/java/java/security/AccessController.java Fri Feb 15 04:04:10 2008
@@ -23,9 +23,7 @@
  * 
  * Checks access to system resources. Supports marking of code as priveleged.
  * Makes context snapshots to allow checking from other contexts.
- * 
  */
-
 public final class AccessController {
 	static {
 		// Initialize vm-internal caches
@@ -193,7 +191,7 @@
 
 	/**
 	 * Performs the privileged action specified by <code>action</code>.
-	 * <p>
+	 * 
 	 * When permission checks are made, if the permission has been granted by
 	 * all frames below and including the one representing the call to this
 	 * method, then the permission is granted iff it is granted by the
@@ -204,8 +202,7 @@
 	 * Any unchecked exception generated by this method will propagate up the
 	 * chain.
 	 * 
-	 * 
-	 * @see #doPrivileged(PrivilegedAction<T>)
+	 * @see #doPrivileged(PrivilegedAction)
 	 */
 	public static <T> T doPrivileged(PrivilegedAction<T> action,
 			AccessControlContext context) {
@@ -216,7 +213,7 @@
 
 	/**
 	 * Performs the privileged action specified by <code>action</code>.
-	 * <p>
+	 * 
 	 * When permission checks are made, if the permission has been granted by
 	 * all frames below and including the one representing the call to this
 	 * method, then the permission is granted. In otherwords, the check stops
@@ -226,8 +223,7 @@
 	 * chain. However, checked exceptions will be caught an re-thrown as
 	 * PrivilegedActionExceptions
 	 * 
-	 * 
-	 * @see #doPrivileged(PrivilegedAction<T>)
+	 * @see #doPrivileged(PrivilegedAction)
 	 */
 	public static <T> T doPrivileged(PrivilegedExceptionAction<T> action)
 			throws PrivilegedActionException {
@@ -242,7 +238,7 @@
 
 	/**
 	 * Performs the privileged action specified by <code>action</code>.
-	 * <p>
+	 * 
 	 * When permission checks are made, if the permission has been granted by
 	 * all frames below and including the one representing the call to this
 	 * method, then the permission is granted iff it is granted by the
@@ -254,8 +250,7 @@
 	 * chain. However, checked exceptions will be caught an re-thrown as
 	 * PrivilegedActionExceptions
 	 * 
-	 * 
-	 * @see #doPrivileged(PrivilegedAction<T>)
+	 * @see #doPrivileged(PrivilegedAction)
 	 */
 	public static <T> T doPrivileged(PrivilegedExceptionAction<T> action,
 			AccessControlContext context) throws PrivilegedActionException {



Mime
View raw message