From 2d4bca7a4d4845520c2e011089aacf1e0c731c1c Mon Sep 17 00:00:00 2001
From: Oliver Gierke <info@olivergierke.de>
Date: Mon, 23 Jul 2012 19:32:52 +0200
Subject: [PATCH] DATAJPA-227 - Improved documentation on native queries with
 @Query.

---
 src/docbkx/reference/jpa.xml | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/docbkx/reference/jpa.xml b/src/docbkx/reference/jpa.xml
index e57e547b7..a8720dc8e 100644
--- a/src/docbkx/reference/jpa.xml
+++ b/src/docbkx/reference/jpa.xml
@@ -498,7 +498,8 @@ public class User {
       in <filename>orm.xml</filename>.</para>
 
       <example>
-        <title>Declare query at the query method using @Query</title>
+        <title>Declare query at the query method using
+        <interfacename>@Query</interfacename></title>
 
         <programlisting language="java">public interface UserRepository extends JpaRepository&lt;User, Long&gt; {
 
@@ -516,6 +517,17 @@ public class User {
         dynamic sorting for native queries as we'd have to manipulate the
         actual query declared and we cannot do this reliably for native
         SQL.</para>
+
+        <example>
+          <title>Declare a native query at the query method using
+          <interfacename>@Query</interfacename></title>
+
+          <programlisting language="java">public interface UserRepository extends JpaRepository&lt;User, Long&gt; {
+
+  @Query(value = "SELECT FROM USERS WHERE EMAIL_ADDRESS = ?0", nativeQuery = true)
+  User findByEmailAddress(String emailAddress);
+}</programlisting>
+        </example>
       </simplesect>
     </section>