switch_to_blog() docs incorrectly state that autoloaded options aren't switched

[jdgrimes]

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 14992#comment:2. However, #14992 was later 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.

[stevepuddick]

line removed

[stevepuddick]

Here it is. Created as part of virtual contrib2core workshop. ​https://www.meetup.com/The-Ottawa-WordPress-Group/events/242253849/

[jeremyfelt]

Good catch, as of [21403], the blog ID was added to the cache key for multisite installs.

Thanks for the patch @stevepuddick!

[jeremyfelt]

In 41373:

Multisite: Update docs for switch_to_blog().

As of [21403], autoload options are switched along with the cache key prefix.

Props stevepuddick.
Fixes #41815.

[pbearne]

This ticket patch as patch of Virtual Contrib 2 core Meetup

​https://www.youtube.com/watch?v=xoQkp_aZzfE
​https://www.meetup.com/The-Ottawa-WordPress-Group/events/242253849/
​https://www.meetup.com/WPToronto/events/243121890/

[birgire]

@pbearne great to see a video of the patch coding, thanks for sharing

[audrasjb]

In 57596:

Networks and Sites: Improve switch_to_blog() docblock.

Follow-up to [41373].

Props sabernhardt, jeremyfelt, audrasjb.
Fixes #60332.
See #41815.