diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlOps.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlOps.java
index 42d648337..14c088fb3 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlOps.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlOps.java
@@ -17,7 +17,7 @@ import com.mysema.query.grammar.types.PathMetadata.PathType;
 import com.mysema.query.serialization.BaseOps;
 
 /**
- * HqlOps provides.
+ * HqlOps provides operator patterns for HQL serialization
  * 
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlQueryBase.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlQueryBase.java
index 49c53ea52..484fee95e 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlQueryBase.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlQueryBase.java
@@ -13,7 +13,7 @@ import com.mysema.query.QueryBase;
 import com.mysema.query.grammar.types.Expr.Entity;
 
 /**
- * HqlQueryBase provides.
+ * HqlQueryBase is a base Query class for HQL
  * 
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlSerializer.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlSerializer.java
index 9e387652b..c85ba11b2 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlSerializer.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlSerializer.java
@@ -25,7 +25,7 @@ import com.mysema.query.serialization.BaseSerializer;
 
 
 /**
- * HqlSerializer provides.
+ * HqlSerializer serializes querydsl expressions into HQL syntax.
  * 
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/JoinMeta.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/JoinMeta.java
index bfd9b6999..3df4e3d94 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/JoinMeta.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/JoinMeta.java
@@ -6,7 +6,7 @@
 package com.mysema.query.grammar;
 
 /**
- * JoinMeta provides
+ * JoinMeta provied join metadata in the form of flags
  *
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Custom.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Custom.java
index a2334b206..2123c4952 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Custom.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Custom.java
@@ -6,7 +6,7 @@
 package com.mysema.query.grammar.types;
 
 /**
- * Custom provides.
+ * Custom provides base types for custom expresions with integrated HQL based serialization patterns
  * 
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/types/HqlTypes.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/types/HqlTypes.java
index 341695f19..6b8b82a73 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/types/HqlTypes.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/types/HqlTypes.java
@@ -11,7 +11,7 @@ import com.mysema.query.grammar.JoinMeta;
 import com.mysema.query.grammar.OrderSpecifier;
 
 /**
- * HqlTypes provides.
+ * HqlTypes provides general HQL specific types
  * 
  * @author tiwe
  * @version $Id$
@@ -21,6 +21,7 @@ public class HqlTypes {
     /**
      * The Class Constructor.
      */
+    // TODO : generalize ?!?
     public static class Constructor<D> extends Expr<D>{
         private final Expr<?>[] args;
         public Constructor(Class<D> type, Expr<?>... args){
diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Quant.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Quant.java
index 947f73356..2f63265a0 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Quant.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/types/Quant.java
@@ -8,7 +8,7 @@ package com.mysema.query.grammar.types;
 import com.mysema.query.grammar.Ops.Op;
 
 /**
- * Quant provides.
+ * Quant provides expressions for quantification.
  * 
  * @author tiwe
  * @version $Id$