From 7edd55554a03d7cdaefd12e4a319a0059414fb99 Mon Sep 17 00:00:00 2001
From: Stephen Colebourne <scolebourne@apache.org>
Date: Sat, 26 Jul 2003 10:32:17 +0000
Subject: [PATCH] Fix Javadoc troubles from Phil Steitz

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@137506 13f79535-47bb-0310-9956-ffa450edef68
---
 .../commons/lang/RandomStringUtils.java       | 19 ++++++++++---------
 .../commons/lang/StringEscapeUtils.java       |  4 ++--
 2 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/src/java/org/apache/commons/lang/RandomStringUtils.java b/src/java/org/apache/commons/lang/RandomStringUtils.java
index 01c2b2bd3..85a3c2fb0 100644
--- a/src/java/org/apache/commons/lang/RandomStringUtils.java
+++ b/src/java/org/apache/commons/lang/RandomStringUtils.java
@@ -64,7 +64,7 @@
  * @author <a href="mailto:ggregory@seagullsw.com">Gary Gregory</a>
  * @author Phil Steitz
  * @since 1.0
- * @version $Id: RandomStringUtils.java,v 1.18 2003/07/26 00:26:32 ggregory Exp $
+ * @version $Id: RandomStringUtils.java,v 1.19 2003/07/26 10:32:17 scolebourne Exp $
  */
 public class RandomStringUtils {
 
@@ -200,7 +200,7 @@ public static String random(int count, int start, int end, boolean letters, bool
      * <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 @@ public static String random(int count, int start, int end, boolean letters, bool
      * <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
diff --git a/src/java/org/apache/commons/lang/StringEscapeUtils.java b/src/java/org/apache/commons/lang/StringEscapeUtils.java
index 00b1199d7..202293811 100644
--- a/src/java/org/apache/commons/lang/StringEscapeUtils.java
+++ b/src/java/org/apache/commons/lang/StringEscapeUtils.java
@@ -71,8 +71,9 @@
  * @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: StringEscapeUtils.java,v 1.19 2003/07/25 23:06:58 scolebourne Exp $
+ * @version $Id: StringEscapeUtils.java,v 1.20 2003/07/26 10:32:17 scolebourne Exp $
  */
 public class StringEscapeUtils {
 
@@ -446,7 +447,6 @@ public static void unescapeJavaScript(Writer out, String str) throws IOException
      * @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>