diff --git a/core/modules/file/file.api.php b/core/modules/file/file.api.php
index 71039b1..5e0b17d 100644
--- a/core/modules/file/file.api.php
+++ b/core/modules/file/file.api.php
@@ -19,11 +19,6 @@
  * @param Drupal\Core\File\File $file
  *   The file entity that is being requested.
  *
- * @return
- *   TRUE is access should be allowed by this entity or FALSE if denied. Note
- *   that denial may be overridden by another entity controller, making this
- *   grant permissive rather than restrictive.
- *
  * @see hook_field_access().
  */
 function hook_file_download_access($field, Drupal\entity\EntityInterface $entity, Drupal\Core\File\File $file) {
@@ -51,12 +46,6 @@ function hook_file_download_access($field, Drupal\entity\EntityInterface $entity
  *   - entity: The entity which references the file.
  *   - file: The file entity that is being requested.
  *
- * @return
- *   An array of grants, keyed by module name, each with a Boolean grant value.
- *   Return an empty array to assert FALSE. You may choose to return your own
- *   module's value in addition to other grants or to overwrite the values set
- *   by other modules.
- *
  * @see hook_file_download_access().
  */
 function hook_file_download_access_alter(&$grants, $context) {