From 0e598accfb1d49680eb0928287b2c2b63a71c2c6 Mon Sep 17 00:00:00 2001
From: Bob Vincent <bobvin@pillars.net>
Date: Thu, 7 Jul 2011 14:37:03 -0400
Subject: [PATCH] Document argument limits in DrupalDefaultEntityController::buildQuery() function.

---
 includes/entity.inc |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)

diff --git a/includes/entity.inc b/includes/entity.inc
index 9ee7889cfb7ca439e77cfdb44282b68e19584a0a..3264b5cab83a77fa7d2324fbc3f962e5b019ff45 100644
--- a/includes/entity.inc
+++ b/includes/entity.inc
@@ -238,6 +238,10 @@ class DrupalDefaultEntityController implements DrupalEntityControllerInterface {
    * See CommentController::buildQuery() or TaxonomyTermController::buildQuery()
    * for examples.
    *
+   * Since all the entities are loaded into memory by a single query, the
+   * arguments should be limited to avoid errors due to excessive query length,
+   * too many placeholders, or lack of physical RAM.
+   *
    * @param $ids
    *   An array of entity IDs, or FALSE to load all entities.
    * @param $conditions
-- 
1.7.4.1