AccessControlContext.java, [...]: Fixed javadocs.
authorMichael Koch <konqueror@gmx.de>
Fri, 9 Jul 2004 15:43:01 +0000 (15:43 +0000)
committerMichael Koch <mkoch@gcc.gnu.org>
Fri, 9 Jul 2004 15:43:01 +0000 (15:43 +0000)
2004-07-09  Michael Koch  <konqueror@gmx.de>

* java/security/AccessControlContext.java,
java/security/SecureClassLoader.java:
Fixed javadocs.

From-SVN: r84383

libjava/ChangeLog
libjava/java/security/AccessControlContext.java
libjava/java/security/SecureClassLoader.java

index b7eea9697b9bd0e83f79cc283cf3285905834394..fc3524fa67ac591cf3a1e0a1e28927fce95cff6f 100644 (file)
@@ -1,3 +1,9 @@
+2004-07-09  Michael Koch  <konqueror@gmx.de>
+
+       * java/security/AccessControlContext.java,
+       java/security/SecureClassLoader.java:
+       Fixed javadocs.
+
 2004-07-09  Michael Koch  <konqueror@gmx.de>
 
        * java/io/ObjectInputStream.java (readFields): Use long datatype
index 5b9ac4a254850ed1b57a39f751db19445ef0062f..62370224d119813ce97038e32ff884b6e045e2cc 100644 (file)
@@ -1,5 +1,5 @@
 /* AccessControlContext.java --- Access Control Context Class
-   Copyright (C) 1999 Free Software Foundation, Inc.
+   Copyright (C) 1999, 2004 Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -38,18 +38,18 @@ exception statement from your version. */
 package java.security;
 
 /**
  AccessControlContext makes system resource access decsion 
  based on permission rights.  
-
  It is used for a specific context and has only one method
  checkPermission. It is similar to AccessController except
  that it makes decsions based on the current context instead
  of the the current thread.
-
  It is created by call AccessController.getContext method.
-
  @author Mark Benvenuto
  @since JDK 1.2
* AccessControlContext makes system resource access decsion 
* based on permission rights.  
+ *
* It is used for a specific context and has only one method
* checkPermission. It is similar to AccessController except
* that it makes decsions based on the current context instead
* of the the current thread.
+ *
* It is created by call AccessController.getContext method.
+ *
* @author Mark Benvenuto
* @since 1.2
  */
 public final class AccessControlContext
 {
@@ -57,11 +57,11 @@ public final class AccessControlContext
   private DomainCombiner combiner;
 
   /**
-     Construct a new AccessControlContext with the specified
-     ProtectionDomains. <code>context</code> must not be 
-     null and duplicates will be removed.
-
-     @param context The ProtectionDomains to use
+   * Construct a new AccessControlContext with the specified
+   * ProtectionDomains. <code>context</code> must not be 
+   * null and duplicates will be removed.
+   *
+   * @param context The ProtectionDomains to use
    */
   public AccessControlContext(ProtectionDomain[]context)
   {
@@ -91,12 +91,10 @@ public final class AccessControlContext
   }
 
   /**
-     Construct a new AccessControlContext with the specified
-     ProtectionDomains and DomainCombiner
-
-     @param context The ProtectionDomains to use
-
-     @since JDK 1.3
+   * Construct a new AccessControlContext with the specified
+   * ProtectionDomains and DomainCombiner
+   *
+   * @since 1.3
    */
   public AccessControlContext(AccessControlContext acc,
                              DomainCombiner combiner)
@@ -106,9 +104,9 @@ public final class AccessControlContext
   }
 
   /**
-     Returns the Domain Combiner associated with the AccessControlContext
-
-     @returns the DomainCombiner
+   * Returns the Domain Combiner associated with the AccessControlContext
+   *
+   * @return the DomainCombiner
    */
   public DomainCombiner getDomainCombiner()
   {
@@ -116,12 +114,12 @@ public final class AccessControlContext
   }
 
   /**
-     Determines whether or not the specific permission is granted
-     depending on the context it is within. 
-
-     @param perm a permission to check
-
-     @throws AccessControlException if the permssion is not permitted
+   * Determines whether or not the specific permission is granted
+   * depending on the context it is within. 
+   *
+   * @param perm a permission to check
+   *
+   * @throws AccessControlException if the permssion is not permitted
    */
   public void checkPermission(Permission perm) throws AccessControlException
   {
@@ -133,14 +131,14 @@ public final class AccessControlContext
   }
 
   /**
-     Checks if two AccessControlContexts are equal.
-
-     It first checks if obj is an AccessControlContext class, and
-     then checks if each ProtectionDomain matches.
-
-     @param obj The object to compare this class to
-
-     @return true if equal, false otherwise
+   * Checks if two AccessControlContexts are equal.
+   *
+   * It first checks if obj is an AccessControlContext class, and
+   * then checks if each ProtectionDomain matches.
+   *
+   * @param obj The object to compare this class to
+   *
+   * @return true if equal, false otherwise
    */
   public boolean equals(Object obj)
   {
@@ -160,9 +158,9 @@ public final class AccessControlContext
   }
 
   /**
-     Computes a hash code of this class
-
-     @return a hash code representing this class
+   * Computes a hash code of this class
+   *
+   * @return a hash code representing this class
    */
   public int hashCode()
   {
index 5f7ac211bf07a23cb2323e1ace03d87a6fc6a64e..1f67a33dc2c0650dda209f757faa986808d84c0c 100644 (file)
@@ -1,5 +1,5 @@
 /* SecureClassLoader.java --- A Secure Class Loader
-   Copyright (C) 1999 Free Software Foundation, Inc.
+   Copyright (C) 1999, 2004  Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -38,13 +38,13 @@ exception statement from your version. */
 package java.security;
 
 /**
  A Secure Class Loader for loading classes with additional 
  support for specifying code source and permissions when
  they are retrieved by the system policy handler.
-
  @since JDK 1.2
-
  @author Mark Benvenuto
* A Secure Class Loader for loading classes with additional 
* support for specifying code source and permissions when
* they are retrieved by the system policy handler.
+ *
* @since 1.2
+ *
* @author Mark Benvenuto
  */
 public class SecureClassLoader extends ClassLoader
 {
@@ -64,18 +64,18 @@ public class SecureClassLoader extends ClassLoader
   }
 
   /** 
-     Creates a class using an array of bytes and a 
-     CodeSource.
-
-     @param name the name to give the class.  null if unknown.
-     @param b the data representing the classfile, in classfile format.
-     @param off the offset into the data where the classfile starts.
-     @param len the length of the classfile data in the array.
-     @param cs the CodeSource for the class or null when unknown.
-
-     @return the class that was defined and optional CodeSource.
-
-     @exception ClassFormatError if the byte array is not in proper classfile format.
+   * Creates a class using an array of bytes and a 
+   * CodeSource.
+   *
+   * @param name the name to give the class.  null if unknown.
+   * @param b the data representing the classfile, in classfile format.
+   * @param off the offset into the data where the classfile starts.
+   * @param len the length of the classfile data in the array.
+   * @param cs the CodeSource for the class or null when unknown.
+   *
+   * @return the class that was defined and optional CodeSource.
+   *
+   * @exception ClassFormatError if the byte array is not in proper classfile format.
    */
   protected final Class defineClass(String name, byte[] b, int off, int len,
                                    CodeSource cs)
@@ -92,14 +92,13 @@ public class SecureClassLoader extends ClassLoader
   }
 
   /**
-     Returns a PermissionCollection for the specified CodeSource.
-     The default implementation invokes 
-     java.security.Policy.getPermissions.
-
-     This method is called by defineClass that takes a CodeSource
-     arguement to build a proper ProtectionDomain for the class
-     being defined.
-
+   * Returns a PermissionCollection for the specified CodeSource.
+   * The default implementation invokes 
+   * java.security.Policy.getPermissions.
+   *
+   * This method is called by defineClass that takes a CodeSource
+   * arguement to build a proper ProtectionDomain for the class
+   * being defined.
    */
   protected PermissionCollection getPermissions(CodeSource cs)
   {