From 6a527db98991a880281051a694717a19fd12153a Mon Sep 17 00:00:00 2001
From: westi <westi@1a063a9b-81f0-0310-95a4-ce76da25c4cd>
Date: Sat, 27 Sep 2008 10:06:18 +0000
Subject: [PATCH] phpdoc updates for wp-includes See #7550 props jacobsantos.

git-svn-id: http://svn.automattic.com/wordpress/trunk@9002 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/class-pop3.php            |  2 +-
 wp-includes/class.wp-dependencies.php | 16 ++++++++++++++++
 wp-includes/class.wp-scripts.php      | 16 ++++++++++++++++
 wp-includes/class.wp-styles.php       | 16 ++++++++++++++++
 wp-includes/functions.wp-scripts.php  | 18 +++++++++++++-----
 wp-includes/functions.wp-styles.php   | 14 ++++++++++++++
 6 files changed, 76 insertions(+), 6 deletions(-)

diff --git a/wp-includes/class-pop3.php b/wp-includes/class-pop3.php
index e97a0c9c9..c2d794acf 100644
--- a/wp-includes/class-pop3.php
+++ b/wp-includes/class-pop3.php
@@ -23,6 +23,7 @@
 | - Technology Consulting                                                   |
 | - Oursourcing (highly qualified programmers and graphic designers)        |
 '---------------------------------------------------------------------------'
+ */
 
 /**
  * POP Before SMTP Authentication Class
@@ -42,7 +43,6 @@
  * @package PHPMailer
  * @author Richard Davey
  */
-
 class POP3
 {
   /**
diff --git a/wp-includes/class.wp-dependencies.php b/wp-includes/class.wp-dependencies.php
index 1e5351506..e4c9c450b 100644
--- a/wp-includes/class.wp-dependencies.php
+++ b/wp-includes/class.wp-dependencies.php
@@ -1,5 +1,21 @@
 <?php
+/**
+ * BackPress Scripts enqueue.
+ *
+ * These classes were refactored from the WordPress WP_Scripts and WordPress
+ * script enqueue API.
+ *
+ * @package BackPress
+ * @since r74
+ */
 
+/**
+ * BackPress enqueued dependiences class.
+ *
+ * @package BackPress
+ * @uses _WP_Dependency
+ * @since r74
+ */
 class WP_Dependencies {
 	var $registered = array();
 	var $queue = array();
diff --git a/wp-includes/class.wp-scripts.php b/wp-includes/class.wp-scripts.php
index 7652aecef..858c73330 100644
--- a/wp-includes/class.wp-scripts.php
+++ b/wp-includes/class.wp-scripts.php
@@ -1,5 +1,21 @@
 <?php
+/**
+ * BackPress Scripts enqueue.
+ *
+ * These classes were refactored from the WordPress WP_Scripts and WordPress
+ * script enqueue API.
+ *
+ * @package BackPress
+ * @since r16
+ */
 
+/**
+ * BackPress Scripts enqueue class.
+ *
+ * @package BackPress
+ * @uses WP_Dependencies
+ * @since r16
+ */
 class WP_Scripts extends WP_Dependencies {
 	var $base_url; // Full URL with trailing slash
 	var $default_version;
diff --git a/wp-includes/class.wp-styles.php b/wp-includes/class.wp-styles.php
index 8533943c1..3caf63971 100644
--- a/wp-includes/class.wp-styles.php
+++ b/wp-includes/class.wp-styles.php
@@ -1,5 +1,21 @@
 <?php
+/**
+ * BackPress Styles enqueue.
+ *
+ * These classes were refactored from the WordPress WP_Scripts and WordPress
+ * script enqueue API.
+ *
+ * @package BackPress
+ * @since r74
+ */
 
+/**
+ * BackPress Styles enqueue class.
+ *
+ * @package BackPress
+ * @uses WP_Dependencies
+ * @since r74
+ */
 class WP_Styles extends WP_Dependencies {
 	var $base_url;
 	var $default_version;
diff --git a/wp-includes/functions.wp-scripts.php b/wp-includes/functions.wp-scripts.php
index 87995a4b9..4661cf779 100644
--- a/wp-includes/functions.wp-scripts.php
+++ b/wp-includes/functions.wp-scripts.php
@@ -1,13 +1,21 @@
 <?php
+/**
+ * BackPress script procedural API.
+ *
+ * @package BackPress
+ * @since r16
+ */
 
 /**
- * Prints script tags in document head
+ * Prints script tags in document head.
  *
- * Called by admin-header.php and by wp_head hook. Since it is called by wp_head on every page load,
- * the function does not instantiate the WP_Scripts object unless script names are explicitly passed.
- * Does make use of already instantiated $wp_scripts if present.
- * Use provided wp_print_scripts hook to register/enqueue new scripts.
+ * Called by admin-header.php and by wp_head hook. Since it is called by wp_head
+ * on every page load, the function does not instantiate the WP_Scripts object
+ * unless script names are explicitly passed. Does make use of already
+ * instantiated $wp_scripts if present. Use provided wp_print_scripts hook to
+ * register/enqueue new scripts.
  *
+ * @since r16
  * @see WP_Scripts::print_scripts()
  */
 function wp_print_scripts( $handles = false ) {
diff --git a/wp-includes/functions.wp-styles.php b/wp-includes/functions.wp-styles.php
index 8a3828265..b1e0ae083 100644
--- a/wp-includes/functions.wp-styles.php
+++ b/wp-includes/functions.wp-styles.php
@@ -1,5 +1,19 @@
 <?php
+/**
+ * BackPress styles procedural API.
+ *
+ * @package BackPress
+ * @since r79
+ */
 
+/**
+ * {@internal Missing Short Description}}
+ *
+ * @since r79
+ *
+ * @param mixed $handles See {@link WP_Styles::do_items()} for information.
+ * @return mixed See {@link WP_Styles::do_items()} for information.
+ */
 function wp_print_styles( $handles = false ) {
 	do_action( 'wp_print_styles' );
 	if ( '' === $handles ) // for wp_head