? modules/field/field.bulk.update.inc
Index: modules/field/field.attach.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/field/field.attach.inc,v
retrieving revision 1.91
diff -u -F '^[fc]' -r1.91 field.attach.inc
--- modules/field/field.attach.inc	17 Jun 2010 13:44:45 -0000	1.91
+++ modules/field/field.attach.inc	5 Jul 2010 15:11:09 -0000
@@ -1036,10 +1036,16 @@ function field_attach_delete_revision($e
 /**
  * Prepare field data prior to display.
  *
- * This function must be called before field_attach_view(). It lets field
- * types and formatters load additional data needed for display, and
- * therefore accepts an array of entities to allow query optimisation when
- * displaying lists of entities.
+ * This function lets field types and formatters load additional data
+ * needed for display that is not automatically loaded during
+ * field_attach_load(). It accepts an array of entities to allow query
+ * optimisation when displaying lists of entities.
+ *
+ * This function and field_attach_view() are mutually dependent. For
+ * any specific entity, you must call this function before
+ * field_attach_view() and you must call field_attach_view() before
+ * calling this function again.
+ * @see field_attach_view()
  *
  * @param $entity_type
  *   The type of $entities; e.g. 'node' or 'user'.
@@ -1077,7 +1083,10 @@ function field_attach_prepare_view($enti
  * Each field is displayed according to the display options specified in the
  * $instance definition for the given $view_mode.
  *
- * The entity must have run through field_attach_prepare_view() beforehands.
+ * This function and field_attach_prepare_view() are mutually dependent. For
+ * any specific entity, you must call field_attach_prepare_view() before
+ * this function and you must call this function before calling
+ * field_attach_prepare_view() again.
  * @see field_attach_prepare_view()
  *
  * Sample structure: