From 8d033c32d3939030ff91e6453a8d3c3268db9105 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Tue, 22 Sep 2015 13:05:38 +0000
Subject: [PATCH] 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.


git-svn-id: https://develop.svn.wordpress.org/trunk@34398 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/capabilities.php | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/src/wp-includes/capabilities.php b/src/wp-includes/capabilities.php
index e783f90b70..8f9125c6bb 100644
--- a/src/wp-includes/capabilities.php
+++ b/src/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' );
\ No newline at end of file
+
+/** Core capabilities functionality */
+require_once( ABSPATH . WPINC . '/capabilities-functions.php' );