Docs: Ensure hook and duplicate hook docs directly precede all instances of the image_memory_limit filter.

Hook docs must directly precede hooks in order for the Code Reference parser to correctly identify them as such.

Fixes #36968. 

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

Author: DrewAPicture

wp-includes/class-wp-image-editor-gd.php

@@ -104,8 +104,10 @@ public function load() {
 		 * @param int|string $limit Maximum memory limit to allocate for images. Default WP_MAX_MEMORY_LIMIT.
 		 *                          Accepts an integer (bytes), or a shorthand string notation, such as '256M'.
 		 */
-		// Set artificially high because GD uses uncompressed images in memory
-		@ini_set( 'memory_limit', apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT ) );
+		$image_memory_limit = apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT );
+
+		// Set artificially high because GD uses uncompressed images in memory.
+		@ini_set( 'memory_limit', $image_memory_limit );
 
 		$this->image = @imagecreatefromstring( file_get_contents( $this->file ) );
 

wp-includes/class-wp-image-editor-imagick.php

@@ -138,8 +138,13 @@ public function load() {
 			return new WP_Error( 'error_loading_image', __('File doesn’t exist?'), $this->file );
 
 		/** This filter is documented in wp-includes/class-wp-image-editor-gd.php */
-		// Even though Imagick uses less PHP memory than GD, set higher limit for users that have low PHP.ini limits
-		@ini_set( 'memory_limit', apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT ) );
+		$image_memory_limit = apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT );
+
+		/*
+		 * Even though Imagick uses less PHP memory than GD, set higher limit
+		 * for users that have low PHP.ini limits.
+		 */
+		@ini_set( 'memory_limit', $image_memory_limit );
 
 		try {
 			$this->image = new Imagick( $this->file );

wp-includes/deprecated.php

@@ -3175,8 +3175,12 @@ function wp_load_image( $file ) {
 	if ( ! function_exists('imagecreatefromstring') )
 		return __('The GD image library is not installed.');
 
-	// Set artificially high because GD uses uncompressed images in memory
-	@ini_set( 'memory_limit', apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT ) );
+	/** This filter is documented in wp-includes/class-wp-image-editor-gd.php */
+	$image_memory_limit = apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT );
+
+	// Set artificially high because GD uses uncompressed images in memory.
+	@ini_set( 'memory_limit', $image_memory_limit );
+
 	$image = imagecreatefromstring( file_get_contents( $file ) );
 
 	if ( !is_resource( $image ) )

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.6-alpha-37591';
+$wp_version = '4.6-alpha-37592';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.