Somebody get me a bucket.

I overdocumented.

lib/python/Products/ZCatalog/README.txt

-ZCatalog
-
-
-  This is the ZCatalog product for the Z Object Publishing 
-  Environment.
-
-  ****** IMPORTANT ******
-
-  This product contains no binaries, and should install
-  identically on all platforms.
-
-  Installation
-
-    o Extract the distribution file into the top-level 
-      directory of your Zope installation.
-
-    o Restart your Zope installation.
-
+ZCatalog
+
+  Notes for Zope 2.0
+
+    Catalog now comes with the Zope core, there is no need to install it.
+
+  This is the ZCatalog product for the Z Object Publishing 
+  Environment.
+
+  ****** IMPORTANT ******
+
+  This product contains no binaries, and should install
+  identically on all platforms.
+
+  Installation
+
+    o Extract the distribution file into the top-level 
+      directory of your Zope installation.
+
+    o Restart your Zope installation.
+

lib/python/Products/ZCatalog/ZCatalog.py

@@ -469,3 +469,4 @@ Globals.default__class_init__(ZCatalog)
 
 
 
+

lib/python/Products/ZCatalog/catalogIndexes.dtml

@@ -8,11 +8,21 @@
 <p> This list defines what indexes the Catalog will contain.  When
 objects get cataloged, the values of any attributes they may have
 which match an index in this list will get indexed.  Indexes come in
-two flavors, TextIndexes and FieldIndexes.  TextIndexes break text up
-into individual words, and are often refered to as 'full text
-indexes'.  Field indexes treat the value of an objects attribute
-atomically, and can be used, for example, to track only a certain
-subset of object values, such as 'meta_type'.</p>
+three flavors, Text Indexes, Field Indexes and Keyword Indexes.</p>
+
+<p><b>Text Indexes</b> break text up into individual words, and are
+often refered to as <b>full-text indexes</b>.  Text indexes sort results by
+<b>score</b> meaning they return 'hits' in order from the most
+relevant to the lest relevant.</p>
+
+<p><b>Field Indexes</b> treat the value of an objects attribute atomically,
+and can be used, for example, to track only a certain subset of object
+values, such as 'meta_type'.</p>
+
+<p><b>Keyword Indexes</b> index a sequence of objects that act as
+'keywords' for an object.  A Keyword Index will return any objects
+that have one or more keywords specified in a search query.</p>
+
 
 <form action="<!--#var URL1-->">
 

lib/python/Products/ZCatalog/catalogStatus.dtml

@@ -18,35 +18,38 @@
       <b>threshold</b> below.</p>
 
     <p> If you are using ZCatalog and ZSQL Methods in the same
-    transaction, you <b>must</b> disable subtransactions, they are not
-    compatible with ZSQL Methods.</p>
+      transaction, you <b>must</b> disable subtransactions, they are not
+      compatible with ZSQL Methods.</p>
 
-    <h3>Subtransactions are <font color="red">
+    <h3>Subtransactions are 
       <dtml-if threshold>
-	<b>Enabled</b>
+	<font color="green"><b>Enabled</b></font>
       <dtml-else>
-	<b>Disabled</b>
-      </dtml-if></h3><br></font>
+	<font color="red"><b>Disabled</b></font>
+      </dtml-if></h3>
 
     <form action="." method=POST>
       <dtml-if threshold>
-	<input type=submit name="manage_subbingToggle:method" value="Disable">
+	<input type=submit name="manage_subbingToggle:method"
+	value="Disable"> Subtransactions
       <dtml-else>
-	<input type=submit name="manage_subbingToggle:method" value="Enable">
+	<input type=submit name="manage_subbingToggle:method"
+	value="Enable"> Subtransactions
       </dtml-if>
     </form>
 
     <form action="manage_edit" method=POST>
     <dtml-if threshold>
-    <p>The Subtransaction threshold is the number of words the catalog
-      will index before it commits a subtransaction.  If this number is low,
-      the Catalog will take much to index but consume much less memory.  If
-      this number is higher, the Catalog will index quickly but consume much
-      more memory.</p> 
 
+    <p>The Subtransaction threshold is the number of words the catalog
+      will index before it commits a subtransaction.  If this number
+      is low, the Catalog will take longer to index but consume less
+      memory.  If this number is higher, the Catalog will index
+      quickly but consume much more memory.</p>
 
       Subtransaction threshold: <input name="threshold:int" value="<!--#var
-	threshold html_quote-->"><br> <input type=submit value=" Change ">
+      threshold html_quote-->"><br> <input type=submit value=" Change ">
+
     </dtml-if>
     </form>