diff --git a/core/modules/field/field.deprecated.inc b/core/modules/field/field.deprecated.inc
index 35a3436..b018c7b 100644
--- a/core/modules/field/field.deprecated.inc
+++ b/core/modules/field/field.deprecated.inc
@@ -483,10 +483,6 @@ function field_read_instances($conditions = array(), $include_additional = array
  *   // most common case), and will therefore be repeated as many times as
  *   // needed, or 'multiple-values' (one single widget allows the input of
  *   // several values, e.g checkboxes, select box...).
- *   // The sub-array is nested into a $langcode key where $langcode has the
- *   // same value of the $langcode parameter above.
- *   // The '#language' key holds the same value of $langcode and it is used
- *   // to access the field sub-array when $langcode is unknown.
  *   'field_foo' => array(
  *     '#access' => TRUE if the current user has 'edit' grants for the field,
  *       FALSE if not.
diff --git a/core/modules/field/lib/Drupal/field/Tests/FieldTestBase.php b/core/modules/field/lib/Drupal/field/Tests/FieldTestBase.php
index c2acc89..b871eb2 100644
--- a/core/modules/field/lib/Drupal/field/Tests/FieldTestBase.php
+++ b/core/modules/field/lib/Drupal/field/Tests/FieldTestBase.php
@@ -11,7 +11,6 @@
 use Drupal\Core\Language\Language;
 use Drupal\simpletest\WebTestBase;
 
-
 /**
  * Parent class for Field API tests.
  */
@@ -46,9 +45,10 @@ function _generateTestFieldValues($cardinality) {
    * @param $expected_values
    *   The array of expected values.
    * @param $langcode
-   *   The language code for the values.
+   *   (Optional) The language code for the values. Defaults to
+   *   Drupal\Core\Language\Language::LANGCODE_NOT_SPECIFIED.
    * @param $column
-   *   (Optional) the name of the column to check.
+   *   (Optional) The name of the column to check. Defaults to 'value'.
    */
   function assertFieldValues(EntityInterface $entity, $field_name, $expected_values, $langcode = Language::LANGCODE_NOT_SPECIFIED, $column = 'value') {
     // Re-load the entity to make sure we have the latest changes.
diff --git a/core/modules/field/lib/Drupal/field/Tests/FieldUnitTestBase.php b/core/modules/field/lib/Drupal/field/Tests/FieldUnitTestBase.php
index 2bad37d..b619aa2 100644
--- a/core/modules/field/lib/Drupal/field/Tests/FieldUnitTestBase.php
+++ b/core/modules/field/lib/Drupal/field/Tests/FieldUnitTestBase.php
@@ -142,9 +142,10 @@ function _generateTestFieldValues($cardinality) {
    * @param $expected_values
    *   The array of expected values.
    * @param $langcode
-   *   The language code for the values.
+   *   (Optional) The language code for the values. Defaults to
+   *   Drupal\Core\Language\Language::LANGCODE_NOT_SPECIFIED.
    * @param $column
-   *   (Optional) the name of the column to check.
+   *   (Optional) The name of the column to check. Defaults to 'value'.
    */
   function assertFieldValues(EntityInterface $entity, $field_name, $expected_values, $langcode = Language::LANGCODE_NOT_SPECIFIED, $column = 'value') {
     // Re-load the entity to make sure we have the latest changes.