From d615eb4ee2665169f4ead8d95e8d6f5aef4deb9b Mon Sep 17 00:00:00 2001
From: "Drew Jaynes (DrewAPicture)" <drewapicture@git.wordpress.org>
Date: Wed, 2 Apr 2014 03:01:31 +0000
Subject: [PATCH] Improve some inline documentation for class properties in
 `WP_Customize_Section`.

Props leewillis77 for the initial patch.
Fixes #26245.


git-svn-id: https://develop.svn.wordpress.org/trunk@27902 602fd350-edb4-49c9-b593-d223f7449a82
---
 .../class-wp-customize-section.php            | 41 ++++++++++++++++---
 1 file changed, 35 insertions(+), 6 deletions(-)

diff --git a/src/wp-includes/class-wp-customize-section.php b/src/wp-includes/class-wp-customize-section.php
index 3775b8e719..e96f3865e7 100644
--- a/src/wp-includes/class-wp-customize-section.php
+++ b/src/wp-includes/class-wp-customize-section.php
@@ -9,9 +9,12 @@
  * @since 3.4.0
  */
 class WP_Customize_Section {
+
 	/**
-	 * @access public
+	 * WP_Customize_Manager instance.
 	 *
+	 * @since 3.4.0
+	 * @access public
 	 * @var WP_Customize_Manager
 	 */
 	public $manager;
@@ -19,6 +22,8 @@ class WP_Customize_Section {
 	/**
 	 * Unique identifier.
 	 *
+	 * @since 3.4.0
+	 * @access public
 	 * @var string
 	 */
 	public $id;
@@ -26,31 +31,55 @@ class WP_Customize_Section {
 	/**
 	 * Priority of the section which informs load order of sections.
 	 *
+	 * @since 3.4.0
+	 * @access public
 	 * @var integer
 	 */
-	public $priority       = 10;
+	public $priority = 10;
 
 	/**
 	 * Capability required for the section.
 	 *
+	 * @since 3.4.0
+	 * @access public
 	 * @var string
 	 */
-	public $capability     = 'edit_theme_options';
+	public $capability = 'edit_theme_options';
+
+	/**
+	 * Theme feature support for the section.
+	 *
+	 * @since 3.4.0
+	 * @access public
+	 * @var string|array
+	 */
 	public $theme_supports = '';
 
 	/**
 	 * Title of the section to show in UI.
 	 *
+	 * @since 3.4.0
+	 * @access public
 	 * @var string
 	 */
-	public $title          = '';
+	public $title = '';
 
 	/**
 	 * Description to show in the UI.
 	 *
+	 * @since 3.4.0
+	 * @access public
 	 * @var string
 	 */
-	public $description    = '';
+	public $description = '';
+
+	/**
+	 * Customizer controls for this section.
+	 *
+	 * @since 3.4.0
+	 * @access public
+	 * @var array
+	 */
 	public $controls;
 
 	/**
@@ -60,7 +89,7 @@ class WP_Customize_Section {
 	 *
 	 * @since 3.4.0
 	 *
-	 * @param WP_Customize_Manager $manager
+	 * @param WP_Customize_Manager $manager Customizer bootstrap instance.
 	 * @param string               $id      An specific ID of the section.
 	 * @param array                $args    Section arguments.
 	 */