[wp-trac] [WordPress Trac] #41815: switch_to_blog() docs incorrectly state that autoloaded options aren't switched

[WordPress Trac]

#41815: switch_to_blog() docs incorrectly state that autoloaded options aren't
switched
-----------------------------+-----------------------------
 Reporter:  jdgrimes         |      Owner:
     Type:  defect (bug)     |     Status:  new
 Priority:  normal           |  Milestone:  Awaiting Review
Component:  Cache API        |    Version:  3.5
 Severity:  normal           |   Keywords:
  Focuses:  docs, multisite  |
-----------------------------+-----------------------------
 The inline docs for `switch_to_blog()` include this:

 {{{
  * Things that aren't switched:
  *  - autoloaded options. See #14992
  *  - plugins. See #14941
 }}}

 The statement that autoloaded options aren't switched was added to the
 docs in [15676], as suggested in [ticket:14992#comment:2]. However, #14992
 was later [https://core.trac.wordpress.org/ticket/14992#comment:19 closed
 as worksforme], having been apparently fixed in the intervening time, via
 #21434 and other changes. The autoloaded options cache should now always
 be switched even when using a persistent caching plugin, since modern
 drop-ins should be implementing `wp_cache_switch_to_blog()`.

 As such, the statement that autoloaded options aren't switched doesn't
 appear to be accurate any longer, and should be removed. Or at the very
 least, it should be clarified to say that this is only a legacy issue with
 some persistent caching implementations.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/41815>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform