--no commit message

--no commit message

h2/src/main/org/h2/command/Parser.java

@@ -832,8 +832,18 @@ public class Parser {
         String alias = null;
         Schema mainSchema = database.getSchema(Constants.SCHEMA_MAIN);
         if (readIf("(")) {
-            if (isToken("SELECT") || isToken("FROM") || isToken("(")) {
-                Query query = parseSelect();
+            if (isToken("SELECT") || isToken("FROM")) {
+                int start = lastParseIndex;
+                int paramIndex = parameters.size();
+                Query query = parseSelectUnion();
+                read(")");
+                query = parseSelectUnionExtension(query, start);
+                ObjectArray params = new ObjectArray();
+                for (int i = paramIndex; i < parameters.size(); i++) {
+                    params.add(parameters.get(i));
+                }
+                query.setParameterList(params);
+                query.init();
                 Session s;
                 if (prepared != null && prepared instanceof CreateView) {
                     s = database.getSystemSession();
@@ -842,11 +852,14 @@ public class Parser {
                 }
                 table = TableView.createTempView(s, session.getUser(), query);
                 alias = table.getName();
-                read(")");
             } else {
                 TableFilter top = readTableFilter(fromOuter);
                 top = readJoin(top, currentSelect, fromOuter);
                 read(")");
+                alias = readFromAlias(null);
+                if (alias != null) {
+                    top.setAlias(alias);
+                }
                 return top;
             }
         } else {
@@ -871,6 +884,11 @@ public class Parser {
                 table = readTableOrView(tableName);
             }
         }
+        alias = readFromAlias(alias);
+        return new TableFilter(session, table, alias, rightsChecked, currentSelect);
+    }
+
+    String readFromAlias(String alias) throws SQLException {
         if (readIf("AS")) {
             alias = readAliasIdentifier();
         } else if (currentTokenType == IDENTIFIER) {
@@ -880,7 +898,7 @@ public class Parser {
                 alias = readAliasIdentifier();
             }
         }
-        return new TableFilter(session, table, alias, rightsChecked, currentSelect);
+        return alias;
     }
 
     private Prepared parseTruncate() throws SQLException {
@@ -1228,6 +1246,10 @@ public class Parser {
     private Query parseSelectUnion() throws SQLException {
         int start = lastParseIndex;
         Query command = parseSelectSub();
+        return parseSelectUnionExtension(command, start);
+    }
+
+    private Query parseSelectUnionExtension(Query command, int start) throws SQLException {
         while (true) {
             if (readIf("UNION")) {
                 SelectUnion union = new SelectUnion(session, command);

h2/src/main/org/h2/command/dml/Query.java

@@ -84,7 +84,7 @@ public abstract class Query extends Prepared {
         return params;
     }
 
-    public final LocalResult query(int limit) throws SQLException {
+    public LocalResult query(int limit) throws SQLException {
         if (!session.getDatabase().getOptimizeReuseResults()) {
             return queryWithoutCache(limit);
         }
@@ -246,10 +246,17 @@ public abstract class Query extends Prepared {
     public abstract int getColumnCount();
     public abstract void mapColumns(ColumnResolver resolver, int level) throws SQLException;
     public abstract void setEvaluatable(TableFilter tableFilter, boolean b);
-    public abstract void addGlobalCondition(Expression expr, int columnId, int comparisonType) throws SQLException;
+    public abstract void addGlobalCondition(Parameter param, int columnId, int comparisonType) throws SQLException;
     public abstract void setDistinct(boolean b);
     public abstract String getFirstColumnAlias(Session session);
 
+    void addParameter(Parameter param) {
+        if (parameters == null) {
+            parameters = new ObjectArray();
+        }
+        parameters.add(param);
+    }
+
     public void setSampleSize(int sampleSize) {
         this.sampleSize = sampleSize;
     }

h2/src/main/org/h2/command/dml/Select.java

@@ -16,6 +16,7 @@ import org.h2.expression.ConditionAndOr;
 import org.h2.expression.Expression;
 import org.h2.expression.ExpressionColumn;
 import org.h2.expression.ExpressionVisitor;
+import org.h2.expression.Parameter;
 import org.h2.expression.Wildcard;
 import org.h2.index.Index;
 import org.h2.message.Message;
@@ -702,10 +703,11 @@ public class Select extends Query {
         return isQuickQuery;
     }
 
-    public void addGlobalCondition(Expression expr, int columnId, int comparisonType) throws SQLException {
+    public void addGlobalCondition(Parameter param, int columnId, int comparisonType) throws SQLException {
+        addParameter(param);
         Expression col = (Expression) expressions.get(columnId);
         col = col.getNonAliasExpression();
-        Expression comp = new Comparison(session, comparisonType, col, expr);
+        Expression comp = new Comparison(session, comparisonType, col, param);
         comp = comp.optimize(session);
         boolean addToCondition = true;
         if (isGroupQuery) {

h2/src/main/org/h2/command/dml/SelectUnion.java

@@ -13,6 +13,7 @@ import org.h2.engine.Session;
 import org.h2.expression.Expression;
 import org.h2.expression.ExpressionColumn;
 import org.h2.expression.ExpressionVisitor;
+import org.h2.expression.Parameter;
 import org.h2.expression.ValueExpression;
 import org.h2.jdbc.JdbcSQLException;
 import org.h2.message.Message;
@@ -252,17 +253,18 @@ public class SelectUnion extends Query {
         right.setEvaluatable(tableFilter, b);
     }
 
-    public void addGlobalCondition(Expression expr, int columnId, int comparisonType) throws SQLException {
+    public void addGlobalCondition(Parameter param, int columnId, int comparisonType) throws SQLException {
+        addParameter(param);
         switch (unionType) {
         case UNION_ALL:
         case UNION:
         case INTERSECT: {
-            left.addGlobalCondition(expr, columnId, comparisonType);
-            right.addGlobalCondition(expr, columnId, comparisonType);
+            left.addGlobalCondition(param, columnId, comparisonType);
+            right.addGlobalCondition(param, columnId, comparisonType);
             break;
         }
         case EXCEPT: {
-            left.addGlobalCondition(expr, columnId, comparisonType);
+            left.addGlobalCondition(param, columnId, comparisonType);
             break;
         }
         default:
@@ -316,6 +318,11 @@ public class SelectUnion extends Query {
         return buff.toString();
     }
 
+    public LocalResult query(int limit) throws SQLException {
+        // union doesn't always know the parameter list of the left and right queries
+        return queryWithoutCache(limit);
+    }
+
     public boolean isEverything(ExpressionVisitor visitor) {
         return left.isEverything(visitor) && right.isEverything(visitor);
     }

h2/src/main/org/h2/engine/Database.java

@@ -448,14 +448,14 @@ public class Database implements DataHandler {
             fileData.init();
             try {
                 fileIndex.init();
-            } catch (SQLException e) {
+            } catch (Throwable e) {
                 if (recovery) {
                     traceSystem.getTrace(Trace.DATABASE).error("opening index", e);
                     fileIndex.close();
                     fileIndex.delete();
                     openFileIndex();
                 } else {
-                    throw e;
+                    throw Message.convert(e);
                 }
             }
             reserveLobFileObjectIds();

h2/src/main/org/h2/index/ViewIndex.java

@@ -108,16 +108,17 @@ public class ViewIndex extends BaseIndex {
                 Column col = table.getColumn(idx);
                 columns[i] = col;
                 int mask = masks[idx];
+                int nextParamIndex = query.getParameters().size();
                 if ((mask & IndexCondition.EQUALITY) != 0) {
-                    Parameter param = new Parameter(0);
+                    Parameter param = new Parameter(nextParamIndex);
                     query.addGlobalCondition(param, idx, Comparison.EQUAL);
                 } else {
                     if ((mask & IndexCondition.START) != 0) {
-                        Parameter param = new Parameter(0);
+                        Parameter param = new Parameter(nextParamIndex);
                         query.addGlobalCondition(param, idx, Comparison.BIGGER_EQUAL);
                     }
                     if ((mask & IndexCondition.END) != 0) {
-                        Parameter param = new Parameter(0);
+                        Parameter param = new Parameter(nextParamIndex);
                         query.addGlobalCondition(param, idx, Comparison.SMALLER_EQUAL);
                     }
                 }

h2/src/main/org/h2/res/help.csv

@@ -113,7 +113,8 @@ If no file name is specified, the script is returned as a result set.
 This command can be used to create a backup of the database.
 If the DROP option is specified, drop statements are created for tables, views, and sequences.
 If the block size is set, CLOB and BLOB values larger than this size are split into separate blocks.
-If a file name is specified, a result set without insert statements is returned.
+If a file name is specified, then the whole script (including insert statements) is written to this file,
+and a result set without the insert statements is returned.
 When using encryption, only DEFLATE and LZF are supported.
 The password must be in single quotes. It is case sensitive and can contain spaces.
 ","

h2/src/main/org/h2/table/TableFilter.java

@@ -32,8 +32,8 @@ import org.h2.value.Value;
 public class TableFilter implements ColumnResolver {
     private static final int BEFORE_FIRST = 0, FOUND = 1, AFTER_LAST = 2, NULL_ROW = 3;
     private final Table table;
-    private final String alias;
     private final Select select;
+    private String alias;
     private Session session;
     private Index index;
     private IndexColumn[] indexColumns;
@@ -567,4 +567,8 @@ public class TableFilter implements ColumnResolver {
         return this;
     }
 
+    public void setAlias(String alias) {
+        this.alias = alias;
+    }
+
 }

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

@@ -154,18 +154,13 @@ java org.h2.test.TestAll timer
 
 /*
 
+add link to:
+www.s-appsys.com
+
 documentation: package.html
 
 write to the db file what version was used to create a database
 
-History:
-CSV tool: the character # could not be used as a separator when reading.
-CSV tool: some escape/separator character combinations did not work. Fixed.
-
-Roadmap:
-remove
-* Stop the server: close all open databases first
-
 
 
 Web site:

h2/src/test/org/h2/test/bench/Bench.java

@@ -4,10 +4,29 @@
  */
 package org.h2.test.bench;
 
+/**
+ * The interface for benchmark tests.
+ */
 public interface Bench {
 
+    /**
+     * Initialize the database. This includes creating tables and inserting data.
+     *
+     * @param db the database object
+     * @param size the amount of data
+     */
     void init(Database db, int size) throws Exception;
+
+    /**
+     * Run the test.
+     */
     void runTest() throws Exception;
+
+    /**
+     * Get the name of the test.
+     *
+     * @return the test name
+     */
     String getName();
 
 }

h2/src/test/org/h2/test/bench/BenchA.java

@@ -9,6 +9,9 @@ import java.sql.PreparedStatement;
 import java.util.Random;
 
 /**
+ * This test is similar to the TPC-A test of the Transaction Processing Council (TPC).
+ * However, only one connection and one thread is used.
+ *<p>
  * See also: http://www.tpc.org/tpca/spec/tpca_current.pdf
  */
 public class BenchA implements Bench {

h2/src/test/org/h2/test/bench/BenchB.java

@@ -11,8 +11,11 @@ import java.sql.SQLException;
 import java.util.Random;
 
 /**
- * See also http://www.tpc.org/tpcb
+ * This test is similar to the TPC-B test of the Transaction Processing Council (TPC).
+ * Multiple threads are used (one thread per connection).
  * Referential integrity is not implemented.
+ *<p>
+ * See also http://www.tpc.org/tpcb
  */
 public class BenchB implements Bench, Runnable {
 

h2/src/test/org/h2/test/bench/BenchC.java

@@ -9,6 +9,13 @@ import java.sql.PreparedStatement;
 import java.sql.Timestamp;
 import java.sql.Types;
 
+/**
+ * This test is similar to the TPC-C test of the Transaction Processing Council (TPC).
+ * Only one connection and one thread is used.
+ * Referential integrity is not implemented.
+ *<p>
+ * See also http://www.tpc.org
+ */
 public class BenchC implements Bench {
 
     private Database db;

h2/src/test/org/h2/test/bench/BenchCRandom.java

@@ -8,6 +8,9 @@ import java.math.BigDecimal;
 import java.math.BigInteger;
 import java.util.Random;
 
+/**
+ * The random data generator used for BenchC.
+ */
 public class BenchCRandom {
 
     private Random random = new Random(10);

h2/src/test/org/h2/test/bench/BenchCThread.java

@@ -10,6 +10,9 @@ import java.sql.ResultSet;
 import java.sql.Timestamp;
 import java.util.HashMap;
 
+/**
+ * This class implements the functionality of one thread of BenchC.
+ */
 public class BenchCThread {
 
     private Database db;

h2/src/test/org/h2/test/bench/BenchSimple.java

@@ -7,6 +7,11 @@ package org.h2.test.bench;
 import java.sql.PreparedStatement;
 import java.util.Random;
 
+/**
+ * This is a very simple benchmark application. One table is created
+ * where rows are inserted, updated, selected (in sequential and random order),
+ * and then deleted.
+ */
 public class BenchSimple implements Bench {
 
     Database db;

h2/src/test/org/h2/test/bench/Database.java

@@ -23,6 +23,9 @@ import org.h2.tools.Server;
 import org.h2.util.JdbcUtils;
 import org.h2.util.StringUtils;
 
+/**
+ * Represents a database in the benchmark test application.
+ */
 class Database {
 
     private TestPerformance test;

h2/src/test/org/h2/test/bench/TestPerformance.java

@@ -18,6 +18,10 @@ import org.h2.test.TestBase;
 import org.h2.util.IOUtils;
 import org.h2.util.JdbcUtils;
 
+/**
+ * The main controller class of the benchmark application.
+ * To run the benchmark, call the main method of this class.
+ */
 public class TestPerformance {
 
     boolean collect;

h2/src/test/org/h2/test/db/TestScriptSimple.java

@@ -9,6 +9,7 @@ import java.io.InputStreamReader;
 import java.io.LineNumberReader;
 import java.sql.Connection;
 import java.sql.ResultSet;
+import java.sql.SQLException;
 
 import org.h2.test.TestBase;
 import org.h2.util.ScriptReader;
@@ -33,6 +34,7 @@ public class TestScriptSimple extends TestBase {
                 break;
             }
             sql = sql.trim();
+            try {
                 if ("@reconnect".equals(sql.toLowerCase())) {
                     reconnect();
                 } else if (sql.length() == 0) {
@@ -47,6 +49,10 @@ public class TestScriptSimple extends TestBase {
                 } else {
                     conn.createStatement().execute(sql);
                 }
+            } catch (SQLException e) {
+                System.out.println(sql);
+                throw e;
+            }
         }
         is.close();
         conn.close();

h2/src/test/org/h2/test/otherDatabases.txt

@@ -12,5 +12,14 @@ insert into test values(null);
 -- 2 rows even in ANSI mode (correct is 1 row):
 select * from test where id=id and 1=1;
 
+MS SQL Server 2005
+--------------------------------------------------------------------------------------------------------
+Problems when trying to select large objects (even if ResultSet.getBinaryStream is used).
+The workaround responseBuffering=adaptive doesn't always seem to work
+(jdbc:sqlserver://localhost:4220;DatabaseName=test;responseBuffering=adaptive)
+
 PostgreSQL
 --------------------------------------------------------------------------------------------------------
+
+
+

h2/src/test/org/h2/test/poweroff/Listener.java

@@ -9,6 +9,10 @@ import java.io.IOException;
 import java.net.ServerSocket;
 import java.net.Socket;
 
+/**
+ * The listener application for the power off test.
+ * The listener runs on a computer that stays on during the whole test.
+ */
 public class Listener implements Runnable {
 
     public static void main(String[] args) throws Exception {

h2/src/test/org/h2/test/poweroff/Test.java

@@ -18,6 +18,12 @@ import java.sql.Statement;
 
 import org.h2.util.FileUtils;
 
+/**
+ * This application tests the durability / non-durability of file systems and databases.
+ * Two computers with network connection are required to run this test. Before
+ * starting this application, the Listener application must be started on another
+ * computer.
+ */
 public class Test {
 
     String driver;

h2/src/test/org/h2/test/poweroff/TestRecover.java

@@ -29,6 +29,9 @@ import java.util.zip.ZipOutputStream;
 
 import org.h2.util.IOUtils;
 
+/**
+ * This standalone test checks if recovery of a database works after power failure.
+ */
 public class TestRecover {
 
     private Random random;

h2/src/test/org/h2/test/poweroff/TestWrite.java

@@ -13,6 +13,10 @@ import java.sql.PreparedStatement;
 import java.sql.SQLException;
 import java.sql.Statement;
 
+/**
+ * This test shows the raw file access performance using various file modes.
+ * It also tests databases.
+ */
 public class TestWrite {
     public static void main(String[] args) throws Exception {
         testFile("rw", false);

h2/src/test/org/h2/test/test.in.txt

 --- special grammar and test cases ---------------------------------------------------------------------------------------------
+select * from system_range(1, 2) a,
+(select * from system_range(1, 2) union select * from system_range(1, 2)
+union select * from system_range(1, 1)) v where a.x = v.x;
+> X X
+> - -
+> 1 1
+> 2 2
+> rows: 2
+
+create table test(id int);
+> ok
+
+select * from ((select * from test) union (select * from test)) where id = 0;
+> ID
+> --
+> rows: 0
+
+select * from ((test d1 inner join test d2 on d1.id = d2.id) inner join test d3 on d1.id = d3.id) inner join test d4 on d4.id = d1.id;
+> ID ID ID ID
+> -- -- -- --
+> rows: 0
+
 select * from dual a left join dual b on b.x=(select max(x) from dual);
 > exception
 
+drop table test;
+> ok
+
 select count(*) from system_range(1, 2) where x in(1, 1, 1);
 > COUNT(*)
 > --------

h2/src/test/org/h2/test/testSimple.in.txt

+create table test(id int);
+select count(*) from (select * from ((select * from test) union (select * from test)) a) b where id = 0;
+> 0;
+select count(*) from (select * from ((select * from test) union select * from test) a) b where id = 0;
+> 0;
+select count(*) from (select * from (select * from test union select * from test) a) b where id = 0;
+> 0;
+select 1 from ((test d1 inner join test d2 on d1.id = d2.id) inner join test d3 on d1.id = d3.id) inner join test d4 on d4.id = d1.id;
+drop table test;
+
 select lpad('string', 10, '+');
 > ++++string;
 select rpad('string', 10, '+');

h2/src/test/org/h2/test/todo/supportTemplates.txt

@@ -24,7 +24,7 @@ Please provide any additional information below.
 
 Corrupted database
 
-I am sorry to say that, but it looks like a corruption problem. I am very interested in analyzing and solving this problem. It has top priority for me. I have a few question:
+I am sorry to say that, but it looks like a corruption problem. I am very interested in analyzing and solving this problem. Corruption problem have top priority for me. I have a few question:
 
 - What is your database URL?
 - What version H2 are you using?
@@ -32,8 +32,8 @@ I am sorry to say that, but it looks like a corruption problem. I am very intere
 - On what operating system, file system, and virtual machine?
 - How big is the database?
 - Is the database usually closed normally, or is process terminated forcefully or the computer switched off?
-- Is it possible to reproduce this problem using a fresh database?
-- Are there any other exceptions (maybe in the .trace.db file)? Could you post them please?
+- Is it possible to reproduce this problem using a fresh database (sometimes, or always)?
+- Are there any other exceptions (maybe in the .trace.db file)? Could you send them to me please?
 - Was the database originally created with an older version of H2?
 - Do you still have any .trace.db files, and if yes could you send them?
 - Could you send me the .data.db file where this exception occurs?

h2/src/tools/org/h2/tools/code/CheckTextFiles.java

@@ -10,6 +10,11 @@ import java.io.RandomAccessFile;
 
 import org.h2.util.ByteUtils;
 
+/**
+ * This tool checks that source code files only contain the allowed set of characters,
+ * and that the copyright license is included in each file.
+ * It also removes trailing spaces.
+ */
 public class CheckTextFiles {
     public static void main(String[] args) throws Exception {
         new CheckTextFiles().run();

h2/src/tools/org/h2/tools/code/CodeSwitch.java

@@ -10,9 +10,11 @@ import java.io.RandomAccessFile;
 import java.util.ArrayList;
 
 /**
- * @author Thomas TODO codeswitch: replace with ant 'Replace' task is possible
+ * This application allows to switch source code to different 'modes', so that
+ * it can be compiled for different JDKs.
  */
 public class CodeSwitch {
+    // TODO codeswitch: replace with ant 'Replace' task is possible
     private boolean recurse;
     private ArrayList list = new ArrayList();
     private ArrayList switchOn = new ArrayList();

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

@@ -21,6 +21,11 @@ import org.h2.util.IOUtils;
 import org.h2.util.JdbcUtils;
 import org.h2.util.StringUtils;
 
+/**
+ * This application generates sections of the documentation
+ * by converting the built-in help section (INFORMATION_SCHEMA.HELP)
+ * to cross linked html.
+ */
 public class GenerateDoc {
 
     public static void main(String[] args) throws Exception {

h2/src/tools/org/h2/tools/doc/LinkChecker.java

@@ -15,6 +15,10 @@ import org.h2.util.IOUtils;
 import org.h2.util.StartBrowser;
 import org.h2.util.StringUtils;
 
+/**
+ * The link checker makes sure that each link in the documentation
+ * points to an existing target.
+ */
 public class LinkChecker {
 
     private static final boolean OPEN_EXTERNAL_LINKS = false;

h2/src/tools/org/h2/tools/doc/MergeDocs.java

@@ -11,6 +11,10 @@ import java.io.PrintWriter;
 
 import org.h2.util.StringUtils;
 
+/**
+ * This application merges the html documentation to one file
+ * (onePage.html), so that the PDF document can be created.
+ */
 public class MergeDocs {
 
     String baseDir = "docs/html";

h2/src/tools/org/h2/tools/doc/SpellChecker.java

@@ -17,6 +17,11 @@ import java.util.StringTokenizer;
 
 import org.h2.util.IOUtils;
 
+/**
+ * The spell checker makes sure that each word used in the source code
+ * is spelled correctly, by comparing the words with a word list.
+ * Camel case and uppercase words are checked as well.
+ */
 public class SpellChecker {
 
     private HashSet dictionary = new HashSet();

h2/src/tools/org/h2/tools/doc/XMLChecker.java

@@ -11,6 +11,10 @@ import java.io.Reader;
 import java.io.StringWriter;
 import java.util.Stack;
 
+/**
+ * This class checks that the HTML and XML part of the source code
+ * is well-formed XML.
+ */
 public class XMLChecker {
 
     public static void main(String[] args) throws Exception {

h2/src/tools/org/h2/tools/doc/XMLParser.java

@@ -4,6 +4,10 @@
  */
 package org.h2.tools.doc;
 
+/**
+ * This class implements a simple XML pull parser.
+ * Only a subset of the XML pull parser API is implemented.
+ */
 public class XMLParser {
 
     public static final int ERROR = 0;

h2/src/tools/org/h2/tools/doclet/Doclet.java

@@ -22,6 +22,10 @@ import com.sun.javadoc.Tag;
 import com.sun.javadoc.ThrowsTag;
 import com.sun.javadoc.Type;
 
+/**
+ * This class is a custom doclet implementation to generate the
+ * Javadoc for this product.
+ */
 public class Doclet {
     public static boolean start(RootDoc root) throws IOException {
         ClassDoc[] classes = root.classes();

h2/src/tools/org/h2/tools/i18n/PrepareTranslation.java

@@ -33,6 +33,11 @@ import org.h2.util.IOUtils;
 import org.h2.util.SortedProperties;
 import org.h2.util.StringUtils;
 
+/**
+ * This class updates the translation source code files by parsing
+ * the HTML documentation. It also generates the translated HTML
+ * documentation.
+ */
 public class PrepareTranslation {
     private static final String MAIN_LANGUAGE = "en";
     private static final String DELETED_PREFIX = "~";

h2/src/tools/org/h2/tools/i18n/PropertiesToUTF8.java

@@ -27,6 +27,10 @@ import org.h2.util.IOUtils;
 import org.h2.util.SortedProperties;
 import org.h2.util.StringUtils;
 
+/**
+ * This class converts a file stored in the UTF-8 encoding format to
+ * a properties file and vice versa.
+ */
 public class PropertiesToUTF8 {
 
     public static void main(String[] args) throws Exception {

h2/src/tools/org/h2/tools/indexer/HtmlConverter.java

@@ -6,6 +6,10 @@ package org.h2.tools.indexer;
 
 import java.util.HashMap;
 
+/**
+ * This class replaces HTML entities in text (for example ü) to the correct
+ * character and vice versa.
+ */
 public class HtmlConverter {
     private static HashMap charMap = new HashMap();
     private static HashMap codeMap = new HashMap();

h2/src/tools/org/h2/tools/indexer/Indexer.java

@@ -18,6 +18,10 @@ import java.util.StringTokenizer;
 import org.h2.util.IOUtils;
 import org.h2.util.StringUtils;
 
+/**
+ * The indexer creates the fulltext index of the HTML documentation.
+ * It is used for the built-in HTML javascript search.
+ */
 public class Indexer {
 
     ArrayList pages = new ArrayList();

h2/src/tools/org/h2/tools/indexer/Page.java

@@ -4,7 +4,9 @@
  */
 package org.h2.tools.indexer;
 
-
+/**
+ * Represents a page of the indexer.
+ */
 public class Page {
     int id;
     String fileName;

h2/src/tools/org/h2/tools/indexer/Weight.java

@@ -4,6 +4,9 @@
  */
 package org.h2.tools.indexer;
 
+/**
+ * Represents a weight of a token in a page.
+ */
 public class Weight {
     static final int TITLE = 10000, HEADER = 100, PARAGRAPH = 1;
     Page page;

h2/src/tools/org/h2/tools/indexer/Word.java

@@ -9,6 +9,9 @@ import java.util.Collections;
 import java.util.Comparator;
 import java.util.HashMap;
 
+/**
+ * Represents a word of the full text index.
+ */
 public class Word {
     String name;
     HashMap pages = new HashMap();