diff --git a/querydsl-sql/src/main/java/com/mysema/query/sql/AbstractSQLQuery.java b/querydsl-sql/src/main/java/com/mysema/query/sql/AbstractSQLQuery.java
index b68e60ca6..d022918e6 100644
--- a/querydsl-sql/src/main/java/com/mysema/query/sql/AbstractSQLQuery.java
+++ b/querydsl-sql/src/main/java/com/mysema/query/sql/AbstractSQLQuery.java
@@ -38,7 +38,7 @@ import com.mysema.util.JDBCUtil;
 import com.mysema.util.ResultSetAdapter;
 
 /**
- * AbstractSqlQuery is the base type for SQL query implementations
+ * AbstractSQLQuery is the base type for SQL query implementations
  * 
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLQueryImpl.java b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLQueryImpl.java
index 392f0bb91..da9638283 100644
--- a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLQueryImpl.java
+++ b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLQueryImpl.java
@@ -40,6 +40,8 @@ public class SQLQueryImpl extends AbstractSQLQuery<SQLQueryImpl> implements SQLQ
     }
 
     /**
+     * Create a new SQLQueryImpl instance
+     * 
      * @param conn
      * @param templates
      * @param metadata
diff --git a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLResultIterator.java b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLResultIterator.java
index fbbb48d2a..68ac5dc2a 100644
--- a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLResultIterator.java
+++ b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLResultIterator.java
@@ -16,6 +16,8 @@ import com.mysema.commons.lang.CloseableIterator;
 import com.mysema.query.QueryException;
 
 /**
+ * SQLResultIterator is an Iterator adapter for JDBC result sets with customizable projections
+ * 
  * @author tiwe
  *
  * @param <T>
diff --git a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLSubQuery.java b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLSubQuery.java
index 54ffb882a..b879f0773 100644
--- a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLSubQuery.java
+++ b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLSubQuery.java
@@ -13,7 +13,7 @@ import com.mysema.query.types.expr.EBoolean;
 import com.mysema.query.types.path.PEntity;
 
 /**
- * SQLSubQuery is a SubQuery implementation for SQL queries
+ * SQLSubQuery is a subquery implementation for SQL queries
  * 
  * @author tiwe
  *
diff --git a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLTypeMapping.java b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLTypeMapping.java
index 9751581c3..6b971b1bd 100644
--- a/querydsl-sql/src/main/java/com/mysema/query/sql/SQLTypeMapping.java
+++ b/querydsl-sql/src/main/java/com/mysema/query/sql/SQLTypeMapping.java
@@ -14,6 +14,8 @@ import java.util.Map;
 import javax.annotation.Nullable;
 
 /**
+ * SQLTypeMapping defines a mapping from JDBC types to Java classes.
+ * 
  * @author tiwe
  *
  */
diff --git a/querydsl-sql/src/main/java/com/mysema/query/sql/Union.java b/querydsl-sql/src/main/java/com/mysema/query/sql/Union.java
index ccf93c3c5..9e9e4015b 100644
--- a/querydsl-sql/src/main/java/com/mysema/query/sql/Union.java
+++ b/querydsl-sql/src/main/java/com/mysema/query/sql/Union.java
@@ -20,12 +20,16 @@ import com.mysema.query.types.OrderSpecifier;
 public interface Union<RT> {
     
     /**
+     * Define the ordering of the query results
+     * 
      * @param o
      * @return
      */
     Union<RT> orderBy(OrderSpecifier<?>... o);
 
     /**
+     * Retrieve the results
+     * 
      * @return
      * @throws SQLException
      */