Documentation.

h2/src/docsrc/html/faq.html

@@ -236,11 +236,6 @@ This will list the top stack traces. Then either analyze this yourself, or
 post those stack traces in the Google Group.
 </p>
 <p>
-To find out what the problem is, open the database in embedded mode using the H2 Console.
-This will print progress information. If you have many lines with 'Creating index' it is an indication that the
-database was not closed the last time.
-</p>
-<p>
 Other possible reasons are: the database is very big (many GB), or contains linked tables
 that are slow to open.
 </p>

h2/src/docsrc/html/features.html

@@ -202,9 +202,9 @@ encrypted using AES-128 and XTEA encryption algorithms
 <td class="compareY">Yes</td>
 <td class="compareY">Yes</td>
 </tr><tr>
-<td>Clustering</td>
+<td>Built-in Clustering / Replication</td>
+<td class="compareY">Yes</td>
 <td class="compareY">Yes</td>
-<td class="compareN">No</td>
 <td class="compareN">No</td>
 <td class="compareY">Yes</td>
 <td class="compareY">Yes</td>
@@ -351,21 +351,13 @@ encrypted using AES-128 and XTEA encryption algorithms
 *5 The default H2 jar file contains debug information, jar files for other databases do not.<br />
 *6 PostgreSQL supports functional indexes.<br />
 *7 Derby only supports updatable result sets if the query is not sorted.<br />
-*8 Derby and HSQLDB don't support standard compliant information schema tables.<br />
+*8 Derby doesn't support standard compliant information schema tables.<br />
 *9 When using MVCC (multi version concurrency).<br />
 *10 Derby and HSQLDB
     <a href="http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Electronic_codebook_.28ECB.29">don't hide hide data patterns well</a>.<br />
 *11 The MULTI_THREADED option is not enabled by default, and not yet supported when using MVCC.
 </p>
 
-<h3>Derby and HSQLDB</h3>
-<p>
-After an unexpected process termination (for example power failure), H2 can usually
-recover safely and automatically without any user interaction. For Derby and HSQLDB,
-some manual steps are required ('Another instance of Derby may have already booted the database' /
-'The database is already in use by another process').
-</p>
-
 <h3>DaffodilDb and One$Db</h3>
 <p>
 It looks like the development of this database has stopped. The last release was February 2006.
@@ -373,7 +365,7 @@ It looks like the development of this database has stopped. The last release was
 
 <h3>McKoi</h3>
 <p>
-It looks like the development of this database has stopped. The last release was August 2004
+It looks like the development of this database has stopped. The last release was August 2004.
 </p>
 
 <h2 id="products_work_with">H2 in Use</h2>

h2/src/docsrc/html/performance.html

@@ -93,7 +93,6 @@ For most operations, the performance of H2 is about the same as for HSQLDB.
 One situation where H2 is slow is large result sets, because they are buffered to
 disk if more than a certain number of records are returned.
 The advantage of buffering is: there is no limit on the result set size.
-The database open/close time is fixed.
 </p>
 
 <h4>HSQLDB</h4>
@@ -101,11 +100,6 @@ The database open/close time is fixed.
 Version 2.0.0 was used for the test.
 Cached tables are used in this test (<code>hsqldb.default_table_type=cached</code>),
 and the write delay is 1 second (<code>SET WRITE_DELAY 1</code>).
-Older versions of HSQLDB (pre 2.0) where very slow in the last test (BenchC: Transactions).
-</p>
-<p>
-A disadvantage of HSQLDB is the slow startup / shutdown time (currently not listed) when using bigger databases.
-The reason is, a backup of the whole data is made whenever the database is opened or closed.
 </p>
 
 <h4>Derby</h4>

h2/src/main/org/h2/tools/Csv.java

@@ -680,8 +680,28 @@ public class Csv implements SimpleRowSource {
     }
 
     /**
-     * Set the escape character (used to escape the field delimiter). The
-     * default is " (a double quote). The value 0 means no escape character is used.
+     * Set the escape character. The escape character is used to escape the
+     * field delimiter. This is needed if the data contains the field delimiter.
+     * The default escape character is " (a double quote), which is the same as
+     * the field delimiter. If the field delimiter and the escape character are
+     * both " (double quote), and the data contains a double quote, then an
+     * additional double quote is added. Example:
+     * <pre>
+     * Data: He said "Hello".
+     * Escape character: "
+     * Field delimiter: "
+     * CSV file: "He said ""Hello""."
+     * </pre>
+     * If the field delimiter is a double quote and the escape character is a backslash,
+     * then escaping is done similar to Java (however, only the field delimiter is escaped).
+     * Example:
+     * <pre>
+     * Data: He said "Hello".
+     * Escape character: \
+     * Field delimiter: "
+     * CSV file: "He said \"Hello\"."
+     * </pre>
+     * The value 0 means no escape character is used.
      *
      * @param escapeCharacter the escape character
      */