From 3d2728f7a68aeaacb2439355ca62718cac297d12 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Wed, 2 Apr 2014 03:02:16 +0000
Subject: [PATCH] Improve some inline documentation for class properties in
 `WP_Customize_Section`.

Props leewillis77 for the initial patch.
Fixes #26245.

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


git-svn-id: http://core.svn.wordpress.org/trunk@27733 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/class-wp-customize-section.php | 41 ++++++++++++++++++----
 1 file changed, 35 insertions(+), 6 deletions(-)

diff --git a/wp-includes/class-wp-customize-section.php b/wp-includes/class-wp-customize-section.php
index 3775b8e719..e96f3865e7 100644
--- a/wp-includes/class-wp-customize-section.php
+++ b/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.
 	 */