OPENJPA-442 deprecating and adding javadoc

git-svn-id: https://svn.apache.org/repos/asf/openjpa/trunk@649956 13f79535-47bb-0310-9956-ffa450edef68

openjpa-persistence/src/main/java/org/apache/openjpa/persistence/QueryImpl.java

@@ -70,7 +70,14 @@ public class QueryImpl
     private List _positional;
 
     /**
-     * Constructor; supply factory and delegate.
+     * Constructor; supply factory exception translator and delegate.
+     * 
+     * @param em
+     *            The EntityManager which created this query
+     * @param ret
+     *            Exception translater for this query
+     * @param query
+     *            The underlying "kernel" query.
      */
     public QueryImpl(EntityManagerImpl em, RuntimeExceptionTranslator ret,
         org.apache.openjpa.kernel.Query query) {
@@ -80,6 +87,7 @@ public class QueryImpl
     
     /**
      * Constructor; supply factory and delegate.
+     * @deprecated
      */
     public QueryImpl(EntityManagerImpl em, org.apache.openjpa.kernel.Query query) {
         this(em, null, query);