From a767e01f1706718ecb0bcac59d3320f5969318ac Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Fri, 4 Sep 2015 01:46:29 +0000
Subject: [PATCH] Docs: Clarify the file header summary for
 wp-includes/comment.php, the top-level file for the core Comments API.

Also adds inline DocBlock for the `require_once()` calls that now bring in the `WP_Comment` and `WP_Comment_Query` classes, as well as core comments functionality.

See #33413. See #33701.


git-svn-id: https://develop.svn.wordpress.org/trunk@33900 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/comment.php | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/wp-includes/comment.php b/src/wp-includes/comment.php
index 59944b8fc2..6e757d3375 100644
--- a/src/wp-includes/comment.php
+++ b/src/wp-includes/comment.php
@@ -1,11 +1,17 @@
 <?php
 /**
- * Manages WordPress comments
+ * Core Comments API
  *
  * @package WordPress
  * @subpackage Comment
+ * @since 1.5.0
  */
 
+/** WP_Comment class */
 require_once( ABSPATH . WPINC . '/class-wp-comment.php' );
+
+/** WP_Comment_Query class */
 require_once( ABSPATH . WPINC . '/class-wp-comment-query.php' );
+
+/** Core comments functionality */
 require_once( ABSPATH . WPINC . '/comment-functions.php' );