diff --git a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlJoinMeta.java b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlJoinMeta.java
index 9f06a763a..085aa46b2 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlJoinMeta.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/grammar/HqlJoinMeta.java
@@ -6,7 +6,7 @@
 package com.mysema.query.grammar;
 
 /**
- * JoinMeta provied join metadata in the form of flags
+ * HqlJoinMeta provides join metadata in the form of flags for HQL queries
  *
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/hql/JpaqlQuery.java b/querydsl-hql/src/main/java/com/mysema/query/hql/JpaqlQuery.java
index 4146b3947..b5fd1849b 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/hql/JpaqlQuery.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/hql/JpaqlQuery.java
@@ -18,7 +18,7 @@ import com.mysema.query.grammar.HqlQueryBase;
 import com.mysema.query.grammar.types.Expr;
 
 /**
- * JpaqlQuery provides
+ * JpaqlQuery provides a fluent statically typed interface for creating JPAQL queries.
  *
  * @author tiwe
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/hql/QueryModifiers.java b/querydsl-hql/src/main/java/com/mysema/query/hql/QueryModifiers.java
index 330b3b4f9..9d7996b43 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/hql/QueryModifiers.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/hql/QueryModifiers.java
@@ -7,7 +7,7 @@
 package com.mysema.query.hql;
 
 /**
- * QueryModifiers provides.
+ * QueryModifiers combines limit and offset info into a single type
  * 
  * @author Timo Westkamper
  * @version $Id$
diff --git a/querydsl-hql/src/main/java/com/mysema/query/hql/SearchResults.java b/querydsl-hql/src/main/java/com/mysema/query/hql/SearchResults.java
index b4638a631..c834c79b6 100644
--- a/querydsl-hql/src/main/java/com/mysema/query/hql/SearchResults.java
+++ b/querydsl-hql/src/main/java/com/mysema/query/hql/SearchResults.java
@@ -10,7 +10,7 @@ import java.util.Collections;
 import java.util.List;
 
 /**
- * SearchResults provides.
+ * SearchResults bundles data for paged search results
  * 
  * @author Timo Westkamper
  * @version $Id$