From c7dddad085c34892fc4f411ee989087c44465f3b Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Tue, 22 Sep 2015 13:35:41 +0000
Subject: [PATCH] Docs: Clarify the file header summary for
 wp-includes/default-widgets.php, the top-level file for bringing in the core
 widget classes.

Also adds inline DocBlocks for the widget classes now brought in via `require_once()` as of [33843].

See #33413. See #33701.


git-svn-id: https://develop.svn.wordpress.org/trunk@34408 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/default-widgets.php | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/src/wp-includes/default-widgets.php b/src/wp-includes/default-widgets.php
index 184159af26..0cf5fc336b 100644
--- a/src/wp-includes/default-widgets.php
+++ b/src/wp-includes/default-widgets.php
@@ -1,21 +1,47 @@
 <?php
 /**
- * Default Widgets
+ * Widget API: Default core widgets
  *
  * @package WordPress
  * @subpackage Widgets
+ * @since 2.8.0
  */
 
+/** WP_Widget_Pages class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-pages.php' );
+
+/** WP_Widget_Links class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-links.php' );
+
+/** WP_Widget_Search class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-search.php' );
+
+/** WP_Widget_Archives class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-archives.php' );
+
+/** WP_Widget_Meta class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-meta.php' );
+
+/** WP_Widget_Calendar class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-calendar.php' );
+
+/** WP_Widget_Text class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-text.php' );
+
+/** WP_Widget_Categories class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-categories.php' );
+
+/** WP_Widget_Recent_Posts class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-recent-posts.php' );
+
+/** WP_Widget_Recent_Comments class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-recent-comments.php' );
+
+/** WP_Widget_RSS class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-rss.php' );
+
+/** WP_Widget_Tag_Cloud class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-tag-cloud.php' );
+
+/** WP_Nav_Menu_Widget class */
 require_once( ABSPATH . WPINC . '/widgets/class-wp-nav-menu-widget.php' );