Generate docs

1 files changed, 28 insertions, 4 deletions

diff --git a/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/util/ReferentialIntegrityException.html b/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/util/ReferentialIntegrityException.html
index 9d04736579..20752abf16 100644
--- a/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/util/ReferentialIntegrityException.html
+++ b/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/util/ReferentialIntegrityException.html
@@ -96,7 +96,8 @@ Class ReferentialIntegrityException</H2>
   <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">java.lang.Throwable</A>
       <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">java.lang.Exception</A>
           <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../../org/eclipse/emf/cdo/util/CommitException.html" title="class in org.eclipse.emf.cdo.util">org.eclipse.emf.cdo.util.CommitException</A>
-              <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>org.eclipse.emf.cdo.util.ReferentialIntegrityException</B>
+              <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../../org/eclipse/emf/cdo/util/DataIntegrityException.html" title="class in org.eclipse.emf.cdo.util">org.eclipse.emf.cdo.util.DataIntegrityException</A>
+                  <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>org.eclipse.emf.cdo.util.ReferentialIntegrityException</B>
 </PRE>
 <DL>
 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</A></DD>
@@ -104,12 +105,12 @@ Class ReferentialIntegrityException</H2>
 <HR>
 <DL>
   <DT>public class <B>ReferentialIntegrityException</B>
-  <DD>extends <A HREF="../../../../../org/eclipse/emf/cdo/util/CommitException.html" title="class in org.eclipse.emf.cdo.util">CommitException</A>
+  <DD>extends <A HREF="../../../../../org/eclipse/emf/cdo/util/DataIntegrityException.html" title="class in org.eclipse.emf.cdo.util">DataIntegrityException</A>
 </DL>
 
 <map id="APIVIZ" name="APIVIZ">
 <area shape="rect" id="node1" href="ReferentialIntegrityException.html" title="&#171;exception&#187; ReferentialIntegrityException" alt="" coords="5,84,192,124"/>
-<area shape="rect" id="node2" href="CommitException.html" title="&#171;exception&#187; CommitException" alt="" coords="36,5,161,45"/>
+<area shape="rect" id="node2" href="DataIntegrityException.html" title="&#171;exception&#187; DataIntegrityException" alt="" coords="22,5,175,45"/>
 </map>
 
 <CENTER><IMG SRC="ReferentialIntegrityException.png" USEMAP="#APIVIZ" BORDER="0"></CENTER>
@@ -117,7 +118,21 @@ Class ReferentialIntegrityException</H2>
 
 
 <P>
-A <A HREF="../../../../../org/eclipse/emf/cdo/util/CommitException.html" title="class in org.eclipse.emf.cdo.util"><CODE>commit exception</CODE></A> that indicates referential integrity problems detected by the server.
+A <A HREF="../../../../../org/eclipse/emf/cdo/util/DataIntegrityException.html" title="class in org.eclipse.emf.cdo.util"><CODE>data integrity exception</CODE></A> that indicates an attempt to create <i>stale references</i>.
+ A stale reference is a refenrence that points to a target object that does not (or no longer) exist.
+ <p>
+ Detection of referential integrity violations must be explicitely enabled on the server side because it can be expensive:
+
+ <pre>
+    &lt;property name="ensureReferentialIntegrity" value="true"/>
+ </pre>
+ The risk of referential integrity violations can be <b>reduced</b> (but not eliminated) by using local cross reference queries
+ before committing:
+ <p>
+ <ul>
+ <li> <A HREF="../../../../../org/eclipse/emf/cdo/view/CDOView.html#queryXRefs(org.eclipse.emf.cdo.CDOObject, org.eclipse.emf.ecore.EReference...)"><CODE>CDOView#queryXRefs()</CODE></A>
+ <li> <A HREF="../../../../../org/eclipse/emf/cdo/view/CDOView.html#queryXRefsAsync(java.util.Set, org.eclipse.emf.ecore.EReference...)"><CODE>CDOView#queryXRefsAsync()</CODE></A>
+ </ul>
 <P>
 
 <P>
@@ -167,6 +182,15 @@ A <A HREF="../../../../../org/eclipse/emf/cdo/util/CommitException.html" title="
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 </TR>
 </TABLE>
+&nbsp;<A NAME="methods_inherited_from_class_org.eclipse.emf.cdo.util.CommitException"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class org.eclipse.emf.cdo.util.<A HREF="../../../../../org/eclipse/emf/cdo/util/CommitException.html" title="class in org.eclipse.emf.cdo.util">CommitException</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../../../org/eclipse/emf/cdo/util/CommitException.html#isLocal()">isLocal</A>, <A HREF="../../../../../org/eclipse/emf/cdo/util/CommitException.html#wrap()">wrap</A></CODE></TD>
+</TR>
+</TABLE>
 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></A>
 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">