diff --git a/core/modules/field/field.attach.inc b/core/modules/field/field.attach.inc
index baa7ff4..6c543c1 100644
--- a/core/modules/field/field.attach.inc
+++ b/core/modules/field/field.attach.inc
@@ -1410,7 +1410,7 @@ function field_attach_prepare_view($entity_type, array $entities, array $display
  * Returns a renderable array for the fields on an entity.
  *
  * Each field is displayed according to the display options specified in the
- * instance definition for the given view mode.
+ * $display parameter for the given view mode.
  *
  * field_attach_prepare_view() and field_attach_view() are two halves of the
  * same operation. It is safe to call field_attach_prepare_view() multiple times
@@ -1439,7 +1439,7 @@ function field_attach_prepare_view($entity_type, array $entities, array $display
  * );
  * @endcode
  *
- * @param Drupal\Core\Entity\EntityInterface $entity
+ * @param \Drupal\Core\Entity\EntityInterface $entity
  *   The entity with fields to render.
  * @param \Drupal\entity\Plugin\Core\Entity\EntityDisplay $display
  *   The entity display object.
@@ -1448,7 +1448,7 @@ function field_attach_prepare_view($entity_type, array $entities, array $display
  *   provided the current language is used.
  * @param array $options
  *   An associative array of additional options. See field_invoke_method() for
- *   details.
+ *   details. Note: key "langcode" will be overriden inside this function.
  *
  * @return array
  *   A renderable array for the field values.