diff --git a/core/src/main/java/hudson/util/Scrambler.java b/core/src/main/java/hudson/util/Scrambler.java
index 6555edef09232ac1760a8fd05b0141ba0022b5c3..e8f6fe0ac24474b4c176d8c677d5c2e735b6da40 100644
--- a/core/src/main/java/hudson/util/Scrambler.java
+++ b/core/src/main/java/hudson/util/Scrambler.java
@@ -29,12 +29,9 @@ import java.io.IOException;
 import java.io.UnsupportedEncodingException;
 
 /**
- * Used when storing passwords in configuration files.
- *
- * <p>
- * This doesn't make passwords secure, but it prevents unwanted
- * exposure to passwords, such as when one is grepping the file system
- * or looking at config files for trouble-shooting.
+ * Scrambles, but does not encrypt, text.
+ * <strong>Do not use this</strong> for storing passwords and the like in configuration.
+ * Use {@link Secret} instead.
  *
  * @author Kohsuke Kawaguchi
  * @see Protector