phpdoc updates for wp-includes See #7550 props jacobsantos.

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

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
 {
   /**

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();

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;

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;

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 ) {

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