diff -u b/includes/entity.inc b/includes/entity.inc
--- b/includes/entity.inc
+++ b/includes/entity.inc
@@ -28,8 +28,9 @@
    * @param $ids
    *   An array of entity IDs, or FALSE to load all entities.
    * @param $conditions
-   *   An array of conditions in the form 'field' => $value where each 'field'
-   *   is tested for equality against the corresponding $value.
+   *   An array of conditions. Keys are field names on the entity's base table.
+   *   Values will be compared for equality. All the comparisons will be ANDed
+   *   together. This parameter is deprecated in favour of EntityFieldQuery().
    *
    * @return
    *   An array of entity objects indexed by their ids. When no results are
@@ -239,7 +240,7 @@
    * @param $conditions
    *   An array of conditions. Keys are field names on the entity's base table.
    *   Values will be compared for equality. All the comparisons will be ANDed
-   *   together.
+   *   together. This parameter is deprecated in favour of EntityFieldQuery().
    * @param $revision_id
    *   The ID of the revision to load, or FALSE if this query is asking for the
    *   most current revision(s).