You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sc...@apache.org on 2003/07/26 12:32:18 UTC
cvs commit: jakarta-commons/lang/src/java/org/apache/commons/lang StringEscapeUtils.java RandomStringUtils.java
scolebourne 2003/07/26 03:32:18
Modified: lang/src/java/org/apache/commons/lang StringEscapeUtils.java
RandomStringUtils.java
Log:
Fix Javadoc troubles
from Phil Steitz
Revision Changes Path
1.20 +2 -2 jakarta-commons/lang/src/java/org/apache/commons/lang/StringEscapeUtils.java
Index: StringEscapeUtils.java
===================================================================
RCS file: /home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/StringEscapeUtils.java,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- StringEscapeUtils.java 25 Jul 2003 23:06:58 -0000 1.19
+++ StringEscapeUtils.java 26 Jul 2003 10:32:17 -0000 1.20
@@ -71,6 +71,7 @@
* @author Helge Tesgaard
* @author <a href="sean@boohai.com">Sean Brown</a>
* @author <a href="mailto:ggregory@seagullsw.com">Gary Gregory</a>
+ * @author Phil Steitz
* @since 2.0
* @version $Id$
*/
@@ -446,7 +447,6 @@
* @param str the <code>String</code> to escape, may be null
* @return a new escaped <code>String</code>, <code>null</code> if null string input
*
- * @see Entities
* @see #unescapeHtml(String)
* @see </br><a href="http://hotwired.lycos.com/webmonkey/reference/special_characters/">ISO Entities</a>
* @see </br><a href="http://www.w3.org/TR/REC-html32#latin1">HTML 3.2 Character Entities for ISO Latin-1</a>
1.19 +9 -8 jakarta-commons/lang/src/java/org/apache/commons/lang/RandomStringUtils.java
Index: RandomStringUtils.java
===================================================================
RCS file: /home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/RandomStringUtils.java,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- RandomStringUtils.java 26 Jul 2003 00:26:32 -0000 1.18
+++ RandomStringUtils.java 26 Jul 2003 10:32:17 -0000 1.19
@@ -200,7 +200,7 @@
* <p>This method has exactly the same semantics as
* {@link #random(int,int,int,boolean,boolean,char[],Random)}, but
* instead of using an externally supplied source of randomness, it uses
- * the internal static {@link Random} instance ({@link #RANDOM}).</p>
+ * the internal static {@link Random} instance.</p>
*
* @param count the length of random string to create
* @param start the position in set of chars to start at
@@ -221,19 +221,20 @@
* <p>Creates a random string based on a variety of options, using
* supplied source of randomness.</p>
*
- * <p>If start and end are both <code>0</code>, start and end are set
+ * <p>If start and end are both <code>0</code>, start and end are set
* to <code>' '</code> and <code>'z'</code>, the ASCII printable
* characters, will be used, unless letters and numbers are both
- * <code>false</code>, in which case, start and end are set to
+ * <code>false</code>, in which case, start and end are set to
* <code>0</code> and <code>Integer.MAX_VALUE</code>.
*
- * <p>If set is not <code>null</code>, characters between start and
+ * <p>If set is not <code>null</code>, characters between start and
* end are chosen.</p>
*
- * <p>As a source of randomness is used supplied {@link Random}
- * instance. This makes method behave predictively, and allows
- * usage of <code>RandomStringUtils</code> in situations that need
- * repetitive behaviour.</p>
+ * <p>This method accepts a user-supplied {@link Random}
+ * instance to use as a source of randomness. By seeding a single
+ * {@link Random} instance with a fixed seed and using it for each call,
+ * the same random sequence of strings can be generated repeatedly
+ * and predictably.</p>
*
* @param count the length of random string to create
* @param start the position in set of chars to start at
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org