From 9fde4dff3ed0906bd663a8073d60eb10be994882 Mon Sep 17 00:00:00 2001
From: Mark Pollack <mpollack@vmware.com>
Date: Mon, 14 Nov 2011 22:53:08 -0500
Subject: [PATCH] DATAMONGO-195 - Add description of @Field mapping annotation
 to reference docs

---
 src/docbkx/reference/mapping.xml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/docbkx/reference/mapping.xml b/src/docbkx/reference/mapping.xml
index bcb538ba0..766ce17b6 100644
--- a/src/docbkx/reference/mapping.xml
+++ b/src/docbkx/reference/mapping.xml
@@ -370,6 +370,13 @@ public class Person {
           Language statement to transform a key's value retrieved in the
           database before it is used to construct a domain object.</para>
         </listitem>
+
+        <listitem>
+          <para><literal>@Field</literal> - applied at the field level and
+          described the name of the field as it will be represented in the
+          MongoDB BSON document thus allowing the name to be different than
+          the fieldname of the class.</para>
+        </listitem>
       </itemizedlist>
 
       <para>The mapping metadata infrastructure is defined in a seperate
@@ -388,16 +395,24 @@ public class Person&lt;T extends Address&gt; {
 
   @Id
   private String id;
+
   @Indexed(unique = true)
   private Integer ssn;
+
+  @Field("fName")
   private String firstName;
+
   @Indexed
   private String lastName;
+
   private Integer age;
+
   @Transient
   private Integer accountTotal;
+
   @DBRef
   private List&lt;Account&gt; accounts;
+
   private T address;