From 00283f0ef8de40708bc90024bdc12c24e2d627e0 Mon Sep 17 00:00:00 2001
From: David Montag <david.montag@neotechnology.com>
Date: Mon, 28 Mar 2011 16:55:59 -0700
Subject: [PATCH] Note about arity of relationships with @RelatedTo

---
 src/docbkx/reference/programming-model/annotations.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/docbkx/reference/programming-model/annotations.xml b/src/docbkx/reference/programming-model/annotations.xml
index 8137d4410..56fb59573 100644
--- a/src/docbkx/reference/programming-model/annotations.xml
+++ b/src/docbkx/reference/programming-model/annotations.xml
@@ -47,6 +47,10 @@ public class Movie {
             null. For multi-relationships the field provides a managed collection (Set) that handles addition and
             removal of node entities and reflects those in the graph relationships.
         </para>
+        <para>
+            <code>@RelatedTo</code> also ensures that there is only one relationship of the given type between two
+            given entities.
+        </para>
         <note>
             By setting direction to BOTH, relationships are created in the outgoing direction, but when the 1:N field
             is read, it will include relationships in both directions.