2002-03-06 Eric Blake <ebb9@email.byu.edu>

	* java/lang/RuntimePermission.java: Improve Javadoc.
	* java/lang/SecurityManager.java: Improve Javadoc and formatting.
	* java/lang/System.java (setIn, setOut, setErr): Add required
	security check.
	(defaultProperties): Add a default, to allow clean resetting of
	properties back to the VM startup state.
	(setProperties): Correctly reset properties to default state.
	* native/jni/java-lang/java_lang_System.c: Update method
	signatures for changing I/O.
	* include/java_lang_System.h: Ditto.
	* vm/reference/java/lang/Runtime.java: Add shutdown hook
	capability, as well as updating the exec calls.
	* vm/reference/java/lang/VMSecurityManager.java: Improve Javadoc.
	* java/util/PropertyPermission.java: Fix implication bugs.
	* java/util/PropertyPermissionCollection.java: Ditto.

1 files changed, 6 insertions, 1 deletions

diff --git a/vm/reference/java/lang/VMSecurityManager.java b/vm/reference/java/lang/VMSecurityManager.java
index a70d049d9..3d95c8a96 100644
--- a/vm/reference/java/lang/VMSecurityManager.java
+++ b/vm/reference/java/lang/VMSecurityManager.java
@@ -60,7 +60,12 @@ final class VMSecurityManager
   static native Class[] getClassContext();
 
   /**
-   * Get the current ClassLoader--the one nearest to the top of the stack.
+   * Get the current ClassLoader. This is the first non-null class loader
+   * on the stack, if one exists, stopping either at the end of the stack
+   * or the first instance of a PrivilegedAction. In other words, this call
+   * automatically unwinds past all classes loaded by the bootstrap loader,
+   * where getClassLoader() returns null, to get to the user class that
+   * really invoked the call that needs a classloader.
    *
    * @return the current ClassLoader
    */