From 0b962deaaa8d9cb7fe0f5155218e29cc578f95ac Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Sun, 5 Apr 2015 15:06:40 +0000
Subject: [PATCH] Fix inline documentation syntax in a variety of DocBlocks and
 hook docs in `WP_Customize_Manager`.

See [31370]. See #31888.


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

diff --git a/src/wp-includes/class-wp-customize-manager.php b/src/wp-includes/class-wp-customize-manager.php
index 7f703d2ecc..d24c283a4b 100644
--- a/src/wp-includes/class-wp-customize-manager.php
+++ b/src/wp-includes/class-wp-customize-manager.php
@@ -570,6 +570,7 @@ final class WP_Customize_Manager {
 	 * Print CSS for loading indicators for the Customizer preview.
 	 *
 	 * @since 4.2.0
+	 * @access public
 	 */
 	public function customize_preview_loading_style() {
 		?><style>
@@ -768,7 +769,7 @@ final class WP_Customize_Manager {
 		do_action( 'customize_save_after', $this );
 
 		/**
-		 * Filter response data for a successful customize_save Ajax request.
+		 * Filter response data for a successful customize_save AJAX request.
 		 *
 		 * This filter does not apply if there was a nonce or authentication failure.
 		 *
@@ -801,17 +802,18 @@ final class WP_Customize_Manager {
 	}
 
 	/**
-	 * Register any dynamically-created settings, such as those from $_POST['customized'] that have no corresponding setting created.
+	 * Register any dynamically-created settings, such as those from $_POST['customized']
+	 * that have no corresponding setting created.
 	 *
 	 * This is a mechanism to "wake up" settings that have been dynamically created
-	 * on the frontend and have been sent to WordPress in $_POST['customized']. When WP
+	 * on the frontend and have been sent to WordPress in `$_POST['customized']`. When WP
 	 * loads, the dynamically-created settings then will get created and previewed
 	 * even though they are not directly created statically with code.
 	 *
 	 * @since 4.2.0
 	 *
-	 * @param string[] $setting_ids The setting IDs to add.
-	 * @return WP_Customize_Setting[] The settings added.
+	 * @param string $setting_ids The setting IDs to add.
+	 * @return WP_Customize_Setting The settings added.
 	 */
 	public function add_dynamic_settings( $setting_ids ) {
 		$new_settings = array();
@@ -833,8 +835,8 @@ final class WP_Customize_Manager {
 			 *
 			 * @since 4.2.0
 			 *
-			 * @param false|array $setting_args  The arguments to the WP_Customize_Setting constructor.
-			 * @param string      $setting_id    ID for dynamic setting, usually coming from $_POST['customized'].
+			 * @param false|array $setting_args The arguments to the WP_Customize_Setting constructor.
+			 * @param string      $setting_id   ID for dynamic setting, usually coming from `$_POST['customized']`.
 			 */
 			$setting_args = apply_filters( 'customize_dynamic_setting_args', $setting_args, $setting_id );
 			if ( false === $setting_args ) {
@@ -846,13 +848,14 @@ final class WP_Customize_Manager {
 			 *
 			 * @since 4.2.0
 			 *
-			 * @param string $setting_class  WP_Customize_Setting or a subclass.
-			 * @param string $setting_id     ID for dynamic setting, usually coming from $_POST['customized'].
-			 * @param string $setting_args   WP_Customize_Setting or a subclass.
+			 * @param string $setting_class WP_Customize_Setting or a subclass.
+			 * @param string $setting_id    ID for dynamic setting, usually coming from `$_POST['customized']`.
+			 * @param string $setting_args  WP_Customize_Setting or a subclass.
 			 */
 			$setting_class = apply_filters( 'customize_dynamic_setting_class', $setting_class, $setting_id, $setting_args );
 
 			$setting = new $setting_class( $this, $setting_id, $setting_args );
+
 			$this->add_setting( $setting );
 			$new_settings[] = $setting;
 		}
@@ -1450,6 +1453,9 @@ final class WP_Customize_Manager {
 	 * Add settings from the POST data that were not added with code, e.g. dynamically-created settings for Widgets
 	 *
 	 * @since 4.2.0
+	 * @access public
+	 *
+	 * @see add_dynamic_settings()
 	 */
 	public function register_dynamic_settings() {
 		$this->add_dynamic_settings( array_keys( $this->unsanitized_post_values() ) );