From 5be0ba0ae8ca1c9c526b6bbb613ce243944839e6 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Sun, 5 Apr 2015 15:54:08 +0000
Subject: [PATCH] Add a variety of missing descriptions and fix syntax for
 `wp_scripts()`, `_wp_scripts_maybe_doing_it_wrong()`, and
 `wp_script_add_data()`.

See #31888.


git-svn-id: https://develop.svn.wordpress.org/trunk@32040 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/functions.wp-scripts.php | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/src/wp-includes/functions.wp-scripts.php b/src/wp-includes/functions.wp-scripts.php
index aacf9d15af..6f59a03fe9 100644
--- a/src/wp-includes/functions.wp-scripts.php
+++ b/src/wp-includes/functions.wp-scripts.php
@@ -15,7 +15,7 @@
  *
  * @since 4.2.0
  *
- * @return WP_Scripts
+ * @return WP_Scripts WP_Scripts instance.
  */
 function wp_scripts() {
 	global $wp_scripts;
@@ -26,13 +26,12 @@ function wp_scripts() {
 }
 
 /**
- * Helper function to output a _doing_it_wrong message when applicable
+ * Helper function to output a _doing_it_wrong message when applicable.
  *
- * @since 4.2.0
- * @access private
  * @ignore
+ * @since 4.2.0
  *
- * @param string $function
+ * @param string $function Function name.
  */
 function _wp_scripts_maybe_doing_it_wrong( $function ) {
 	if ( did_action( 'init' ) ) {
@@ -283,10 +282,10 @@ function wp_script_is( $handle, $list = 'enqueued' ) {
  * Possible values for $key and $value:
  * 'conditional' string Comments for IE 6, lte IE 7, etc.
  *
- * @see WP_Dependency::add_data()
- *
  * @since 4.2.0
  *
+ * @see WP_Dependency::add_data()
+ *
  * @param string $handle Name of the script.
  * @param string $key    Name of data point for which we're storing a value.
  * @param mixed  $value  String containing the data to be added.