From fcfec9e4f6dc1858dbc23e22e36d66b41ab0fbf1 Mon Sep 17 00:00:00 2001
From: Gavin King <gavin@hibernate.org>
Date: Thu, 25 Apr 2024 12:54:32 +0200
Subject: [PATCH] move a NOTE to a much more sensible location

Signed-off-by: Gavin King <gavin@hibernate.org>
---
 .../main/asciidoc/ch03-entity-operations.adoc | 39 ++++++++-----------
 1 file changed, 16 insertions(+), 23 deletions(-)

diff --git a/spec/src/main/asciidoc/ch03-entity-operations.adoc b/spec/src/main/asciidoc/ch03-entity-operations.adoc
index 84c2e134..a848beec 100644
--- a/spec/src/main/asciidoc/ch03-entity-operations.adoc
+++ b/spec/src/main/asciidoc/ch03-entity-operations.adoc
@@ -144,29 +144,6 @@ public class OrderEntryBean implements OrderEntry {
 }
 ----
 
-[NOTE]
-====
-The semantics of
-
-    public <T> TypedQuery<T> createQuery(String qlString, Class<T> resultClass)
-
-method may be extended in a future release of this specification to
-support other result types. Applications that specify other result types
-(e.g., Tuple.class) will not be portable.
-====
-
-[NOTE]
-====
-The semantics
-
-    public <T> TypedQuery<T> createNamedQuery(String name, Class<T> resultClass)
-
-method may be extended in a future release of this specification to
-support other result types. Applications that specify other result types
-(e.g., Tuple.class) will not be portable.
-====
-
-
 === Entity Instance's Life Cycle [[a1929]]
 
 This section describes the `EntityManager`
@@ -2533,6 +2510,22 @@ items are returned, the elements of the query result are of type
 result set mapping or if a result class is specified, the elements of
 the query result are of type `Object`.
 
+[NOTE]
+====
+The semantics of the methods
+
+[source,java]
+public <T> TypedQuery<T> createQuery(String qlString, Class<T> resultClass)
+
+[source,java]
+public <T> TypedQuery<T> createNamedQuery(String name, Class<T> resultClass)
+
+may be extended in a future release of this specification to support other
+result types. Use of other result types, including `Tuple.class`, is not
+portable.
+====
+
+
 Stored procedure queries can be executed using the `getResultList`,
 `getSingleResult`, `getSingleResultOrNull`, and `execute` methods.
 Stored procedures that perform only updates or deletes can be executed