Update docs for always_version option

2 files changed, 15 insertions, 2 deletions

diff --git a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml
index 06c06d5c7..d8a30e483 100644
--- a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml
+++ b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml
@@ -9,7 +9,7 @@
 
 <!--
 	@author <a href="mtaal@elver.org">Martin Taal</a>
-	@version $Revision: 1.2 $ $Date: 2006/09/13 16:05:49 $
+	@version $Revision: 1.3 $ $Date: 2006/09/26 12:45:14 $
 -->
 
 <!DOCTYPE document PUBLIC
@@ -74,6 +74,16 @@
 			<p>Primitive features and single refererences are eagerly loaded. ELists are 
 		lazily loaded. In the future probably also single-references will be lazily loaded.</p>
 		</section>
+		<section><title>Synthetic ID and Version properties</title>
+			<p>When Teneo detects that a certain type does not have an id or version annotated property then
+			it will add these automatically. The synthetic id and version are hidden for the developer. You can
+			retrieve the hidden synthetic id or version through the class org.eclipse.emf.teneo.hibernate.mapping.identifier.IdentifierCacheHandler.
+			You can prevent the automatic adding of a synthetic version property by setting the PersistenceOptions.ALWAYS_VERSION 
+			to false, see <a href="options.html">here</a>. If this property is false then only efeatures with a version annotation are
+			translated into a version mapping.</p>
+			<p>Synthetic id and version use object equality (==), this means that synthetic id and version will not
+			work if objects are transferred to other systems and back (for example in case of client-server communication).</p>
+		</section>
 		<section id="cutpaste">
 			<title>Move an EObject between EContainers or support cut and paste in the EMF editor</title>
 			<p>In the standard approach it is not possible to move an EObject from one containment relation to another containment relation. A move
diff --git a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml
index 7b490d7eb..47d3ca906 100644
--- a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml
+++ b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml
@@ -9,7 +9,7 @@
 
 <!--
 	@author <a href="mtaal@elver.org">Martin Taal</a>
-	@version $Revision: 1.3 $ $Date: 2006/09/13 16:05:49 $
+	@version $Revision: 1.4 $ $Date: 2006/09/26 12:45:14 $
 -->
 
 <!DOCTYPE document PUBLIC
@@ -26,6 +26,9 @@
 		<p>Options are passed to the HbDataStore using a Properties object which is set using the HbDataStore.setPersistenceProperties method.</p>
 		<p>Boolean options can have the lower case String values: "false" or "true".</p>
 		<ul>
+		<li><strong>PersistenceOptions.ALWAYS_VERSION</strong>: this option (boolean, default: true) determines if the system should automatically 
+		add a version attribute to each class mapping. If set to true (the default) then the system will add a version property to the mapping if 
+		no other eattribute has a version annotation. If set to false then the version property is not added automatically.</li>
 		<li><strong>PersistenceOptions.DISABLE_ECONTAINER_MAPPING</strong>: this option (boolean) controls if the container relations
 		are mapped explicitly in the database, see also <a href="hibernate_relations.html#Storing+container+relation">here</a>.</li>
 		<li><strong>PersistenceOptions.FETCH_CONTAINMENT_EAGERLY</strong>: if set to "true" will set the fetch strategy of all