Emoji: Add a comment to `print_emoji_detection_script()` explaining how the `include` statement works as part of the `grunt build` process.

See #31701.



git-svn-id: https://develop.svn.wordpress.org/trunk@31881 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-includes/formatting.php

@@ -4156,6 +4156,16 @@ function print_emoji_detection_script() {
 			'concatemoji' => includes_url( "js/wp-emoji-release.min.js?$version" ),
 		);
 
+		/*
+		 * If you're looking at a src version of this file, you'll see an "include"
+		 * statement below. This is used by the `grunt build` process to directly
+		 * include a minified version of wp-emoji-loader.js, instead of using the
+		 * readfile() method from above.
+		 *
+		 * If you're looking at a build version of this file, you'll see a string of
+		 * minified JavaScript. If you need to debug it, please turn on SCRIPT_DEBUG
+		 * and edit wp-emoji-loader.js directly.
+		 */
 		?>
 		<script type="text/javascript">
 			window._wpemojiSettings = <?php echo wp_json_encode( $settings ); ?>;