The SecurityManager doesn't work, so advertise that shouldn't be used.
diff --git a/libcore/luni-kernel/src/main/java/java/lang/System.java b/libcore/luni-kernel/src/main/java/java/lang/System.java
index b97a75a..aa78b1b 100644
--- a/libcore/luni-kernel/src/main/java/java/lang/System.java
+++ b/libcore/luni-kernel/src/main/java/java/lang/System.java
@@ -603,10 +603,14 @@
}
/**
- * Sets the active security manager. Note that once the security manager has
- * been set, it can not be changed. Attempts to do that will cause a
+ * <strong>Warning:</strong> security managers do <strong>not</strong>
+ * provide a secure environment for executing untrusted code. Untrusted code
+ * cannot be safely isolated within the Dalvik VM.
+ *
+ * <p>Sets the active security manager. Note that once the security manager
+ * has been set, it can not be changed. Attempts to do that will cause a
* security exception.
- *
+ *
* @param sm
* the new security manager.
* @throws SecurityException
diff --git a/libcore/luni/src/main/java/java/lang/SecurityManager.java b/libcore/luni/src/main/java/java/lang/SecurityManager.java
index 8a04e92..736d537 100644
--- a/libcore/luni/src/main/java/java/lang/SecurityManager.java
+++ b/libcore/luni/src/main/java/java/lang/SecurityManager.java
@@ -41,7 +41,11 @@
import org.apache.harmony.luni.util.PriviAction;
/**
- * Provides security verification facilities for applications. {@code
+ * <strong>Warning:</strong> security managers do <strong>not</strong> provide a
+ * secure environment for executing untrusted code. Untrusted code cannot be
+ * safely isolated within the Dalvik VM.
+ *
+ * <p>Provides security verification facilities for applications. {@code
* SecurityManager} contains a set of {@code checkXXX} methods which determine
* if it is safe to perform a specific operation such as establishing network
* connections, modifying files, and many more. In general, these methods simply
