This is an automated email from the ASF dual-hosted git repository.
erans pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-lang.git
The following commit(s) were added to refs/heads/master by this push:
new cf80937 LANG-1442: Javadoc.
cf80937 is described below
commit cf8093776b5746b82d946b47c682ddfc059b89b0
Author: Gilles Sadowski <[email protected]>
AuthorDate: Mon Apr 8 15:22:17 2019 +0200
LANG-1442: Javadoc.
https://markmail.org/message/mbp35qav34ifjm4t
---
.../java/org/apache/commons/lang3/RandomStringUtils.java | 13 ++++++-------
src/main/java/org/apache/commons/lang3/RandomUtils.java | 13 ++++++-------
2 files changed, 12 insertions(+), 14 deletions(-)
diff --git a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
index e0472c9..3e82c5b 100644
--- a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
+++ b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
@@ -33,14 +33,13 @@ import java.util.Random;
* <a
href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/RandomStringGenerator.html";>
* RandomStringGenerator</a> instead.</p>
*
- * <p><em>Note.</em> This class relies on an instance of {@link Random}, and
instances
- * of {@link Random} are not cryptographically secure. Consider instead using
a more
- * cryptographically secure pseudo-random number generator, for which we have
no utility class.</p>
+ * <p>Caveat: Instances of {@link Random} are not cryptographically secure.</p>
*
- * <p>We would like to further note to users that the Apache Commons Project
has
- * a component entirely dedicated to random number generation, namely
- * <a href="http://commons.apache.org/rng";>Commons RNG</a>. For a more
extensive
- * treatment of random numbers, we suggest that the user explore this
library.</p>
+ * <p>Please note that the Apache Commons project provides a component
+ * dedicated to pseudo-random number generation, namely
+ * <a href="https://commons.apache.org/rng";>Commons RNG</a>, that may be
+ * a better choice for applications with more stringent requirements
+ * (performance and/or correctness).</p>
*
* <p>#ThreadSafe#</p>
* @since 1.0
diff --git a/src/main/java/org/apache/commons/lang3/RandomUtils.java
b/src/main/java/org/apache/commons/lang3/RandomUtils.java
index 4d37b9e..c8d4bdc 100644
--- a/src/main/java/org/apache/commons/lang3/RandomUtils.java
+++ b/src/main/java/org/apache/commons/lang3/RandomUtils.java
@@ -21,14 +21,13 @@ import java.util.Random;
/**
* <p>Utility library that supplements the standard {@link Random} class.</p>
*
- * <p><em>Note.</em> Instances of {@link Random} are not cryptographically
- * secure. Consider instead using a more cryptographically secure pseudo-random
- * number generator, for which we have no utility class.</p>
+ * <p>Caveat: Instances of {@link Random} are not cryptographically secure.</p>
*
- * <p>We would like to further note to users that the Apache Commons Project
has
- * a component entirely dedicated to random number generation, namely
- * <a href="http://commons.apache.org/rng";>Commons RNG</a>. For a more
extensive
- * treatment of random numbers, we suggest that the user explore this
library.</p>
+ * <p>Please note that the Apache Commons project provides a component
+ * dedicated to pseudo-random number generation, namely
+ * <a href="https://commons.apache.org/rng";>Commons RNG</a>, that may be
+ * a better choice for applications with more stringent requirements
+ * (performance and/or correctness).</p>
*
* @since 3.3
*/
