adding comments to update methods

51 files changed, 289 insertions, 32 deletions

diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAssociationOverride.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAssociationOverride.java
index 65223ad17f..ceb50d2e7b 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAssociationOverride.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAssociationOverride.java
@@ -34,6 +34,10 @@ public interface JavaAssociationOverride extends AssociationOverride, JavaJpaCon
 	
 	void initialize(AssociationOverrideAnnotation associationOverride);
 	
+	/**
+	 * Update the JavaAssociationOverride context model object to match the AssociationOverrideAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(AssociationOverrideAnnotation associationOverride);
 	
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeMapping.java
index 3d3c569e83..a718008469 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeMapping.java
@@ -26,9 +26,13 @@ public interface JavaAttributeMapping extends AttributeMapping, JavaJpaContextNo
 {
 	JavaPersistentAttribute getPersistentAttribute();
 	
-	void initialize(JavaResourcePersistentAttribute resourcePersistentAttribute);
+	void initialize(JavaResourcePersistentAttribute jrpa);
 
-	void update(JavaResourcePersistentAttribute resourcePersistentAttribute);
+	/**
+	 * Update the JavaAttributeMapping context model object to match the JavaResourcePersistentAttribute 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(JavaResourcePersistentAttribute jrpa);
 	
 	String getAnnotationName();
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeOverride.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeOverride.java
index 9e5a5bc335..d5056fcaff 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeOverride.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaAttributeOverride.java
@@ -27,6 +27,10 @@ public interface JavaAttributeOverride extends AttributeOverride, JavaJpaContext
 	
 	void initialize(AttributeOverrideAnnotation attributeOverride);
 	
+	/**
+	 * Update the JavaAttributeOverride context model object to match the AttributeOverrideAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(AttributeOverrideAnnotation attributeOverride);
 	
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaColumn.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaColumn.java
index 9e1368ba6a..c87d53847e 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaColumn.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaColumn.java
@@ -23,9 +23,13 @@ import org.eclipse.jpt.core.resource.java.ColumnAnnotation;
  */
 public interface JavaColumn extends Column, JavaBaseColumn
 {
-	void initialize(ColumnAnnotation columnResource);
+	void initialize(ColumnAnnotation resourceColumn);
 	
-	void update(ColumnAnnotation columnResource);
+	/**
+	 * Update the JavaColumn context model object to match the ColumnAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(ColumnAnnotation resourceColumn);
 	
 	boolean connectionProfileIsActive();
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaDiscriminatorColumn.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaDiscriminatorColumn.java
index fbc0c9c3c3..17cd6fc18d 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaDiscriminatorColumn.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaDiscriminatorColumn.java
@@ -23,8 +23,12 @@ import org.eclipse.jpt.core.resource.java.JavaResourcePersistentMember;
  */
 public interface JavaDiscriminatorColumn extends JavaNamedColumn, DiscriminatorColumn
 {	
-	void initialize(JavaResourcePersistentMember persistentResource);
+	void initialize(JavaResourcePersistentMember jrpm);
 	
-	void update(JavaResourcePersistentMember persistentResource);
+	/**
+	 * Update the JavaDiscriminatorColumn context model object to match the JavaResourcePersistentMember 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(JavaResourcePersistentMember jrpm);
 
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaGeneratedValue.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaGeneratedValue.java
index a88906c450..368a554157 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaGeneratedValue.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaGeneratedValue.java
@@ -31,8 +31,12 @@ public interface JavaGeneratedValue extends GeneratedValue, JavaJpaContextNode
 	 */
 	TextRange getGeneratorTextRange(CompilationUnit astRoot);
 	
-	void initialize(GeneratedValueAnnotation generatedValue);
+	void initialize(GeneratedValueAnnotation resourceGeneratedValue);
 	
-	void update(GeneratedValueAnnotation generatedValue);
+	/**
+	 * Update the JavaGeneratedValue context model object to match the GeneratedValueAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(GeneratedValueAnnotation resourceGeneratedValue);
 
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinColumn.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinColumn.java
index 301c43c31f..c890c20ff3 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinColumn.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinColumn.java
@@ -23,11 +23,15 @@ import org.eclipse.jpt.core.resource.java.JoinColumnAnnotation;
  */
 public interface JavaJoinColumn extends JoinColumn, JavaBaseJoinColumn, JavaBaseColumn
 {
-	void initialize(JoinColumnAnnotation joinColumn);
+	void initialize(JoinColumnAnnotation resourceJoinColumn);
 	
 	boolean connectionProfileIsActive();
 	
-	void update(JoinColumnAnnotation joinColumn);
+	/**
+	 * Update the JavaJoinColumn context model object to match the JoinColumnAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(JoinColumnAnnotation resourceJoinColumn);
 
 	Owner getOwner();
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinTable.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinTable.java
index 28170ad323..751c3b1eaf 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinTable.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaJoinTable.java
@@ -24,9 +24,13 @@ import org.eclipse.jpt.core.resource.java.JavaResourcePersistentAttribute;
  */
 public interface JavaJoinTable extends JoinTable, JavaJpaContextNode
 {
-	void initialize(JavaResourcePersistentAttribute attributeResource);
+	void initialize(JavaResourcePersistentAttribute jrpa);
 	
-	void update(JavaResourcePersistentAttribute attributeResource);
+	/**
+	 * Update the JavaJoinTable context model object to match the JavaResourcePersistentAttribute 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(JavaResourcePersistentAttribute jrpa);
 	
 	boolean isSpecified();
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedNativeQuery.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedNativeQuery.java
index 1ee28cf71a..15a3d216b1 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedNativeQuery.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedNativeQuery.java
@@ -28,8 +28,12 @@ public interface JavaNamedNativeQuery
 
 	ListIterator<JavaQueryHint> hints();
 
-	void initialize(NamedNativeQueryAnnotation queryResource);
+	void initialize(NamedNativeQueryAnnotation resourceQuery);
 
-	void update(NamedNativeQueryAnnotation queryResource);
+	/**
+	 * Update the JavaNamedNativeQuery context model object to match the NamedNativeQueryAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(NamedNativeQueryAnnotation resourceQuery);
 
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedQuery.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedQuery.java
index 3d66fe550f..78e77bb613 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedQuery.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaNamedQuery.java
@@ -28,8 +28,12 @@ public interface JavaNamedQuery
 
 	ListIterator<JavaQueryHint> hints();
 
-	void initialize(NamedQueryAnnotation queryResource);
+	void initialize(NamedQueryAnnotation resourceNamedQuery);
 
-	void update(NamedQueryAnnotation queryResource);
+	/**
+	 * Update the JavaNamedQuery context model object to match the NamedQueryAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(NamedQueryAnnotation resourceNamedQuery);
 
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPersistentType.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPersistentType.java
index ead375e1cd..08859cb61b 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPersistentType.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPersistentType.java
@@ -45,6 +45,10 @@ public interface JavaPersistentType extends PersistentType, JavaJpaContextNode
 	boolean hasAnyAttributeMappingAnnotations();
 
 	
-	void update(JavaResourcePersistentType persistentTypeResource);
+	/**
+	 * Update the JavaPersistentType context model object to match the JavaResourcePersistentType 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(JavaResourcePersistentType jrpt);
 
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPrimaryKeyJoinColumn.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPrimaryKeyJoinColumn.java
index 75e6eee6d9..62f06acdb0 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPrimaryKeyJoinColumn.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaPrimaryKeyJoinColumn.java
@@ -25,6 +25,10 @@ public interface JavaPrimaryKeyJoinColumn extends PrimaryKeyJoinColumn, JavaBase
 {
 	void initialize(PrimaryKeyJoinColumnAnnotation primaryKeyJoinColumn);
 	
+	/**
+	 * Update the JavaPrimaryKeyJoinColumn context model object to match the PrimaryKeyJoinColumnAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(PrimaryKeyJoinColumnAnnotation primaryKeyJoinColumn);
 
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaQueryHint.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaQueryHint.java
index 6b61c61efb..452833bf27 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaQueryHint.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaQueryHint.java
@@ -23,7 +23,11 @@ import org.eclipse.jpt.core.resource.java.QueryHintAnnotation;
  */
 public interface JavaQueryHint extends QueryHint, JavaJpaContextNode
 {
-	void initialize(QueryHintAnnotation queryHint);
+	void initialize(QueryHintAnnotation queryHintResource);
 	
-	void update(QueryHintAnnotation queryHint);
+	/**
+	 * Update the JavaQueryHint context model object to match the QueryHintAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(QueryHintAnnotation queryHintResource);
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSecondaryTable.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSecondaryTable.java
index 9281068c7d..fab4a97cc0 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSecondaryTable.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSecondaryTable.java
@@ -25,9 +25,13 @@ import org.eclipse.jpt.core.resource.java.SecondaryTableAnnotation;
 public interface JavaSecondaryTable extends SecondaryTable, JavaJpaContextNode
 {
 
-	void initialize(SecondaryTableAnnotation secondaryTable);
+	void initialize(SecondaryTableAnnotation secondaryTableResource);
 	
-	void update(SecondaryTableAnnotation secondaryTable);
+	/**
+	 * Update the JavaSecondaryTable context model object to match the SecondaryTableAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(SecondaryTableAnnotation secondaryTableResource);
 
 
 	//****************** covariant overrides *******************
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSequenceGenerator.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSequenceGenerator.java
index 1ca0672029..428324e7e5 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSequenceGenerator.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaSequenceGenerator.java
@@ -25,8 +25,12 @@ public interface JavaSequenceGenerator
 	extends JavaGenerator, SequenceGenerator
 {
 
-	void initialize(SequenceGeneratorAnnotation generator);
+	void initialize(SequenceGeneratorAnnotation generatorResource);
 	
-	void update(SequenceGeneratorAnnotation generator);
+	/**
+	 * Update the JavaSequenceGenerator context model object to match the SequenceGeneratorAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(SequenceGeneratorAnnotation generatorResource);
 
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTable.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTable.java
index 4fa93908d7..6e0511d678 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTable.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTable.java
@@ -24,9 +24,13 @@ import org.eclipse.jpt.core.resource.java.JavaResourcePersistentMember;
  */
 public interface JavaTable extends Table, JavaJpaContextNode
 {
-	void initialize(JavaResourcePersistentMember persistentResource);
+	void initialize(JavaResourcePersistentMember jrpm);
 	
-	void update(JavaResourcePersistentMember persistentResource);
+	/**
+	 * Update the JavaTable context model object to match the JavaResourcePersistentMember 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(JavaResourcePersistentMember jrpm);
 
 	
 	//****************** covariant overrides *******************
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTableGenerator.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTableGenerator.java
index c10db1d1fe..9a1273adbf 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTableGenerator.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTableGenerator.java
@@ -25,9 +25,13 @@ import org.eclipse.jpt.core.resource.java.TableGeneratorAnnotation;
 public interface JavaTableGenerator
 	extends JavaGenerator, TableGenerator
 {
-	void initialize(TableGeneratorAnnotation generator);
+	void initialize(TableGeneratorAnnotation resourceGenerator);
 	
-	void update(TableGeneratorAnnotation generator);
+	/**
+	 * Update the JavaTableGenerator context model object to match the TableGeneratorAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(TableGeneratorAnnotation resourceGenerator);
 	
 	
 	//****************** covariant overrides *******************
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTypeMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTypeMapping.java
index 09cbcf4850..10ef63df07 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTypeMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaTypeMapping.java
@@ -24,9 +24,13 @@ import org.eclipse.jpt.core.resource.java.JavaResourcePersistentType;
  */
 public interface JavaTypeMapping extends TypeMapping, JavaJpaContextNode
 {
-	void initialize(JavaResourcePersistentType persistentTypeResource);
+	void initialize(JavaResourcePersistentType jrpt);
 	
-	void update(JavaResourcePersistentType persistentTypeResource);
+	/**
+	 * Update the JavaTypeMapping context model object to match the JavaResourcePersistentType 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(JavaResourcePersistentType jrpt);
 	
 	String getAnnotationName();
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaUniqueConstraint.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaUniqueConstraint.java
index 4a26ef2829..c157e2b096 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaUniqueConstraint.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/java/JavaUniqueConstraint.java
@@ -25,5 +25,9 @@ public interface JavaUniqueConstraint extends UniqueConstraint, JavaJpaContextNo
 {
 	void initialize(UniqueConstraintAnnotation uniqueConstraintAnnotation);
 	
+	/**
+	 * Update the JavaUniqueConstraint context model object to match the UniqueConstraintAnnotation 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(UniqueConstraintAnnotation uniqueConstraintAnnotation);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/EntityMappings.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/EntityMappings.java
index bb87aa4188..5437095af1 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/EntityMappings.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/EntityMappings.java
@@ -125,6 +125,10 @@ public interface EntityMappings extends OrmJpaContextNode, JpaStructureNode, Que
 	
 	// **************** updating ***********************************************
 		
+	/**
+	 * Update the EntityMappings context model object to match the XmlEntityMappings 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEntityMappings entityMappings);
 	
 	// *************************************************************************
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAssociationOverride.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAssociationOverride.java
index 322aef911d..5a3f5818be 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAssociationOverride.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAssociationOverride.java
@@ -35,5 +35,9 @@ public interface OrmAssociationOverride extends AssociationOverride, OrmJpaConte
 
 	OrmJoinColumn addSpecifiedJoinColumn(int index);
 
+	/**
+	 * Update the OrmAssociationOverride context model object to match the XmlAssociationOverride 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlAssociationOverride associationOverride);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAttributeOverride.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAttributeOverride.java
index 81646f55d3..ec915e6955 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAttributeOverride.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmAttributeOverride.java
@@ -25,5 +25,9 @@ public interface OrmAttributeOverride extends AttributeOverride, OrmJpaContextNo
 {
 	OrmColumn getColumn();
 
+	/**
+	 * Update the OrmAttributeOverride context model object to match the XmlAttributeOverride 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlAttributeOverride attributeOverride);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmBasicMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmBasicMapping.java
index 13f90b1bae..ca0d425e77 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmBasicMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmBasicMapping.java
@@ -25,5 +25,9 @@ public interface OrmBasicMapping extends BasicMapping, OrmAttributeMapping, OrmC
 {
 	void initialize(XmlBasic basic);
 
+	/**
+	 * Update the OrmBasicMapping context model object to match the XmlBasic 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlBasic basic);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmDiscriminatorColumn.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmDiscriminatorColumn.java
index a600159205..c875e79a40 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmDiscriminatorColumn.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmDiscriminatorColumn.java
@@ -25,5 +25,9 @@ public interface OrmDiscriminatorColumn extends DiscriminatorColumn, OrmNamedCol
 {
 	void initialize(XmlEntity entity);
 
+	/**
+	 * Update the OrmDiscriminatorColumn context model object to match the XmlEntity 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEntity entity);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddable.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddable.java
index f4b8b08b08..a99f745896 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddable.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddable.java
@@ -26,6 +26,10 @@ public interface OrmEmbeddable extends Embeddable, OrmTypeMapping
 {
 	void initialize(XmlEmbeddable mappedSuperclass);
 
+	/**
+	 * Update the OrmEmbeddable context model object to match the XmlEmbeddable 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEmbeddable mappedSuperclass);
 	
 	Iterator<OrmPersistentAttribute> overridableAttributes();
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedIdMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedIdMapping.java
index 992298aa4b..9bd633b9d1 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedIdMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedIdMapping.java
@@ -30,5 +30,9 @@ public interface OrmEmbeddedIdMapping extends EmbeddedIdMapping, OrmBaseEmbedded
 
 	void initialize(XmlEmbeddedId embeddedId);
 
-	 void update(XmlEmbeddedId embeddedId);
+	/**
+	 * Update the OrmEmbeddedIdMapping context model object to match the XmlEmbeddedId 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(XmlEmbeddedId embeddedId);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedMapping.java
index f460a6f186..cd385bba4d 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEmbeddedMapping.java
@@ -30,5 +30,9 @@ public interface OrmEmbeddedMapping extends EmbeddedMapping, OrmBaseEmbeddedMapp
 
 	void initialize(XmlEmbedded embedded);
 
+	/**
+	 * Update the OrmEmbeddedMapping context model object to match the XmlEmbedded 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEmbedded embedded);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEntity.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEntity.java
index 1d848475ea..5b8f3d78c8 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEntity.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmEntity.java
@@ -68,6 +68,10 @@ public interface OrmEntity extends OrmTypeMapping, Entity, OrmGeneratorHolder
 
 	void initialize(XmlEntity entity);
 
+	/**
+	 * Update the OrmEntity context model object to match the XmlEntity 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEntity entity);
 	
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmIdMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmIdMapping.java
index e76327388a..92f46e919d 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmIdMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmIdMapping.java
@@ -28,5 +28,9 @@ public interface OrmIdMapping extends IdMapping, OrmColumnMapping, OrmAttributeM
 	
 	void initialize(XmlId id);
 
+	/**
+	 * Update the OrmIdMapping context model object to match the XmlId 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlId id);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmJoinTable.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmJoinTable.java
index 717941f229..7dde618530 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmJoinTable.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmJoinTable.java
@@ -29,6 +29,10 @@ public interface OrmJoinTable extends JoinTable, OrmJpaContextNode
 
 	void initialize(XmlRelationshipMapping relationshipMapping);
 
+	/**
+	 * Update the OrmJoinTable context model object to match the XmlRelationshipMapping 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlRelationshipMapping relationshipMapping);
 		
 	void initializeFrom(JoinTable oldJoinTable);
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToManyMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToManyMapping.java
index 3d0fa79d34..d1a3d44b72 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToManyMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToManyMapping.java
@@ -26,5 +26,9 @@ public interface OrmManyToManyMapping extends ManyToManyMapping, OrmMultiRelatio
 
 	void initialize(XmlManyToMany xmlManyToMany);
 
+	/**
+	 * Update the OrmManyToManyMapping context model object to match the XmlManyToMany 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlManyToMany xmlManyToMany);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToOneMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToOneMapping.java
index 9b33b8974f..87567f33a2 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToOneMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmManyToOneMapping.java
@@ -30,6 +30,10 @@ public interface OrmManyToOneMapping extends ManyToOneMapping, OrmSingleRelation
 
 	void initialize(XmlManyToOne xmlManyToOne);
 
+	/**
+	 * Update the OrmManyToOneMapping context model object to match the XmlManyToOne 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlManyToOne xmlManyToOne);
 
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmMappedSuperclass.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmMappedSuperclass.java
index 458a889016..894e0ffecd 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmMappedSuperclass.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmMappedSuperclass.java
@@ -26,6 +26,10 @@ public interface OrmMappedSuperclass extends MappedSuperclass, OrmTypeMapping
 {
 	void initialize(XmlMappedSuperclass mappedSuperclass);
 
+	/**
+	 * Update the OrmMappedSuperclass context model object to match the XmlMappedSuperclass 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlMappedSuperclass mappedSuperclass);
 	
 	Iterator<OrmPersistentAttribute> overridableAttributes();
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToManyMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToManyMapping.java
index bb0560abf4..3d2e27bff3 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToManyMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToManyMapping.java
@@ -26,6 +26,10 @@ public interface OrmOneToManyMapping extends OneToManyMapping, OrmMultiRelations
 
 	void initialize(XmlOneToMany xmlOneToMany);
 
+	/**
+	 * Update the OrmOneToManyMapping context model object to match the XmlOneToMany 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlOneToMany xmlOneToMany);
 	
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToOneMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToOneMapping.java
index 9be2aabad9..f3a80fdc4d 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToOneMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmOneToOneMapping.java
@@ -27,6 +27,10 @@ public interface OrmOneToOneMapping extends OneToOneMapping, OrmSingleRelationsh
 
 	void initialize(XmlOneToOne oneToOne);
 
+	/**
+	 * Update the OrmOneToOneMapping context model object to match the XmlOneToOne 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlOneToOne oneToOne);
 	
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentAttribute.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentAttribute.java
index 0cadf3e218..5fe5ec197d 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentAttribute.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentAttribute.java
@@ -114,26 +114,70 @@ public interface OrmPersistentAttribute extends PersistentAttribute, OrmJpaConte
 	
 	void initialize(XmlNullAttributeMapping xmlNullAttributeMapping);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlId 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlId id);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlEmbeddedId 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEmbeddedId embeddedId);
 
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlBasic 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlBasic basic);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlVersion 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlVersion version);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlManyToOne 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlManyToOne manyToOne);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlOneToMany 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlOneToMany oneToMany);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlOneToOne 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlOneToOne oneToOne);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlManyToMany 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlManyToMany manyToMany);
 
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlEmbedded 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEmbedded embedded);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlTransient 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlTransient transientResource);
 	
+	/**
+	 * Update the OrmPersistentAttribute context model object to match the XmlNullAttributeMapping 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlNullAttributeMapping xmlNullAttributeMapping);
 
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentType.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentType.java
index ed07de1582..3e839c9a0a 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentType.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmPersistentType.java
@@ -114,10 +114,22 @@ public interface OrmPersistentType extends PersistentType, OrmJpaContextNode
 		
 	void initialize(XmlEmbeddable embeddable);
 	
+	/**
+	 * Update the OrmPersistentType context model object to match the XmlEntity 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEntity entity);
 	
+	/**
+	 * Update the OrmPersistentType context model object to match the XmlMappedSuperclass 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlMappedSuperclass mappedSuperclass);
 	
+	/**
+	 * Update the OrmPersistentType context model object to match the XmlEmbeddable 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEmbeddable embeddable);
 
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmSecondaryTable.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmSecondaryTable.java
index 47e5cb48f4..07e10bf5ba 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmSecondaryTable.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmSecondaryTable.java
@@ -25,6 +25,10 @@ import org.eclipse.jpt.core.resource.orm.XmlSecondaryTable;
 public interface OrmSecondaryTable extends SecondaryTable, OrmJpaContextNode
 {
 
+	/**
+	 * Update the OrmSecondaryTable context model object to match the XmlSecondaryTable 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlSecondaryTable secondaryTable);
 
 	void initializeFrom(SecondaryTable oldSecondaryTable);
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTable.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTable.java
index ca0d2b794a..a3f6e709f2 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTable.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTable.java
@@ -24,9 +24,13 @@ import org.eclipse.jpt.core.resource.orm.XmlEntity;
  */
 public interface OrmTable extends Table, OrmJpaContextNode
 {
-	void initialize(XmlEntity entity);
+	void initialize(XmlEntity resourceEntity);
 
-	void update(XmlEntity entity);
+	/**
+	 * Update the OrmTable context model object to match the XmlEntity 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
+	void update(XmlEntity resourceEntity);
 
 	
 	//****************** covariant overrides *******************
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTransientMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTransientMapping.java
index 48ffec4f57..072013eea0 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTransientMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmTransientMapping.java
@@ -25,5 +25,9 @@ public interface OrmTransientMapping extends TransientMapping, OrmAttributeMappi
 {
 	void initialize(XmlTransient transientResource);
 
+	/**
+	 * Update the OrmTransientMapping context model object to match the XmlTransient 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlTransient transientResource);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmUniqueConstraint.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmUniqueConstraint.java
index 99abcc5fc0..61e2c8d200 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmUniqueConstraint.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmUniqueConstraint.java
@@ -23,5 +23,9 @@ import org.eclipse.jpt.core.resource.orm.XmlUniqueConstraint;
  */
 public interface OrmUniqueConstraint extends UniqueConstraint, OrmJpaContextNode
 {
+	/**
+	 * Update the OrmUniqueConstraint context model object to match the XmlUniqueConstraint 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlUniqueConstraint uniqueConstraint);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmVersionMapping.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmVersionMapping.java
index 36192c804f..a982145350 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmVersionMapping.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmVersionMapping.java
@@ -25,5 +25,9 @@ public interface OrmVersionMapping extends VersionMapping, OrmColumnMapping, Orm
 {
 	void initialize(XmlVersion version);
 
+	/**
+	 * Update the OrmVersionMapping context model object to match the XmlVersion 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlVersion version);
 }
\ No newline at end of file
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmXml.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmXml.java
index 5eb6af8db0..d0d9ebf483 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmXml.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/OrmXml.java
@@ -63,5 +63,9 @@ public interface OrmXml extends OrmJpaContextNode, JpaStructureNode
 
 	// **************** updating **********************************************
 	
+	/**
+	 * Update the OrmXml context model object to match the OrmResource 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(OrmResource ormResource);
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitDefaults.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitDefaults.java
index 8522fbc117..dc3282ec42 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitDefaults.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitDefaults.java
@@ -54,6 +54,10 @@ public interface PersistenceUnitDefaults extends OrmJpaContextNode
 	String CASCADE_PERSIST_PROPERTY = "cascadePersistProperty";
 	
 	
+	/**
+	 * Update the PersistenceUnitDefaults context model object to match the XmlEntityMappings 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEntityMappings entityMappings);
 
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitMetadata.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitMetadata.java
index 4b00f0561f..7bea1076fe 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitMetadata.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/orm/PersistenceUnitMetadata.java
@@ -28,6 +28,10 @@ public interface PersistenceUnitMetadata extends OrmJpaContextNode
 
 	PersistenceUnitDefaults getPersistenceUnitDefaults();
 		
+	/**
+	 * Update the PersistenceUnitMetadata context model object to match the XmlEntityMappings 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlEntityMappings entityMappings);
 
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/ClassRef.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/ClassRef.java
index 5340a0bd83..7365899181 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/ClassRef.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/ClassRef.java
@@ -71,8 +71,17 @@ public interface ClassRef extends PersistenceJpaContextNode, JpaStructureNode
 	
 	// **************** update **************************************
 	
+	/**
+	 * Update the ClassRef context model object to match the XmlJavaClassRef 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlJavaClassRef classRef);
 	
+	/**
+	 * Update the ClassRef context model object to match the className. This is used
+	 * for impliedClassRefs in the PersistenceUnit.
+	 * see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(String className);
 	
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/MappingFileRef.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/MappingFileRef.java
index 9e6fa15a5c..b48a27d9ec 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/MappingFileRef.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/MappingFileRef.java
@@ -60,6 +60,10 @@ public interface MappingFileRef extends PersistenceJpaContextNode, JpaStructureN
 	
 	// **************** udpating ***********************************************
 	
+	/**
+	 * Update the MappingFileRef context model object to match the XmlMappingFileRef 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlMappingFileRef mappingFileRef);
 	
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Persistence.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Persistence.java
index a421f0976a..9774c6bd17 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Persistence.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Persistence.java
@@ -68,6 +68,10 @@ public interface Persistence extends PersistenceJpaContextNode, JpaStructureNode
 	
 	// **************** updating ***********************************************
 		
+	/**
+	 * Update the Persistence context model object to match the XmlPersistence 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlPersistence persistence);
 	
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceUnit.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceUnit.java
index c4d7b24fee..5f144b6633 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceUnit.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceUnit.java
@@ -450,6 +450,10 @@ public interface PersistenceUnit extends PersistenceJpaContextNode, JpaStructure
 	
 	// **************** updating ***********************************************
 	
+	/**
+	 * Update the PersistenceUnit context model object to match the XmlPersistenceUnit 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlPersistenceUnit persistenceUnit);
 	
 	
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceXml.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceXml.java
index c0cbcdbc58..c977260eb1 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceXml.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/PersistenceXml.java
@@ -52,5 +52,9 @@ public interface PersistenceXml extends PersistenceJpaContextNode, JpaStructureN
 	
 	// **************** updating **********************************************
 	
+	/**
+	 * Update the PersistenceXml context model object to match the PersistenceResource 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(PersistenceResource persistenceResource);
 }
diff --git a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Property.java b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Property.java
index 272e0a3d27..6955a36d5d 100644
--- a/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Property.java
+++ b/jpa/plugins/org.eclipse.jpt.core/src/org/eclipse/jpt/core/context/persistence/Property.java
@@ -42,5 +42,9 @@ public interface Property extends PersistenceJpaContextNode
 	
 	// **************** updating ***********************************************
 		
+	/**
+	 * Update the Property context model object to match the XmlProperty 
+	 * resource model object. see {@link org.eclipse.jpt.core.JpaProject#update()}
+	 */
 	void update(XmlProperty property);
 }