HHH-19364 update docs to reflect latest API

Author: gavinking

documentation/src/main/asciidoc/userguide/chapters/query/programmatic/QuerySpecification.adoc

@@ -20,9 +20,9 @@ A `SelectionSpecification` allows to iteratively build a query from a "base", ad
 ====
 [source, java, indent=0]
 ----
-SelectionSpecification<Book> spec = session.createSelectionSpecification(
-    "from Book",
-    Book.class
+SelectionSpecification<Book> spec = SelectionSpecification.create(
+    Book.class,
+    "from Book"
 );
 ----
 ====
@@ -33,7 +33,7 @@ or a root entity as the base -
 ====
 [source, java, indent=0]
 ----
-SelectionSpecification<Book> spec = session.createSelectionSpecification(Book.class);
+SelectionSpecification<Book> spec = SelectionSpecification.create(Book.class);
 ----
 ====
 
@@ -45,15 +45,15 @@ Once we have the `SelectionSpecification` we can adjust the query adding restric
 ----
 // from here we can augment the base query "from Book",
 // with either restrictions
-spec.restriction(
+spec.restrict(
     Restriction.restrict(
         Book_.suggestedCost,
         Range.closed(10.00, 19.99)
     )
 );
 
 // or here with some sorting
-spec.order(
+spec.sort(
     Order.asc(Book_.suggestedCost)
 )
 ----
@@ -70,7 +70,7 @@ After adjusting the query, we can obtain the executable `SelectionQuery`:
 ====
 [source, java, indent=0]
 ----
-SelectionQuery<Book> qry = ds.createQuery();
+SelectionQuery<Book> qry = ds.createQuery(session);
 List<Book> books = qry.getResultList();
 ----
 ====
@@ -81,17 +81,17 @@ These calls can even be chained, e.g.
 ====
 [source, java, indent=0]
 ----
-SelectionQuery<Book> qry = session.createSelectionSpecification(
-    "from Book",
-    Book.class
-).restriction(
+SelectionQuery<Book> qry = SelectionSpecification.create(
+    Book.class,
+    "from Book"
+).restrict(
     Restriction.restrict(
         Book_.suggestedCost,
         Range.closed(10.00, 19.99)
     )
-).order(
+).sort(
     Order.asc(Book_.suggestedCost)
-).createQuery();
+).createQuery(session);
 ----
 ====
 
@@ -112,14 +112,14 @@ At the moment, only update and delete queries are supported.  E.g.
 ====
 [source, java, indent=0]
 ----
-MutationQuery<Book> qry = session.createMutationSpecification(
-    "delete Book",
-    Book.class
-).restriction(
+MutationQuery<Book> qry = MutationSpecification.create(
+    Book.class,
+    "delete Book"
+).restrict(
     Restriction.restrict(
         Book_.suggestedCost,
         Range.closed(10.00, 19.99)
     )
-).createQuery();
+).createQuery(session);
 ----
 ====

whats-new.adoc

@@ -129,17 +129,17 @@ A new API has been added for incremental definition of a query, with support for
 ====
 [source, java, indent=0]
 ----
-SelectionQuery<Book> qry = session.createSelectionSpecification(
-    "from Book",
-    Book.class
-).restriction(
+SelectionQuery<Book> qry = SelectionSpecification.create(
+    Book.class,
+    "from Book"
+).restrict(
     Restriction.restrict(
         Book_.suggestedCost,
         Range.closed(10.00, 19.99)
     )
-).order(
+).sort(
     Order.asc(Book_.suggestedCost)
-).createQuery();
+).createQuery(session);
 ----
 ====
 
@@ -148,15 +148,15 @@ as well as mutations -
 ====
 [source, java, indent=0]
 ----
-MutationQuery<Book> qry = session.createMutationSpecification(
-    "delete Book",
-    Book.class
-).restriction(
+MutationQuery<Book> qry = MutationSpecification.create(
+    Book.class,
+    "delete Book"
+).restrict(
     Restriction.restrict(
         Book_.suggestedCost,
         Range.closed(10.00, 19.99)
     )
-).createQuery();
+).createQuery(session);
 ----
 ====