diff --git a/core/lib/Drupal/Core/Database/Schema.php b/core/lib/Drupal/Core/Database/Schema.php
index fc4d5a3..42abe5b 100644
--- a/core/lib/Drupal/Core/Database/Schema.php
+++ b/core/lib/Drupal/Core/Database/Schema.php
@@ -554,14 +554,14 @@ public function fieldExists($table, $column) {
    * @param $name
    *   The name of the index.
    * @param $fields
-   *   An array of field names. An array can be used as a field name, in which
-   *   case the first item should be the actual field name, and the second item
-   *   is the length the index should be constrained to. For example, the
-   *   following will use the full length of the `foo` field, but limit the
-   *   `bar` field to 4 characters:
-   * @code
-   *   $fields = ['foo', ['bar', 4]];
-   * @endcode
+   *   An array of field names or field information; if field information is
+   *   passed, it's an array whose first element is the field name and whose
+   *   second is the maximum length in the index. For example, the following
+   *   will use the full length of the `foo` field, but limit the `bar` field to
+   *   4 characters:
+   *   @code
+   *     $fields = ['foo', ['bar', 4]];
+   *   @endcode
    *
    * @throws \Drupal\Core\Database\SchemaObjectDoesNotExistException
    *   If the specified table doesn't exist.