Issue #1837022 by yched: Fixed Field API comment fixes.

core/modules/field/field.info.inc

@@ -399,13 +399,13 @@ function field_info_field_by_ids() {
 /**
  * Retrieves information about field instances.
  *
- * Use of this function to retriev instances across separate bundles (i.e. when
- * the $bundle parameter is NULL) should be avoided when possible, since it
- * loads and  statically caches a potentially large array of information. Use
- * field_info_field_map() instead.
+ * Use of this function to retrieve instances across separate bundles (i.e.
+ * when the $bundle parameter is NULL) should be avoided when possible, since
+ * it loads and statically caches a potentially large array of information.
+ * Use field_info_field_map() instead.
  *
  * When retrieving the instances of a specific bundle (i.e. when both
- * $entity_type and $bundle_name are provided, the function also populates a
+ * $entity_type and $bundle_name are provided), the function also populates a
  * static cache with the corresponding field definitions, allowing fast
  * retrieval of field_info_field() later in the request.
  *

core/modules/field/lib/Drupal/field/FieldInfo.php

@@ -13,8 +13,8 @@
  * Provides field and instance definitions for the current runtime environment.
  *
  * A Drupal\field\FieldInfo object is created and statically persisted through
- * the request by the field_info_cache() function. The object properties act as
- * a "static cache" of fields and instances definitions.
+ * the request by the _field_info_field_cache() function. The object properties
+ * act as a "static cache" of fields and instances definitions.
  *
  * The preferred way to access definitions is through the getBundleInstances()
  * method, which keeps cache entries per bundle, storing both fields and
@@ -61,7 +61,7 @@ class FieldInfo {
   protected $loadedAllFields = FALSE;
 
   /**
-   * Separately tracks requested field names or IDs that do not exists.
+   * Separately tracks requested field names or IDs that do not exist.
    *
    * @var array
    */
@@ -203,9 +203,6 @@ public function getFields() {
   /**
    * Retrieves all active, non-deleted instances definitions.
    *
-   * This method does not read from nor populate the "static" and persistent
-   * caches.
-   *
    * @param $entity_type
    *   (optional) The entity type.
    *