Clarify contract of EntityDocument::isEmpty (#743)

thiemowmde · web-flow · commit 9379f988be7f · 2017-08-02T14:09:49.000+02:00
diff --git a/src/Entity/EntityDocument.php b/src/Entity/EntityDocument.php
@@ -47,7 +47,11 @@ public function getId();
 	public function setId( $id );
 
 	/**
-	 * Returns true if the entity has no content. Having an id set does not count as having content.
+	 * An entity is considered empty if it does not contain any content that can be removed. Having
+	 * an ID set never counts as having content.
+	 *
+	 * Knowing if an entity is empty is relevant when, for example, moving or merging entities and
+	 * code wants to make sure all content is transferred from the old to the new entity.
 	 *
 	 * @since 4.3
 	 *

Original file line number	Diff line number	Diff line change
`@@ -47,7 +47,11 @@ public function getId();`
`47`	`47`	`public function setId( $id );`
`48`	`48`
`49`	`49`	`/**`
`50`		`- * Returns true if the entity has no content. Having an id set does not count as having content.`
	`50`	`+ * An entity is considered empty if it does not contain any content that can be removed. Having`
	`51`	`+ * an ID set never counts as having content.`
	`52`	`+ *`
	`53`	`+ * Knowing if an entity is empty is relevant when, for example, moving or merging entities and`
	`54`	`+ * code wants to make sure all content is transferred from the old to the new entity.`
`51`	`55`	`*`
`52`	`56`	`* @since 4.3`
`53`	`57`	`*`