From 871d0bad355ea455dc6685c7f17b8d131dc6baa0 Mon Sep 17 00:00:00 2001
From: Gavin King <gavin@hibernate.org>
Date: Thu, 21 Jul 2005 01:57:46 +0000
Subject: [PATCH] doc property-ref, cascade

git-svn-id: https://svn.jboss.org/repos/hibernate/trunk/Hibernate3/doc@7590 1b8cb986-b30d-0410-93ca-fae66ebed9b2
---
 reference/en/modules/basic_mapping.xml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/reference/en/modules/basic_mapping.xml b/reference/en/modules/basic_mapping.xml
index 4aab08fecf..53fcc0ade7 100644
--- a/reference/en/modules/basic_mapping.xml
+++ b/reference/en/modules/basic_mapping.xml
@@ -1382,7 +1382,7 @@
 
         </sect2>
 
-        <sect2 id="mapping-declaration-manytoone" revision="3">
+        <sect2 id="mapping-declaration-manytoone" revision="4">
             <title>many-to-one</title>
 
             <para>
@@ -1551,7 +1551,8 @@
                 and <literal>all</literal> and comma-separated combinations of operation
                 names, for example, <literal>cascade="persist,merge,evict"</literal> or
                 <literal>cascade="all,delete-orphan"</literal>. See <xref linkend="objectstate-transitive"/>
-                for a full explanation.
+                for a full explanation. Note that single valued associations (many-to-one and 
+                one-to-one associations) do not support orphan delete.
             </para>
             
             <para>
@@ -1586,6 +1587,12 @@
                 map the referenced properties inside a named <literal>&lt;properties&gt;</literal> element.
             </para>
             
+            <para>
+            	If the referenced unique key is the property of a component, you may specify a property path:
+            </para>
+            
+           <programlisting><![CDATA[<many-to-one name="owner" property-ref="identity.ssn" column="OWNER_SSN"/>]]></programlisting>           
+            
         </sect2>
 
         <sect2 id="mapping-declaration-onetoone" revision="2">