Inline documentation for hooks in wp-includes/class.wp-scripts.php.

DrewAPicture · DrewAPicture · commit b66192abce0a · 2014-03-26T05:47:16.000Z
Props kpdesign for a wording switcheroo. Fixes #27518. git-svn-id: https://develop.svn.wordpress.org/trunk@27731 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-includes/class.wp-scripts.php b/src/wp-includes/class.wp-scripts.php
@@ -36,6 +36,13 @@ function __construct() {
 	}
 
 	function init() {
+		/**
+		 * Fires when the WP_Scripts instance is initialized.
+		 *
+		 * @since 2.6.0
+		 *
+		 * @param WP_Scripts &$this WP_Scripts instance, passed by reference.
+		 */
 		do_action_ref_array( 'wp_default_scripts', array(&$this) );
 	}
 
@@ -97,6 +104,14 @@ function do_item( $handle, $group = false ) {
 		$src = $this->registered[$handle]->src;
 
 		if ( $this->do_concat ) {
+			/**
+			 * Filter the script loader source.
+			 *
+			 * @since 2.2.0
+			 *
+			 * @param string $src    Script loader source path.
+			 * @param string $handle Script handle.
+			 */
 			$srce = apply_filters( 'script_loader_src', $src, $handle );
 			if ( $this->in_default_dir($srce) ) {
 				$this->print_code .= $this->print_extra_script( $handle, false );
@@ -117,6 +132,7 @@ function do_item( $handle, $group = false ) {
 		if ( !empty($ver) )
 			$src = add_query_arg('ver', $ver, $src);
 
+		/** This filter is documented in wp-includes/class.wp-scripts.php */
 		$src = esc_url( apply_filters( 'script_loader_src', $src, $handle ) );
 
 		if ( ! $src )
@@ -179,8 +195,16 @@ function set_group( $handle, $recursion, $group = false ) {
 
 	function all_deps( $handles, $recursion = false, $group = false ) {
 		$r = parent::all_deps( $handles, $recursion );
-		if ( !$recursion )
+		if ( ! $recursion ) {
+			/**
+			 * Filter the list of script dependencies left to print.
+			 *
+			 * @since 2.3.0
+			 *
+			 * @param array $to_do An array of script dependencies.
+			 */
 			$this->to_do = apply_filters( 'print_scripts_array', $this->to_do );
+		}
 		return $r;
 	}
 
