Docs: Clarify the file header summary for wp-includes/capabilities.php, which was broken up into multiple files in [33752].

Also adds inline DocBlocks for files now brought in via `require_once()` from this file.

See #33413. See #33701.

Built from https://develop.svn.wordpress.org/trunk@34398


git-svn-id: http://core.svn.wordpress.org/trunk@34362 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/capabilities.php

@@ -1,12 +1,20 @@
 <?php
 /**
- * WordPress Roles and Capabilities.
+ * Core User Role & Capabilities API
  *
  * @package WordPress
  * @subpackage User
+ * @since 2.0.0
  */
 
+/** WP_Roles class */
 require_once( ABSPATH . WPINC . '/class-wp-roles.php' );
+
+/** WP_Role class */
 require_once( ABSPATH . WPINC . '/class-wp-role.php' );
+
+/** WP_User class */
 require_once( ABSPATH . WPINC . '/class-wp-user.php' );
-require_once( ABSPATH . WPINC . '/capabilities-functions.php' );
+
+/** Core capabilities functionality */
+require_once( ABSPATH . WPINC . '/capabilities-functions.php' );

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.4-alpha-34397';
+$wp_version = '4.4-alpha-34398';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.