diff --git a/core/modules/image/image.module b/core/modules/image/image.module
index e6a9bc89063a1d4946aa1995184a1365cd1f882f..bcccbf79def36ca3e0333de5a105ca502c257139 100644
--- a/core/modules/image/image.module
+++ b/core/modules/image/image.module
@@ -1047,7 +1047,9 @@ function image_effect_apply($image, $effect) {
  *   - style_name: The name of the style to be used to alter the original image.
  *   - uri: The path of the image file relative to the Drupal files directory.
  *     This function does not work with images outside the files directory nor
- *     with remotely hosted images.
+ *     with remotely hosted images. This should be in a format such as
+ *     'images/image.jpg', or using a stream wrapper such as
+ *     'public://images/image.jpg'.
  *   - width: The width of the source image (if known).
  *   - height: The height of the source image (if known).
  *   - alt: The alternative text for text-based browsers.