Ticket #21434: 21434.7.diff

wp-includes/cache.php

@@ -223 +223 @@
  * Reset internal cache keys and structures. If the cache backend uses global blog or site IDs as part of its cache keys,
  * this function instructs the backend to reset those keys and perform any cleanup since blog or site IDs have changed since cache init.
  *
+ * This function is deprecated. Use wp_cache_switch_to_blog() instead of this function when preparing the cache for a blog switch.
+ * For clearing data from the default cache backend in unit tests, consider using wp_cache_flush() or overwriting $wp_object_cache.
+ * Note that wp_cache_flush() does not work portably across all object cache backends. It should be used only in unit tests that target
+ * the default cache or a known backend that supports flushing for both single and multisite configurations.
+ *
  * @since 2.6.0
  * @deprecated 3.5.0
  */