improve documentation

h2/src/docsrc/html/changelog.html

@@ -20,7 +20,7 @@ Change Log
 <h2>Next Version (unreleased)</h2>
 <ul><li>Connection pool: the default login timeout is now 5 minutes.
 </li><li>After truncating tables, opening large databases could become slow
-    because indexes are always re-built unnecessarily when opening.
+    because indexes were always re-built unnecessarily when opening.
 </li><li>More bugs in the server-less multi-connection mode have been fixed:
     Sometimes parameters of prepared statements were lost when a reconnecting.
     Concurrent read operations were slow.

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

@@ -295,8 +295,6 @@ java -Dfile.encoding=UTF-8
 
 auto-build: prepare release
 
-documentation: rolling review at grammar.html: SELECT
-documentation: rolling review at functions.html: start
 documentation: rolling review at roadmap.html: done
 
 checksum for downloads

h2/src/tools/org/h2/build/doc/GenerateDoc.java

@@ -141,12 +141,14 @@ public class GenerateDoc {
                 map.put("syntax", syntax);
 
                 // remove newlines in the regular text
-                // currently this looks bad (no paragraphs, no lists)
-                // String text = (String) map.get("text");
-                // if (text != null) {
-                //    text = StringUtils.replaceAll(text, "<br />", " ");
-                //    map.put("text", text);
-                // }
+                String text = (String) map.get("text");
+                if (text != null) {
+                    text = text.trim();
+                    // text is enclosed in <p> .. </p> so this works.
+                    text = StringUtils.replaceAll(text, "<br /><br />", "</p><p>");
+                    text = StringUtils.replaceAll(text, "<br />", " ");
+                    map.put("text", text);
+                }
 
                 String link = topic.toLowerCase();
                 link = StringUtils.replaceAll(link, " ", "");