1 files changed, 11 insertions, 1 deletions
diff --git a/plugins/org.eclipse.emf.cdo/src/org/eclipse/emf/spi/cdo/InternalCDOObject.java b/plugins/org.eclipse.emf.cdo/src/org/eclipse/emf/spi/cdo/InternalCDOObject.java
index d025792d30..d6ef1b59e0 100644
--- a/plugins/org.eclipse.emf.cdo/src/org/eclipse/emf/spi/cdo/InternalCDOObject.java
+++ b/plugins/org.eclipse.emf.cdo/src/org/eclipse/emf/spi/cdo/InternalCDOObject.java
@@ -42,9 +42,19 @@ public interface InternalCDOObject extends CDOObject, InternalEObject, InternalC
 
   public InternalCDORevision cdoRevision();
 
+  /**
+   * Migrates the object values from the instance to the revision.
+   * <p>
+   * This object must be in state PREPARED, so that eStore() uses the instance and cdoStore() uses the revision. 
+   */
   public void cdoInternalPostAttach();
 
-  public void cdoInternalPostDetach(boolean remote);
+  /**
+   * Migrates the object values from the revision to the instance.
+   * <p>
+   * This object must be in state TRANSIENT, so that eStore() uses the instance and cdoStore() uses the revision. 
+   */
+  public void cdoInternalPostDetach(boolean remote); // TODO Rename to preDetach
 
   public void cdoInternalPostInvalidate();