diff --git a/README.txt b/README.txt
index 79fec89..539f645 100644
--- a/README.txt
+++ b/README.txt
@@ -1,6 +1,6 @@
 # $Id$
 
-olap4j, release 0.9.9 (beta)
+olap4j, release 1.0.0
 
 Contents of this distribution
 -----------------------------
@@ -13,22 +13,40 @@ This release of olap4j contains a driver implementation based on the XML for
 Analysis (XML/A) protocol. There is also an olap4j driver for mondrian; this
 is part of the mondrian distribution from mondrian-3.0 onwards.
 
-olap4j requires the following files at run time:
+Olap4j is divided in four different jar files.
+
+* olap4j-[version].jar
+    This is the core olap4j API.
+
+* olap4j-xmla-[version].jar
+    This is the XMLA implementation of the olap4j core API.
+
+* olap4j-tck-[version].jar
+    This is the technology compatibility kit for olap4j.
+
+* olap4j-jdk14-[version].jar
+    This is a Java 1.4 compatible retrowoven olap4j distribution. It contains both the core API and the XMLA driver.
+
+olap4j requires the following libraries at run time:
 
 * lib/olap4j.jar (or lib/olap4j-jdk14.jar if you are running JDK 1.4)
 * lib/javacup.jar
-* lib/asm.jar
-* lib/asm-commons.jar
 
 If you use the JDK 1.4 compatible jar, you will also need:
 
 * lib/retroweaver.jar
 * lib/retroweaver-rt.jar
+* lib/asm.jar
+* lib/asm-commons.jar
 
 If you are using the XML/A driver, you will also need:
 
 * lib/xercesImpl.jar
 
+The TCK requires:
+
+* lib/commons-dbcp.jar
+
 Building olap4j from source
 ---------------------------
 
@@ -37,7 +55,7 @@ Building olap4j from source
    (%JAVA_HOME%\bin for Windows) on your path.
 3. Edit buildJdk16.bat and buildJdk16.sh and set the JAVA_HOME variable
    to a valid home directory of a Java 6 installation.
-4. In the root of the source tree, run 'ant'.
+4. In the root of the source tree, run 'ant'. You must use Apache Ant 1.7+.
 
 Writing a simple program
 ------------------------
@@ -52,8 +70,7 @@ You can now write and run a simple program against olap4j. For example, under Ja
         Connection connection =
             DriverManager.getConnection(
                 "jdbc:xmla:"
-                    + "Server=http://deedub:8080/mondrian/xmla;"
-                    + "Catalog=FoodMart");
+                    + "Server=http://example.com:8080/mondrian/xmla");
         OlapConnection olapConnection = connection.unwrap(OlapConnection.class);
         OlapStatement statement = olapConnection.createStatement();
         CellSet cellSet =
diff --git a/src/org/olap4j/OlapConnection.java b/src/org/olap4j/OlapConnection.java
index e8a2242..b7c547d 100644
--- a/src/org/olap4j/OlapConnection.java
+++ b/src/org/olap4j/OlapConnection.java
@@ -293,7 +293,7 @@ public interface OlapConnection extends Connection, OlapWrapper {
      * Sets the name of the active schema for this connection.
      * Overrides the value passed, if any, through the JDBC URL.
      *
-     * @param catalogName The name of the schema to use for this connection.
+     * @param schemaName The name of the schema to use for this connection.
      * @throws OlapException
      *             An exception will be thrown, if any of these conditions
      *             are true:
@@ -349,7 +349,7 @@ public interface OlapConnection extends Connection, OlapWrapper {
     Schema getOlapSchema() throws OlapException;
 
     /**
-     * Returns a list of {@link org.olap4j.metadata.Schemas} objects which
+     * Returns a list of {@link org.olap4j.metadata.Schema} objects which
      * belong to this connection's OLAP server.
      *
      * <p>If the user has not selected a Database, Catalog and Schema to use
diff --git a/src/org/olap4j/OlapDatabaseMetaData.java b/src/org/olap4j/OlapDatabaseMetaData.java
index 60b4e44..046a026 100644
--- a/src/org/olap4j/OlapDatabaseMetaData.java
+++ b/src/org/olap4j/OlapDatabaseMetaData.java
@@ -503,7 +503,6 @@ ResultSet getDimensions(
      *
      * @exception OlapException if a database access error occurs
      *
-     * @see #getFunctions(String, String, String)
      * @see #getSearchStringEscape
      */
     // NOTE: '#getFunctions(String, String, String)' above generates a javadoc
diff --git a/src/org/olap4j/query/QueryDimension.java b/src/org/olap4j/query/QueryDimension.java
index 38a05b9..2feb5cc 100644
--- a/src/org/olap4j/query/QueryDimension.java
+++ b/src/org/olap4j/query/QueryDimension.java
@@ -149,7 +149,7 @@ public Selection createSelection(Member member) {
      * Selects a level and includes it in the query.
      * <p>This method selects and includes a all members of the given
      * query using the {@link Selection.Operator#MEMBERS} selection operator.
-     * @param member The member to select and include in the query.
+     * @param level The level to select and include in the query.
      */
     public Selection include(Level level) {
         if (level.getDimension().equals(this.dimension)) {
@@ -186,7 +186,7 @@ public Selection createSelection(
      * Selects level and includes all members in the query.
      * <p>This method selects and includes all members of a
      * given Level, using the MEMBERS operator {@link Selection.Operator}
-     * @param member Root member to select and include.
+     * @param level Root level to select and include.
      */
     public Selection createSelection(Level level)
     {
diff --git a/src/org/olap4j/query/Selection.java b/src/org/olap4j/query/Selection.java
index 1b864d1..211c27c 100644
--- a/src/org/olap4j/query/Selection.java
+++ b/src/org/olap4j/query/Selection.java
@@ -59,7 +59,7 @@ public interface Selection extends QueryNode {
 
     /**
      * Returns the root selection element of this selection.
-     * @return
+     * @return The root metadata object.
      */
     MetadataElement getRootElement();