refactorings

src/main/java/com/mysema/query/Query.java

@@ -3,8 +3,10 @@ package com.mysema.query;
 import com.mysema.query.grammar.Types.*;
 
 /**
- * Query provides
+ * Query provides a fluent query interface, operations can be constructed via the 
+ * static methods of Grammar
  *
+ * @see Grammar
  * @author tiwe
  * @version $Id$
  */

src/main/java/com/mysema/query/grammar/Grammar.java

@@ -4,7 +4,7 @@ package com.mysema.query.grammar;
 import com.mysema.query.grammar.Types.*;
 
 /**
- * Grammar provides
+ * Grammar provides a fluent grammar for operation and order specifier creation
  *
  * @author tiwe
  * @version $Id$

src/main/java/com/mysema/query/grammar/Types.java

@@ -1,9 +1,7 @@
 package com.mysema.query.grammar;
 
-
-
 /**
- * Types provides
+ * Types provides the types of the fluent grammar
  *
  * @author tiwe
  * @version $Id$