From f6c14d758e0fbdffaf7b411894ed52c2119d05e3 Mon Sep 17 00:00:00 2001
From: "Drew Jaynes (DrewAPicture)" <drewapicture@git.wordpress.org>
Date: Mon, 14 Jul 2014 00:35:43 +0000
Subject: [PATCH] Inline documentation cleanup for 4.0 audit.

phpDoc tweaks for methods added in [28861]:
* `WP_Customize_Manager::panels()` method
* `WP_Customize_Manager::add_panel()` method
* `WP_Customize_Manager::get_panel()` method
* `WP_Customize_Manager::remove_panel()` method

Added in [28970]:
* `WP_Customize_Manager::customize_preview_override_404_status()` method

See #27406 and #28885.


git-svn-id: https://develop.svn.wordpress.org/trunk@29157 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/class-wp-customize-manager.php | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/src/wp-includes/class-wp-customize-manager.php b/src/wp-includes/class-wp-customize-manager.php
index c62a0ab8a4..5f01a6916f 100644
--- a/src/wp-includes/class-wp-customize-manager.php
+++ b/src/wp-includes/class-wp-customize-manager.php
@@ -319,8 +319,9 @@ final class WP_Customize_Manager {
 	 * Get the registered panels.
 	 *
 	 * @since 4.0.0
+	 * @access public
 	 *
-	 * @return array
+	 * @return array Panels.
 	 */
 	public function panels() {
 		return $this->panels;
@@ -433,6 +434,7 @@ final class WP_Customize_Manager {
 	 * preview, since it causes the jQuery Ajax to fail. Send 200 instead.
 	 *
 	 * @since 4.0.0
+	 * @access public
 	 */
 	public function customize_preview_override_404_status() {
 		if ( is_404() ) {
@@ -680,9 +682,10 @@ final class WP_Customize_Manager {
 	 * Add a customize panel.
 	 *
 	 * @since 4.0.0
+	 * @access public
 	 *
 	 * @param WP_Customize_Panel|string $id   Customize Panel object, or Panel ID.
-	 * @param array                     $args Panel arguments.
+	 * @param array                     $args Optional. Panel arguments. Default empty array.
 	 */
 	public function add_panel( $id, $args = array() ) {
 		if ( is_a( $id, 'WP_Customize_Panel' ) ) {
@@ -699,9 +702,10 @@ final class WP_Customize_Manager {
 	 * Retrieve a customize panel.
 	 *
 	 * @since 4.0.0
+	 * @access public
 	 *
-	 * @param string $id Panel ID.
-	 * @return WP_Customize_Panel
+	 * @param string $id Panel ID to get.
+	 * @return WP_Customize_Panel Requested panel instance.
 	 */
 	public function get_panel( $id ) {
 		if ( isset( $this->panels[ $id ] ) ) {
@@ -713,8 +717,9 @@ final class WP_Customize_Manager {
 	 * Remove a customize panel.
 	 *
 	 * @since 4.0.0
+	 * @access public
 	 *
-	 * @param string $id Panel ID.
+	 * @param string $id Panel ID to remove.
 	 */
 	public function remove_panel( $id ) {
 		unset( $this->panels[ $id ] );