Docs: Fix some formatting in the hook doc for the `wp_calculate_image_srcset` filter and clarify the summary.

See #34612.

Built from https://develop.svn.wordpress.org/trunk@35592


git-svn-id: http://core.svn.wordpress.org/trunk@35556 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/media.php

@@ -1070,18 +1070,19 @@ function wp_calculate_image_srcset( $size_array, $image_src, $image_meta, $attac
 	}
 
 	/**
-	 * Filter the output of 'wp_calculate_image_srcset()'.
+	 * Filter an image's 'srcset' sources.
 	 *
 	 * @since 4.4.0
 	 *
 	 * @param array  $sources {
-	 *     An array of sources to include in the 'srcset'.
+	 *     One or more arrays of source data to include in the 'srcset'.
 	 *
 	 *     @type type array $width {
-	 *          @type type string $url        The URL of an image source in the .
-	 *          @type type string $descriptor The descriptor type used in the image candidate string, either 'w' or 'x'.
-	 *          @type type int    $value      The source width, if paired with a 'w' descriptor or a pixel density value
-	 *                                        if paired with an 'x' descriptor.
+	 *          @type type string $url        The URL of an image source.
+	 *          @type type string $descriptor The descriptor type used in the image candidate string,
+	 *                                        either 'w' or 'x'.
+	 *          @type type int    $value      The source width, if paired with a 'w' descriptor or a
+	 *                                        pixel density value if paired with an 'x' descriptor.
 	 *     }
 	 * }
 	 * @param array  $size_array    Array of width and height values in pixels (in that order).

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.4-beta3-35591';
+$wp_version = '4.4-beta3-35592';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.