diff --git a/core/modules/field/field.module b/core/modules/field/field.module
index 9a7bea7..f823bb9 100644
--- a/core/modules/field/field.module
+++ b/core/modules/field/field.module
@@ -397,17 +397,13 @@ function field_entity_create(EntityInterface $entity) {
 }
 
 /**
- * Inserts a default value if no $entity->$field_name entry was provided.
+ * Inserts a default value for each entity field not having one.
  *
- * This can happen with programmatic saves, or on form-based creation where
- * the current user doesn't have 'edit' permission for the field. This is the
- * default field 'insert' operation.
- *
- * @param $entity
+ * @param \Drupal\Core\Entity\EntityInterface $entity
  *   The entity for the operation.
- * @param $langcode
- *   (optional) The field language to fill-in with the default value. Defaults
- *   to the entity language.
+ * @param string $langcode
+ *   (optional) The field language code to fill-in with the default value.
+ *   Defaults to the entity language.
  */
 function field_populate_default_values(EntityInterface $entity, $langcode = NULL) {
   $entity_type = $entity->entityType();