diff -u b/core/modules/field/field.api.php b/core/modules/field/field.api.php
--- b/core/modules/field/field.api.php
+++ b/core/modules/field/field.api.php
@@ -304,17 +304,17 @@
 /**
  * Specifies the allowed values list for a field.
  *
- * @param FieldDefinitionInterface $field_definition
+ * @param \Drupal\Core\Field\FieldDefinitionInterface $field_definition
  *   The field definition.
- * @param EntityInterface $entity
- *    The entity object.
- * @param boolean $cacheable
- *    Specifies whether or not the allowed values will be statically cached.
- *    Defaults to FALSE, set to TRUE to cache the values.
+ * @param \Drupal\Core\Entity\EntityInterface $entity
+ *   The entity object.
+ * @param bool $cacheable
+ *   Specifies whether or not the allowed values will be statically cached.
+ *   Defaults to FALSE, set to TRUE to cache the values.
  *
- * @return
- *  Array An associative array with keys and values to use as the key|label setting(s)
- *  on a field's allowed value list.
+ * @return array
+ *   An associative array with keys and values to use as the key|label setting(s)
+ *   on a field's allowed value list.
  *
  * @ingroup callbacks
  */