2004-06-03 Michael Koch <konqueror@gmx.de>

	* java/security/AccessControlContext.java,
	java/security/ProtectionDomain.java,
	java/security/SecureClassLoader.java,
	java/util/PropertyPermissionCollection.java:
	Fixed javadocs all over.

1 files changed, 41 insertions, 43 deletions

diff --git a/java/security/AccessControlContext.java b/java/security/AccessControlContext.java
index 2550af041..c986ab279 100644
--- a/java/security/AccessControlContext.java
+++ b/java/security/AccessControlContext.java
@@ -40,18 +40,18 @@ package java.security;
 import java.util.HashSet;
 
 /**
-   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
 {
@@ -59,11 +59,11 @@ public final class AccessControlContext
   private final 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)
   {
@@ -76,12 +76,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)
@@ -101,9 +99,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()
   {
@@ -111,12 +109,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
   {
@@ -126,14 +124,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)
   {
@@ -161,9 +159,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()
   {