From 89689e5ba93ea0bcb7c0b5a9f243b41ecd24640c Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov.ru@gmail.com>
Date: Tue, 25 Feb 2020 17:50:05 +0000
Subject: [PATCH] Docs: Clarify in `WP_Customize_Manager::remove_*()` methods
 that removing a setting, panel, section, or control does not destroy the
 class instance or remove its filters.

Props dlh, fgiannar, jon81, westonruter.
Fixes #48747.
Built from https://develop.svn.wordpress.org/trunk@47367


git-svn-id: http://core.svn.wordpress.org/trunk@47154 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/class-wp-customize-manager.php | 8 ++++++++
 wp-includes/version.php                    | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/wp-includes/class-wp-customize-manager.php b/wp-includes/class-wp-customize-manager.php
index daee794100..d928918147 100644
--- a/wp-includes/class-wp-customize-manager.php
+++ b/wp-includes/class-wp-customize-manager.php
@@ -3799,6 +3799,8 @@ final class WP_Customize_Manager {
 	/**
 	 * Remove a customize setting.
 	 *
+	 * Note that removing the setting doesn't destroy the WP_Customize_Setting instance or remove its filters.
+	 *
 	 * @since 3.4.0
 	 *
 	 * @param string $id Customize Setting ID.
@@ -3855,6 +3857,8 @@ final class WP_Customize_Manager {
 	/**
 	 * Remove a customize panel.
 	 *
+	 * Note that removing the panel doesn't destroy the WP_Customize_Panel instance or remove its filters.
+	 *
 	 * @since 4.0.0
 	 *
 	 * @param string $id Panel ID to remove.
@@ -3951,6 +3955,8 @@ final class WP_Customize_Manager {
 	/**
 	 * Remove a customize section.
 	 *
+	 * Note that removing the section doesn't destroy the WP_Customize_Section instance or remove its filters.
+	 *
 	 * @since 3.4.0
 	 *
 	 * @param string $id Section ID.
@@ -4026,6 +4032,8 @@ final class WP_Customize_Manager {
 	/**
 	 * Remove a customize control.
 	 *
+	 * Note that removing the control doesn't destroy the WP_Customize_Control instance or remove its filters.
+	 *
 	 * @since 3.4.0
 	 *
 	 * @param string $id ID of the control.
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 410a703b76..7a7df7464a 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.4-beta2-47366';
+$wp_version = '5.4-beta2-47367';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.