summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDries Buytaert <dries@buytaert.net>2010-02-13 21:05:31 +0000
committerDries Buytaert <dries@buytaert.net>2010-02-13 21:05:31 +0000
commit7610357974572da9fcff5a213527b6fbaa811b9e (patch)
tree7d52c8cf66a72f096041cee6a2cc7a2c1f621398
parentecc88643639db7426de115d241d843a0f1492656 (diff)
downloadbrdo-7610357974572da9fcff5a213527b6fbaa811b9e.tar.gz
brdo-7610357974572da9fcff5a213527b6fbaa811b9e.tar.bz2
- Patch #712564 by yched: fixed formatting of documentation in field_attach_query().
-rw-r--r--modules/field/field.attach.inc42
1 files changed, 19 insertions, 23 deletions
diff --git a/modules/field/field.attach.inc b/modules/field/field.attach.inc
index d62b6dcb3..204c1fb25 100644
--- a/modules/field/field.attach.inc
+++ b/modules/field/field.attach.inc
@@ -1043,33 +1043,29 @@ function field_attach_delete_revision($entity_type, $entity) {
* @endcode
* @param $options
* An associative array of additional options:
- * - limit: The number of results that is requested. This is only a
- * hint to the storage engine(s); callers should be prepared to
- * handle fewer or more results. Specify FIELD_QUERY_NO_LIMIT to retrieve
- * all available entities. This option has a default value of 0 so
- * callers must make an explicit choice to potentially retrieve an
- * enormous result set.
- * - cursor: A reference to an opaque cursor that allows a caller to
- * iterate through multiple result sets. On the first call, pass 0;
- * the correct value to pass on the next call will be written into
- * the value on return. When there is no more query data available,
- * the value will be filled in with FIELD_QUERY_COMPLETE. If cursor
- * is passed as NULL, the first result set is returned and no next
- * cursor is returned.
- * - count: If TRUE, return a single count of all matching entities;
- * limit and cursor are ignored.
- * - age: Internal use only. Use field_attach_query_revisions()
- * instead of passing FIELD_LOAD_REVISION.
+ * - limit: The number of results that is requested. This is only a hint to
+ * the storage engine(s); callers should be prepared to handle fewer or
+ * more results. Specify FIELD_QUERY_NO_LIMIT to retrieve all available
+ * entities. This option has a default value of 0 so callers must make an
+ * explicit choice to potentially retrieve an enormous result set.
+ * - cursor: A reference to an opaque cursor that allows a caller to iterate
+ * through multiple result sets. On the first call, pass 0; the correct
+ * value to pass on the next call will be written into the value on return.
+ * When there is no more query data available, the value will be filled in
+ * with FIELD_QUERY_COMPLETE. If cursor is passed as NULL, the first result
+ * set is returned and no next cursor is returned.
+ * - count: If TRUE, return a single count of all matching entities; limit and
+ * cursor are ignored.
+ * - age: Internal use only. Use field_attach_query_revisions() instead of
+ * passing FIELD_LOAD_REVISION.
* - FIELD_LOAD_CURRENT (default): query the most recent revisions for all
- * entities. The results will be keyed by entity type and entity id.
+ * entities. The results will be keyed by entity type and entity id.
* - FIELD_LOAD_REVISION: query all revisions. The results will be keyed by
- * entity type and entity revision id.
+ * entity type and entity revision id.
* @return
* An array keyed by entity type (e.g. 'node', 'user'...), then by entity id
- * or revision id (depending of the value of the $age parameter).
- * The values are pseudo-entities with the bundle, id, and revision
- * id fields filled in.
- *
+ * or revision id (depending of the value of the $age parameter). The values
+ * are pseudo-entities with the bundle, id, and revision id fields filled in.
* Throws a FieldQueryException if the field's storage doesn't support the
* specified conditions.
*/