Improve javadoc

Document WebDAV with listings since otherwise it won't really work.
Add the test schema for the database since it's a working example.

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 {
 

java/org/apache/catalina/servlets/WebdavServlet.java

@@ -95,7 +95,7 @@
  *    </init-param>
  *    <init-param>
  *      <param-name>listings</param-name>
- *      <param-value>false</param-value>
+ *      <param-value>true</param-value>
  *    </init-param>
  *  </servlet>
  *  <servlet-mapping>
@@ -104,7 +104,7 @@
  *  </servlet-mapping>
  * </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;