DATAMONGO-899 - Ensure proper creation of index structures for nested entities.

Index creation did not consider the properties path when creating the index. This lead to broken index creation when nesting entities that might require index structures.

Off now index creation traverses the entities property path for all top level entities (namely those holding the @Document annotation) and creates the index using the full property path.

This is a breaking change as having an entity to carry the @Document annotation has not been required by now.

Original Pull Request: #168

src/docbkx/reference/mapping.xml

@@ -312,6 +312,11 @@ public class Person {
       document, making searches faster.</para>
     </important>
 
+    <important>
+      <para>Automatic index creation is only done for types annotated with
+      <classname>@Document</classname>.</para>
+    </important>
+
     <section id="mapping-usage-annotations">
       <title>Mapping annotation overview</title>