In 5.2:

• org.hibernate.query.Query was introduced, annotated with @Incubating;
• org.hibernate.Query was deprecated, indicating that org.hibernate.query.Query should be used instead;
• references to org.hibernate.Query were changed to org.hibernate.query.Query in the user guide.

The documentation for @Incubating says:

 * Marks (recursively) certain of Hibernate's packages, types and methods
 * as incubating.  Incubating indicates a type or method that is still being
 * actively developed and therefore may change at a later time.  Users of these
 * types and methods are considered early adopters who help shape the final
 * definition of these types/methods.

This causes a dilemma about whether applications should migrate from the old API to the new class.

Should org.hibernate.Query be undeprecated?

Could/should org.hibernate.query.Query be deprecated?