1 files changed, 21 insertions, 0 deletions
diff --git a/plugins/org.eclipse.emf.cdo.server/src/org/eclipse/emf/cdo/server/IStoreWriter.java b/plugins/org.eclipse.emf.cdo.server/src/org/eclipse/emf/cdo/server/IStoreWriter.java
index fd9c75dc48..0f81a99d5c 100644
--- a/plugins/org.eclipse.emf.cdo.server/src/org/eclipse/emf/cdo/server/IStoreWriter.java
+++ b/plugins/org.eclipse.emf.cdo.server/src/org/eclipse/emf/cdo/server/IStoreWriter.java
@@ -10,8 +10,13 @@
  **************************************************************************/
 package org.eclipse.emf.cdo.server;
 
+import org.eclipse.emf.cdo.internal.protocol.model.CDOClassImpl;
+import org.eclipse.emf.cdo.internal.protocol.model.CDOClassProxy;
+import org.eclipse.emf.cdo.internal.protocol.model.CDOFeatureImpl;
 import org.eclipse.emf.cdo.internal.protocol.model.CDOPackageImpl;
 import org.eclipse.emf.cdo.internal.protocol.revision.CDORevisionImpl;
+import org.eclipse.emf.cdo.protocol.model.CDOClass;
+import org.eclipse.emf.cdo.protocol.model.CDOFeature;
 
 /**
  * @author Eike Stepper
@@ -20,6 +25,22 @@ public interface IStoreWriter extends IStoreReader
 {
   public IView getView();
 
+  /**
+   * Stores a complete description of a package so that it can be restored to an
+   * identical state at a later point in time.
+   * <p>
+   * <b>Note:</b> The implementor of this method must not assume that
+   * references to classes in this package or in any other package are already
+   * resolved or are resolveable at the point in time when this method is called
+   * by the framework. References to classes frequently appear in
+   * {@link CDOClass#getSuperTypes()} and in
+   * {@link CDOFeature#getReferenceType()}. Instead
+   * {@link CDOClassImpl#getSuperTypeProxies()} and
+   * {@link CDOFeatureImpl#getReferenceTypeProxy()} should be used.
+   * <p>
+   * 
+   * @see CDOClassProxy#getClassRef()
+   */
   public void writePackage(CDOPackageImpl cdoPackage);
 
   public void writeRevision(CDORevisionImpl revision);