Corrected inline docs for cache.php

[ocean90]

See [6543].

There are some copy&paste issues.

[SergeyBiryukov]

I guess the comment for wp_cache_set() should be "Always returns true", like the one for WP_Object_Cache::set():
​http://core.trac.wordpress.org/browser/tags/3.5/wp-includes/cache.php#L560

Same as for wp_cache_flush() and WP_Object_Cache::flush():
​http://core.trac.wordpress.org/browser/tags/3.5/wp-includes/cache.php#L88

[ocean90]

For the build in WP_Object_Cache, yes. But other implementations should be able to return false too. For example ​memcache::set.

[SergeyBiryukov]

Replying to ocean90:

But other implementations should be able to return false too. For example ​memcache::set.

Then wp_cache_flush() comment should probably also say "False on failure, true on success".

[ocean90]

Replying to SergeyBiryukov:

Then wp_cache_flush() comment should probably also say "False on failure, true on success".

Done in 23058.2.patch​.

[SergeyBiryukov]

In 23328:

Correct inline docs for cache.php. props ocean90. fixes #23058.

[DrewAPicture]

See [23328] for fixes to inline docs in:

• wp_cache_add()
• wp_cache_flush()
• wp_cache_replace()
• wp_cache_set()