Issue #1662950 by bxtaylor, chx, mjonesdinero: Add note to EntityFieldQuery methods that exclude rows where fields are empty

1 files changed, 6 insertions, 1 deletions

diff --git a/includes/entity.inc b/includes/entity.inc
index ae7807794..96cc6e0ba 100644
--- a/includes/entity.inc
+++ b/includes/entity.inc
@@ -634,6 +634,9 @@ class EntityFieldQuery {
 
   /**
    * Adds a condition on field values.
+   * 
+   * Note that entities with empty field values will be excluded from the
+   * EntityFieldQuery results when using this method.
    *
    * @param $field
    *   Either a field name or a field array.
@@ -858,7 +861,9 @@ class EntityFieldQuery {
    * Orders the result set by a given field column.
    *
    * If called multiple times, the query will order by each specified column in
-   * the order this method is called.
+   * the order this method is called. Note that entities with empty field
+   * values will be excluded from the EntityFieldQuery results when using this
+   * method.
    *
    * @param $field
    *   Either a field name or a field array.