diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php
index 1981f3ad9a..3e76d1c187 100644
--- a/src/wp-includes/media.php
+++ b/src/wp-includes/media.php
@@ -271,9 +271,11 @@ function image_downsize( $id, $size = 'medium' ) {
  * @param string     $name   Image size identifier.
  * @param int        $width  Image width in pixels.
  * @param int        $height Image height in pixels.
- * @param bool|array $crop   Optional. Whether to crop images to specified width and height or resize.
- *                           An array can specify positioning of the crop area. Default false.
+ * @param bool|array $crop   Optional. If true, images will be crop without any adjustments
+ *                           in dimensions. Otherwise we should try to adjust images dimensions
+ *                           according specified width and height parameters before we crop it.
  */
+
 function add_image_size( $name, $width = 0, $height = 0, $crop = false ) {
 	global $_wp_additional_image_sizes;