Index: wp-includes/cache.php
===================================================================
--- wp-includes/cache.php	(revision 23200)
+++ wp-includes/cache.php	(working copy)
@@ -19,7 +19,7 @@
  * @param mixed $data The data to add to the cache store
  * @param string $group The group to add the cache to
  * @param int $expire When the cache data should be expired
- * @return unknown
+ * @return bool False if cache key and group already exist, true on success
  */
 function wp_cache_add($key, $data, $group = '', $expire = 0) {
 	global $wp_object_cache;
@@ -152,7 +152,7 @@
  * @param mixed $data The contents to store in the cache
  * @param string $group Where to group the cache contents
  * @param int $expire When to expire the cache contents
- * @return bool False if cache key and group already exist, true on success
+ * @return bool False if not exists, true if contents were replaced
  */
 function wp_cache_replace($key, $data, $group = '', $expire = 0) {
 	global $wp_object_cache;
@@ -171,7 +171,7 @@
  * @param mixed $data The contents to store in the cache
  * @param string $group Where to group the cache contents
  * @param int $expire When to expire the cache contents
- * @return bool False if cache key and group already exist, true on success
+ * @return bool False on failure, true on success
  */
 function wp_cache_set($key, $data, $group = '', $expire = 0) {
 	global $wp_object_cache;