Documentation

h2/src/docsrc/html/changelog.html

@@ -18,10 +18,13 @@ Change Log
 <h1>Change Log</h1>
 
 <h2>Next Version (unreleased)</h2>
-<ul><li>Page store: opening a large database was slow if it was not closed before.
-</li><li>Page store: new write and read counters in the meta data table. Use 
+<ul><li>New sorted insert optimization (see Performance / Database Performance Tuning).
+</li><li>Issue 116: The files h2*-sources.jar and h2*-javadoc.jar are
+    now in the Maven repository.
+</li><li>Page store: opening a large database was slow if it was not closed before.
+</li><li>Page store: new write and read counters in the meta data table. Use
     SELECT * FROM INFORMATION_SCHEMA.SETTINGS WHERE NAME IN(
-    'info.FILE_WRITE_TOTAL', 'info.FILE_WRITE', 'info.FILE_READ', 
+    'info.FILE_WRITE_TOTAL', 'info.FILE_WRITE', 'info.FILE_READ',
     'info.CACHE_MAX_SIZE', 'info.CACHE_SIZE')
 </li><li>The SQL syntax is documented using (railroad) diagrams.
     The diagrams are HTML.

h2/src/docsrc/html/performance.html

@@ -384,14 +384,14 @@ following profiling data (results vary):
 
 <h3>Keep Connections Open or Use a Connection Pool</h3>
 <p>
-If your application opens and closes connections a lot (for example, for each request), 
+If your application opens and closes connections a lot (for example, for each request),
 you should consider using a  <a href="tutorial.html#connection_pool">connection pool</a>.
 Opening a connection using <code>DriverManager.getConnection</code> is specially slow
 if the database is closed. By default the database is closed if the last connection is closed.
 </p><p>
-If you open and close connections a lot but don't want to use a connection pool, 
-consider keeping a 'sentinel' connection open for as long as the application runs, 
-or use delayed database closing. See also 
+If you open and close connections a lot but don't want to use a connection pool,
+consider keeping a 'sentinel' connection open for as long as the application runs,
+or use delayed database closing. See also
 <a href="features.html#closing_a_database">Closing a database</a>.
 </p>
 
@@ -529,6 +529,20 @@ Each data type has different storage and performance characteristics:
     to work with than <code>INTEGER</code> in most modes.
 </li></ul>
 
+<h3>Sorted Insert Optimization</h3>
+<p>
+To reduce disk space usage and speed up table creation, an
+optimization for sorted inserts is available. When used, b-tree pages
+are split at the insertion point. To use this optimization, add <code>SORTED</code>
+before the <code>SELECT</code> statement:
+</p>
+<pre>
+CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR) AS
+    SORTED SELECT X, SPACE(100) FROM SYSTEM_RANGE(1, 100);
+INSERT INTO TEST
+    SORTED SELECT X, SPACE(100) FROM SYSTEM_RANGE(101, 200);
+</pre>
+
 <h2 id="fast_import">Fast Database Import</h2>
 <p>
 To speed up large imports, consider using the following options temporarily:

h2/src/docsrc/html/roadmap.html

@@ -43,7 +43,6 @@ See also <a href="build.html#providing_patches">Providing Patches</a>.
 <h2>Priority 2</h2>
 <ul>
 <li>Improve test code coverage
-</li><li>Issue 116: Maven: deploy / upload h2..-sources.jar and javadocs as well.
 </li><li>Fulltext search: support streaming CLOB data.
 </li><li>Enable warning for 'Local variable declaration hides another field or variable'.
 </li><li>Test multi-threaded in-memory db access

h2/src/test/org/h2/test/TestAll.java

@@ -297,10 +297,12 @@ java org.h2.test.TestAll timer
 
 /*
 
-check if sources.jar is not in installer and zip, but in h2web
+-sources.jar
+check if sources.jar is not in installer and zip, but in maven
+
+google app engine
 
 documentation: rolling review at history.html
-toArray?
 
 mvcc merge problem
 
@@ -311,12 +313,8 @@ optimization for X IN(..) and OR:
 add more test cases, code coverage 100%
 document in optimizations.sql
 
-out of memory in tests: analyze heap dump
-
 -------------
 
-integrate the short documentation, but where?
-
 remove old TODO, move to roadmap
 
 kill a test:

h2/src/tools/org/h2/build/doc/dictionary.txt

@@ -617,4 +617,4 @@ scrambling distinguish official unofficial distinguishable overwrites lastval
 notranslate vince bonfanti alphabetically sysdummy sysibm activation
 deactivation concatenating reproducing black railroads railroad radius moz
 imageio argb bilinear rendering stroke interpolation flip diagrams draw
-delim overlap subselect bitwise
+delim overlap subselect bitwise dclassifier dgenerate