TEXT-62: Minor tweeks

Project: http://git-wip-us.apache.org/repos/asf/commons-text/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-text/commit/5faf6e15
Tree: http://git-wip-us.apache.org/repos/asf/commons-text/tree/5faf6e15
Diff: http://git-wip-us.apache.org/repos/asf/commons-text/diff/5faf6e15

Branch: refs/heads/release
Commit: 5faf6e15f3d489e363aa867ea7e75e2effd10439
Parents: 9fa1158
Author: Rob Tompkins <chtom...@gmail.com>
Authored: Mon Jan 30 07:49:30 2017 -0500
Committer: Rob Tompkins <chtom...@gmail.com>
Committed: Mon Jan 30 07:49:30 2017 -0500

 src/site/site.xml           |  1 +
 src/site/xdoc/userguide.xml | 29 +++++++++++++----------------
 2 files changed, 14 insertions(+), 16 deletions(-)

diff --git a/src/site/site.xml b/src/site/site.xml
index 35c303f..747c67b 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -26,6 +26,7 @@
         <menu name="Text">
             <item name="Overview"                 href="/index.html"/>
             <item name="Download"                 
+            <item name="User guide"               href="/userguide.html" />
             <item name="Release History"          
             <item name="Javadoc (Latest release)" 

diff --git a/src/site/xdoc/userguide.xml b/src/site/xdoc/userguide.xml
index 9432fb6..b18fdd8 100644
--- a/src/site/xdoc/userguide.xml
+++ b/src/site/xdoc/userguide.xml
@@ -42,17 +42,9 @@ limitations under the License.
     <section name="Description">
       <p>The Commons Text library provides additions to the standard JDK's
-        java.lang package. Very generic, very reusable components for everyday
-        use.
-      </p>
-      <p>The text package was added in Commons Lang 2.2. It provides, amongst
-        other classes, a replacement for StringBuffer named <code>
-          StrBuilder</code>, a class for substituting variables within a String
-        named <code>StrSubstitutor</code> and a replacement for StringTokenizer
-        named <code>StrTokenizer</code>. While somewhat ungainly, the <code>
-          Str
-        </code> prefix has been used to ensure we don't clash with any current
-        or future standard Java classes.
+        text handling. Our goal is to provide a consistent set of tools for
+        processing text generally from computing distances between Strings
+        to being able to effeciently do String escaping of various types.
@@ -88,15 +80,20 @@ limitations under the License.
       <subsection name="Similarity and Distance">
-        <p>The <code>similarity</code> packages contains various different 
mechanisms of
+        <p>The <code>org.apache.commons.text.beta.similarity</code> packages 
contains various different mechanisms of
           calculating "similarity scores" as well as "edit distances between 
Strings. Note,
           the difference between a "similarity score" and a "distance 
function" is that
           a distance functions meets the following qualifications:
-            <li><code>d(x,y) &gt;= 0</code>, non-negativity or separation 
-            <li><code>d(x,y) == 0</code>, if and only if, <code>x == 
-            <li><code>d(x,y) == d(y,x)</code>, symmetry, and</li>
-            <li><code>d(x,z) &lt;=  d(x,y) + d(y,z)</code>, the triangle 
+            <li><code>d(x,y) &gt;= 0</code>, non-negativity or separation axiom
+            </li>
+            <li><code>d(x,y) == 0</code>, if and only if,
+              <code>x == y</code>
+            </li>
+            <li><code>d(x,y) == d(y,x)</code>, symmetry, and
+            </li>
+            <li><code>d(x,z) &lt;= d(x,y) + d(y,z)</code>, the triangle 
+            </li>
           whereas a "similarity score" need not satisfy all such properties. 
Though, it
           is fairly easy to "normalize" a similarity score to manufacture an 
"edit distance."

Reply via email to