diff --git a/java/org/apache/catalina/servlets/DataSourcePropertyStore.java b/java/org/apache/catalina/servlets/DataSourcePropertyStore.java
index 9ea50e4d331b..4e5d497909a6 100644
--- a/java/org/apache/catalina/servlets/DataSourcePropertyStore.java
+++ b/java/org/apache/catalina/servlets/DataSourcePropertyStore.java
@@ -42,12 +42,23 @@
 /**
  * WebDAV dead properties storage using a DataSource.
  * <p>
- * The schema is:
- * table properties ( path, namespace, name, node )
- * path: the resource path
- * namespace: the node namespace
- * name: the local name in the namespace
- * node: the full serialized XML node including the name
+ * A single properties table with four columns is used:
+ * <ul>
+ * <li>path: the resource path</li>
+ * <li>namespace: the node namespace</li>
+ * <li>name: the local name in the namespace</li>
+ * <li>node: the full serialized XML node including the name</li>
+ * </ul>
+ * The table name used can be configured using the <code>tableName</code> property of the store.
+ * <p>
+ * Example table schema:
+ * <code>CREATE TABLE properties (
+ *    path         VARCHAR(1024) NOT NULL,
+ *    namespace    VARCHAR(64) NOT NULL,
+ *    name         VARCHAR(64) NOT NULL,
+ *    node         VARCHAR(2048) NOT NULL,
+ *    PRIMARY KEY (path, namespace, name)
+ * )</code>
  */
 public class DataSourcePropertyStore implements WebdavServlet.PropertyStore {
 
diff --git a/java/org/apache/catalina/servlets/WebdavServlet.java b/java/org/apache/catalina/servlets/WebdavServlet.java
index e97410f1f591..98737e03299f 100644
--- a/java/org/apache/catalina/servlets/WebdavServlet.java
+++ b/java/org/apache/catalina/servlets/WebdavServlet.java
@@ -95,7 +95,7 @@
  *    &lt;/init-param&gt;
  *    &lt;init-param&gt;
  *      &lt;param-name&gt;listings&lt;/param-name&gt;
- *      &lt;param-value&gt;false&lt;/param-value&gt;
+ *      &lt;param-value&gt;true&lt;/param-value&gt;
  *    &lt;/init-param&gt;
  *  &lt;/servlet&gt;
  *  &lt;servlet-mapping&gt;
@@ -104,7 +104,7 @@
  *  &lt;/servlet-mapping&gt;
  * </pre>
  *
- * This will enable read only access. To enable read-write access add:
+ * This will enable read only access with folder listings enabled. To enable read-write access add:
  *
  * <pre>
  *  &lt;init-param&gt;
@@ -122,7 +122,7 @@
  *  &lt;/servlet-mapping&gt;
  * </pre>
  *
- * By default access to /WEB-INF and META-INF are not available via WebDAV. To enable access to these URLs, use add:
+ * By default access to /WEB-INF and META-INF are not available via WebDAV. To enable access to these URLs, add:
  *
  * <pre>
  *  &lt;init-param&gt;
@@ -142,7 +142,7 @@
  * interface and configuring the Servlet to use that store. The <code>propertyStore</code> init-param allows configuring
  * the classname of the store to use, while the parameters in the form of <code>store.xxx</code> will be set on the
  * store object as bean properties. For example, this would configure a store with class
- * <code>com.MyPropertyStore</code>, and set its field <code>myName</code> to value <code>myValue</code>:
+ * <code>com.MyPropertyStore</code>, and set its property <code>myName</code> to value <code>myValue</code>:
  *
  * <pre>
  *  &lt;init-param&gt;