Context Navigation

← Previous Changeset
Next Changeset →

Changeset 47121

Timestamp:

01/29/2020 12:36:17 AM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve DocBlocks in phpunit/includes/object-cache.php per the documentation standards.

See #48303.

File:

: 1 edited

trunk/tests/phpunit/includes/object-cache.php (modified) (130 diffs)

Legend:

: Unmodified
: Added
: Removed

trunk/tests/phpunit/includes/object-cache.php

-                      r46586
+                      r47121
  * returns false.
+ *
  * @link http://www.php.net/manual/en/memcached.add.php
+ *
  * @param string    $key        The key under which to store the value.
  * @param mixed     $value      The value to store.
  * @param string    $group      The group value appended to the $key.
  * @param int       $expiration The expiration time, defaults to 0.
  * @return bool                 Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.add.php
+ *
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_add( $key, $value, $group = '', $expiration = 0 ) {
 …
  * specified server_key.
+ *
  * @link http://www.php.net/manual/en/memcached.addbykey.php
+ *
  * @param string    $server_key     The key identifying the server to store the value on.
  * @param string    $key            The key under which to store the value.
  * @param mixed     $value          The value to store.
  * @param string    $group          The group value appended to the $key.
  * @param int       $expiration     The expiration time, defaults to 0.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.addbykey.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_add_by_key( $server_key, $key, $value, $group = '', $expiration = 0 ) {
 …
 /**
+ * Add a single server to the list of Memcached servers.
+ *
+ * @link http://www.php.net/manual/en/memcached.addserver.php
+ *
+ * @param string        $host   The hostname of the memcache server.
+ * @param int           $port   The port on which memcache is running.
+ * @param int           $weight The weight of the server relative to the total weight of all the servers in the pool.
+ * @return bool                 Returns TRUE on success or FALSE on failure.
+ * Adds a single server to the list of Memcached servers.
+ *
+ * @link https://www.php.net/manual/en/memcached.addserver.php
+ *
+ * @param string $host   The hostname of the memcache server.
+ * @param int    $port   The port on which memcache is running.
+ * @param int    $weight The weight of the server relative to the total weight
+ *                       of all the servers in the pool.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_add_server( $host, $port, $weight = 0 ) {
 …
  * weight value: $servers = array( array( '127.0.0.1', 11211, 0 ) );
+ *
  * @link http://www.php.net/manual/en/memcached.addservers.php
+ *
  * @param array     $servers    Array of server to register.
  * @return bool                 True on success; false on failure.
+ * @link https://www.php.net/manual/en/memcached.addservers.php
+ *
+ * @param array $servers Array of server to register.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_add_servers( $servers ) {
 …
 /**
  * Append data to an existing item.
+ *
  * This method should throw an error if it is used with compressed data. This
  * is an expected behavior. Memcached casts the value to be appended to the initial value to the
  * type of the initial value. Be careful as this leads to unexpected behavior at times. Due to
  * how memcached treats types, the behavior has been mimicked in the internal cache to produce
  * similar results and improve consistency. It is recommend that appends only occur with data of
+ * Appends data to an existing item.
+ *
+ * This method should throw an error if it is used with compressed data.
+ * This is an expected behavior. Memcached casts the value to be appended to the initial value
+ * to the type of the initial value. Be careful as this leads to unexpected behavior at times.
+ * Due to how memcached treats types, the behavior has been mimicked in the internal cache to produce
+ * similar results and improve consistency. It is recommended that appends only occur with data of
  * the same type.
+ *
  * @link http://www.php.net/manual/en/memcached.append.php
+ *
  * @param string    $key    The key under which to store the value.
  * @param mixed     $value  Must be string as appending mixed values is not well-defined
  * @param string    $group  The group value appended to the $key.
  * @return bool             Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.append.php
+ *
+ * @param string $key   The key under which to store the value.
+ * @param mixed  $value Must be string as appending mixed values is not well-defined.
+ * @param string $group The group value appended to the $key.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_append( $key, $value, $group = '' ) {
 …
 /**
  * Append data to an existing item by server key.
+ *
  * This method should throw an error if it is used with compressed data. This
  * is an expected behavior. Memcached casts the value to be appended to the initial value to the
  * type of the initial value. Be careful as this leads to unexpected behavior at times. Due to
  * how memcached treats types, the behavior has been mimicked in the internal cache to produce
  * similar results and improve consistency. It is recommend that appends only occur with data of
+ * Appends data to an existing item by server key.
+ *
+ * This method should throw an error if it is used with compressed data.
+ * This is an expected behavior. Memcached casts the value to be appended to the initial value
+ * to the type of the initial value. Be careful as this leads to unexpected behavior at times.
+ * Due to how memcached treats types, the behavior has been mimicked in the internal cache to produce
+ * similar results and improve consistency. It is recommended that appends only occur with data of
  * the same type.
+ *
  * @link http://www.php.net/manual/en/memcached.appendbykey.php
+ *
  * @param string    $server_key     The key identifying the server to store the value on.
  * @param string    $key            The key under which to store the value.
  * @param mixed     $value          Must be string as appending mixed values is not well-defined
  * @param string    $group          The group value appended to the $key.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.appendbykey.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      Must be string as appending mixed values is not well-defined.
+ * @param string $group      The group value appended to the $key.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_append_by_key( $server_key, $key, $value, $group = '' ) {
 …
  * Performs a "check and set" to store data.
+ *
  * The set will be successful only if the no other request has updated the value since it was fetched by
  * this request.
+ *
  * @link http://www.php.net/manual/en/memcached.cas.php
+ *
  * @param float     $cas_token  Unique value associated with the existing item. Generated by memcached.
  * @param string    $key        The key under which to store the value.
  * @param mixed     $value      The value to store.
  * @param string    $group      The group value appended to the $key.
  * @param int       $expiration The expiration time, defaults to 0.
  * @return bool                 Returns TRUE on success or FALSE on failure.
+ * The set will be successful only if the no other request has updated the value
+ * since it was fetched by this request.
+ *
+ * @link https://www.php.net/manual/en/memcached.cas.php
+ *
+ * @param float  $cas_token  Unique value associated with the existing item. Generated by memcached.
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_cas( $cas_token, $key, $value, $group = '', $expiration = 0 ) {
 …
  * Performs a "check and set" to store data with a server key.
+ *
  * The set will be successful only if the no other request has updated the value since it was fetched by
  * this request.
+ *
  * @link http://www.php.net/manual/en/memcached.casbykey.php
+ *
  * @param string    $server_key The key identifying the server to store the value on.
  * @param float     $cas_token  Unique value associated with the existing item. Generated by memcached.
  * @param string    $key        The key under which to store the value.
  * @param mixed     $value      The value to store.
  * @param string    $group      The group value appended to the $key.
  * @param int       $expiration The expiration time, defaults to 0.
  * @return bool                 Returns TRUE on success or FALSE on failure.
+ * The set will be successful only if the no other request has updated the value
+ * since it was fetched by this request.
+ *
+ * @link https://www.php.net/manual/en/memcached.casbykey.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @param float  $cas_token  Unique value associated with the existing item. Generated by memcached.
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_cas_by_key( $cas_token, $server_key, $key, $value, $group = '', $expiration = 0 ) {
 …
  * Closes the cache.
+ *
  * This function has ceased to do anything since WordPress 2.5. The
  * functionality was removed along with the rest of the persistent cache. This
  * does not mean that plugins can't implement this function when they need to
  * make sure that the cache is cleaned up after WordPress no longer needs it.
+ * This function has ceased to do anything since WordPress 2.5.
+ * The functionality was removed along with the rest of the persistent cache.
+ * This does not mean that plugins can't implement this function when they need
+ * to make sure that the cache is cleaned up after WordPress no longer needs it.
+ *
  * @since 2.0.0
+ *
  * @return  bool    Always returns True
+ * @return bool Always returns true.
  */
 function wp_cache_close() {
 …
 /**
  * Decrement a numeric item's value.
+ *
  * @link http://www.php.net/manual/en/memcached.decrement.php
+ *
  * @param string    $key    The key under which to store the value.
  * @param int       $offset The amount by which to decrement the item's value.
  * @param string    $group  The group value appended to the $key.
  * @return int|bool         Returns item's new value on success or FALSE on failure.
+ * Decrements a numeric item's value.
+ *
+ * @link https://www.php.net/manual/en/memcached.decrement.php
+ *
+ * @param string $key    The key under which to store the value.
+ * @param int    $offset The amount by which to decrement the item's value.
+ * @param string $group  The group value appended to the $key.
+ * @return int|bool Item's new value on success, false on failure.
  */
 function wp_cache_decrement( $key, $offset = 1, $group = '' ) {
 …
 /**
  * Decrement a numeric item's value.
+ *
  * Same as wp_cache_decrement. Original WordPress caching backends use wp_cache_decr. I
  * want both spellings to work.
+ *
  * @link http://www.php.net/manual/en/memcached.decrement.php
+ *
  * @param string    $key    The key under which to store the value.
  * @param int       $offset The amount by which to decrement the item's value.
  * @param string    $group  The group value appended to the $key.
  * @return int|bool         Returns item's new value on success or FALSE on failure.
+ * Decrements a numeric item's value.
+ *
+ * This is the same as wp_cache_decrement(), but kept for backward compatibility.
+ * The original WordPress caching backends use wp_cache_decr().
+ *
+ * @link https://www.php.net/manual/en/memcached.decrement.php
+ *
+ * @param string $key    The key under which to store the value.
+ * @param int    $offset The amount by which to decrement the item's value.
+ * @param string $group  The group value appended to the $key.
+ * @return int|bool Item's new value on success, false on failure.
  */
 function wp_cache_decr( $key, $offset = 1, $group = '' ) {
 …
 /**
  * Remove the item from the cache.
+ *
  * Remove an item from memcached with identified by $key after $time seconds. The
  * $time parameter allows an object to be queued for deletion without immediately
  * deleting. Between the time that it is queued and the time it's deleted, add,
  * replace, and get will fail, but set will succeed.
+ *
  * @link http://www.php.net/manual/en/memcached.delete.php
+ *
  * @param string    $key    The key under which to store the value.
  * @param string    $group  The group value appended to the $key.
  * @param int       $time   The amount of time the server will wait to delete the item in seconds.
  * @return bool             Returns TRUE on success or FALSE on failure.
+ * Removes the item from the cache.
+ *
+ * Removes an item from memcached with identified by $key after $time seconds.
+ * The $time parameter allows an object to be queued for deletion without
+ * immediately deleting. Between the time that it is queued and the time it's deleted,
+ * add, replace, and get will fail, but set will succeed.
+ *
+ * @link https://www.php.net/manual/en/memcached.delete.php
+ *
+ * @param string $key   The key under which to store the value.
+ * @param string $group The group value appended to the $key.
+ * @param int    $time  The amount of time the server will wait to delete the item in seconds.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_delete( $key, $group = '', $time = 0 ) {
 …
 /**
  * Remove the item from the cache by server key.
+ *
  * Remove an item from memcached with identified by $key after $time seconds. The
  * $time parameter allows an object to be queued for deletion without immediately
  * deleting. Between the time that it is queued and the time it's deleted, add,
  * replace, and get will fail, but set will succeed.
+ *
  * @link http://www.php.net/manual/en/memcached.deletebykey.php
+ *
  * @param string        $server_key The key identifying the server to store the value on.
  * @param string        $key        The key under which to store the value.
  * @param string        $group      The group value appended to the $key.
  * @param int           $time       The amount of time the server will wait to delete the item in seconds.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * Removes the item from the cache by server key.
+ *
+ * Removes an item from memcached with identified by $key after $time seconds.
+ * The $time parameter allows an object to be queued for deletion without
+ * immediately deleting. Between the time that it is queued and the time it's deleted,
+ * add, replace, and get will fail, but set will succeed.
+ *
+ * @link https://www.php.net/manual/en/memcached.deletebykey.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @param string $key        The key under which to store the value.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $time       The amount of time the server will wait to delete the item in seconds.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_delete_by_key( $server_key, $key, $group = '', $time = 0 ) {
 …
 /**
  * Fetch the next result.
+ *
  * @link http://www.php.net/manual/en/memcached.fetch.php
+ *
  * @return  array|bool   Returns the next result or FALSE otherwise.
+ * Fetches the next result.
+ *
+ * @link https://www.php.net/manual/en/memcached.fetch.php
+ *
+ * @return array|false The next result on success, false on failure.
  */
 function wp_cache_fetch() {
 …
 /**
  * Fetch all remaining results from the last request.
+ *
  * @link http://www.php.net/manual/en/memcached.fetchall.php
+ *
  * @return  array|bool  Returns the results or FALSE on failure.
+ * Fetches all remaining results from the last request.
+ *
+ * @link https://www.php.net/manual/en/memcached.fetchall.php
+ *
+ * @return array|false The results on success, false on failure.
  */
 function wp_cache_fetch_all() {
 …
 /**
  * Invalidate all items in the cache.
+ *
  * @link http://www.php.net/manual/en/memcached.flush.php
+ *
  * @param int       $delay  Number of seconds to wait before invalidating the items.
  * @return bool             Returns TRUE on success or FALSE on failure.
+ * Invalidates all items in the cache.
+ *
+ * @link https://www.php.net/manual/en/memcached.flush.php
+ *
+ * @param int $delay Number of seconds to wait before invalidating the items.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_flush( $delay = 0 ) {
 …
 /**
+ * Retrieve object from cache.
+ *
+ * Gets an object from cache based on $key and $group. In order to fully support the $cache_cb and $cas_token
+ * parameters, the runtime cache is ignored by this function if either of those values are set. If either of
+ * those values are set, the request is made directly to the memcached server for proper handling of the
+ * callback and/or token.
+ *
+ * Note that the $deprecated and $found args are only here for compatibility with the native wp_cache_get function.
+ *
+ * @link http://www.php.net/manual/en/memcached.get.php
+ *
+ * @param string        $key        The key under which to store the value.
+ * @param string        $group      The group value appended to the $key.
+ * @param bool          $force      Whether or not to force a cache invalidation.
+ * @param null|bool     $found      Variable passed by reference to determine if the value was found or not.
+ * @param null|string   $cache_cb   Read-through caching callback.
+ * @param null|float    $cas_token  The variable to store the CAS token in.
+ * @return bool|mixed               Cached object value.
+ * Retrieves object from cache.
+ *
+ * Gets an object from cache based on $key and $group. In order to fully support
+ * the $cache_cb and $cas_token parameters, the runtime cache is ignored by this function
+ * if either of those values are set. In that case, the request is made directly
+ * to the memcached server for proper handling of the callback and/or token.
+ *
+ * Note that the $deprecated and $found args are only here for compatibility
+ * with the native wp_cache_get() function.
+ *
+ * @link https://www.php.net/manual/en/memcached.get.php
+ *
+ * @param string      $key       The key under which to store the value.
+ * @param string      $group     The group value appended to the $key.
+ * @param bool        $force     Whether or not to force a cache invalidation.
+ * @param null|bool   $found     Variable passed by reference to determine if the value was found or not.
+ * @param null|string $cache_cb  Read-through caching callback.
+ * @param null|float  $cas_token The variable to store the CAS token in.
+ * @return bool|mixed Cached object value.
  */
 function wp_cache_get( $key, $group = '', $force = false, &$found = null, $cache_cb = null, &$cas_token = null ) {
 …
 /**
  * Retrieve object from cache from specified server.
+ *
  * Gets an object from cache based on $key, $group and $server_key. In order to fully support the $cache_cb and $cas_token
  * parameters, the runtime cache is ignored by this function if either of those values are set. If either of
  * those values are set, the request is made directly to the memcached server for proper handling of the
  * callback and/or token.
+ *
  * @link http://www.php.net/manual/en/memcached.getbykey.php
+ *
  * @param string        $server_key The key identifying the server to store the value on.
  * @param string        $key        The key under which to store the value.
  * @param string        $group      The group value appended to the $key.
  * @param bool          $force      Whether or not to force a cache invalidation.
  * @param null|bool     $found      Variable passed by reference to determine if the value was found or not.
  * @param null|string   $cache_cb   Read-through caching callback.
  * @param null|float    $cas_token  The variable to store the CAS token in.
  * @return bool|mixed               Cached object value.
+ * Retrieves object from cache from specified server.
+ *
+ * Gets an object from cache based on $key, $group, and $server_key. In order to fully support
+ * the $cache_cb and $cas_token parameters, the runtime cache is ignored by this function
+ * if either of those values are set. In that case, the request is made directly
+ * to the memcached server for proper handling of the callback and/or token.
+ *
+ * @link https://www.php.net/manual/en/memcached.getbykey.php
+ *
+ * @param string      $server_key The key identifying the server to store the value on.
+ * @param string      $key        The key under which to store the value.
+ * @param string      $group      The group value appended to the $key.
+ * @param bool        $force      Whether or not to force a cache invalidation.
+ * @param null|bool   $found      Variable passed by reference to determine if the value was found or not.
+ * @param null|string $cache_cb   Read-through caching callback.
+ * @param null|float  $cas_token  The variable to store the CAS token in.
+ * @return bool|mixed Cached object value.
  */
 function wp_cache_get_by_key( $server_key, $key, $group = '', $force = false, &$found = null, $cache_cb = null, &$cas_token = null ) {
 …
 /**
+ * Request multiple keys without blocking.
+ *
+ * @link http://www.php.net/manual/en/memcached.getdelayed.php
+ *
+ * @param string|array  $keys       Array or string of key(s) to request.
+ * @param string|array  $groups     Array or string of group(s) for the key(s). See buildKeys for more on how these are handled.
+ * @param bool          $with_cas   Whether to request CAS token values also.
+ * @param null          $value_cb   The result callback or NULL.
+ * @return bool                     Returns TRUE on success or FALSE on failure.
+ * Requests multiple keys without blocking.
+ *
+ * @link https://www.php.net/manual/en/memcached.getdelayed.php
+ *
+ * @param string|array $keys     Array or string of key(s) to request.
+ * @param string|array $groups   Array or string of group(s) for the key(s).
+ *                               See buildKeys for more on how these are handled.
+ * @param bool         $with_cas Whether to request CAS token values also.
+ * @param null         $value_cb The result callback or null.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_get_delayed( $keys, $groups = '', $with_cas = false, $value_cb = null ) {
 …
 /**
+ * Request multiple keys without blocking from a specified server.
+ *
+ * @link http://www.php.net/manual/en/memcached.getdelayed.php
+ *
+ * @param string        $server_key The key identifying the server to store the value on.
+ * @param string|array  $keys       Array or string of key(s) to request.
+ * @param string|array  $groups     Array or string of group(s) for the key(s). See buildKeys for more on how these are handled.
+ * @param bool          $with_cas   Whether to request CAS token values also.
+ * @param null          $value_cb   The result callback or NULL.
+ * @return bool                     Returns TRUE on success or FALSE on failure.
+ * Requests multiple keys without blocking from a specified server.
+ *
+ * @link https://www.php.net/manual/en/memcached.getdelayed.php
+ *
+ * @param string       $server_key The key identifying the server to store the value on.
+ * @param string|array $keys       Array or string of key(s) to request.
+ * @param string|array $groups     Array or string of group(s) for the key(s).
+ *                                 See buildKeys for more on how these are handled.
+ * @param bool         $with_cas   Whether to request CAS token values also.
+ * @param null         $value_cb   The result callback or null.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_get_delayed_by_key( $server_key, $keys, $groups = '', $with_cas = false, $value_cb = null ) {
 …
  * See the buildKeys method definition to understand the $keys/$groups parameters.
+ *
+ * @link http://www.php.net/manual/en/memcached.getmulti.php
+ *
+ * @param array         $keys       Array of keys to retrieve.
+ * @param string|array  $groups     If string, used for all keys. If arrays, corresponds with the $keys array.
+ * @param null|array    $cas_tokens The variable to store the CAS tokens for the found items.
+ * @param int           $flags      The flags for the get operation.
+ * @return bool|array               Returns the array of found items or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.getmulti.php
+ *
+ * @param array        $keys       Array of keys to retrieve.
+ * @param string|array $groups     If string, used for all keys.
+ *                                 If arrays, corresponds with the $keys array.
+ * @param null|array   $cas_tokens The variable to store the CAS tokens for the found items.
+ * @param int          $flags      The flags for the get operation.
+ * @return bool|array The array of found items on success, false on failure.
  */
 function wp_cache_get_multi( $keys, $groups = '', &$cas_tokens = null, $flags = null ) {
 …
  * See the buildKeys method definition to understand the $keys/$groups parameters.
+ *
+ * @link http://www.php.net/manual/en/memcached.getmultibykey.php
+ *
+ * @param string        $server_key The key identifying the server to store the value on.
+ * @param array         $keys       Array of keys to retrieve.
+ * @param string|array  $groups     If string, used for all keys. If arrays, corresponds with the $keys array.
+ * @param null|array    $cas_tokens The variable to store the CAS tokens for the found items.
+ * @param int           $flags      The flags for the get operation.
+ * @return bool|array               Returns the array of found items or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.getmultibykey.php
+ *
+ * @param string       $server_key The key identifying the server to store the value on.
+ * @param array        $keys       Array of keys to retrieve.
+ * @param string|array $groups     If string, used for all keys.
+ *                                 If arrays, corresponds with the $keys array.
+ * @param null|array   $cas_tokens The variable to store the CAS tokens for the found items.
+ * @param int          $flags      The flags for the get operation.
+ * @return bool|array The array of found items on success, false on failure.
  */
 function wp_cache_get_multi_by_key( $server_key, $keys, $groups = '', &$cas_tokens = null, $flags = null ) {
 …
 /**
  * Retrieve a Memcached option value.
+ *
  * @link http://www.php.net/manual/en/memcached.getoption.php
+ *
  * @param int   $option One of the Memcached::OPT_* constants.
  * @return mixed        Returns the value of the requested option, or FALSE on error.
+ * Retrieves a Memcached option value.
+ *
+ * @link https://www.php.net/manual/en/memcached.getoption.php
+ *
+ * @param int $option One of the Memcached::OPT_* constants.
+ * @return mixed The value of the requested option on success, false on failure.
  */
 function wp_cache_get_option( $option ) {
 …
 /**
  * Return the result code of the last option.
+ *
  * @link http://www.php.net/manual/en/memcached.getresultcode.php
+ *
  * @return int  Result code of the last Memcached operation.
+ * Returns the result code of the last option.
+ *
+ * @link https://www.php.net/manual/en/memcached.getresultcode.php
+ *
+ * @return int Result code of the last Memcached operation.
  */
 function wp_cache_get_result_code() {
 …
  * Return the message describing the result of the last operation.
+ *
  * @link http://www.php.net/manual/en/memcached.getresultmessage.php
+ *
  * @return string   Message describing the result of the last Memcached operation.
+ * @link https://www.php.net/manual/en/memcached.getresultmessage.php
+ *
+ * @return string Message describing the result of the last Memcached operation.
  */
 function wp_cache_get_result_message() {
 …
 /**
  * Get server information by key.
+ *
  * @link http://www.php.net/manual/en/memcached.getserverbykey.php
+ *
  * @param string    $server_key The key identifying the server to store the value on.
  * @return array                Array with host, post, and weight on success, FALSE on failure.
+ * Gets server information by key.
+ *
+ * @link https://www.php.net/manual/en/memcached.getserverbykey.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @return array Array with host, post, and weight on success, fales on failure.
  */
 function wp_cache_get_server_by_key( $server_key ) {
 …
 /**
  * Get the list of servers in the pool.
+ *
  * @link http://www.php.net/manual/en/memcached.getserverlist.php
+ *
  * @return array    The list of all servers in the server pool.
+ * Gets the list of servers in the pool.
+ *
+ * @link https://www.php.net/manual/en/memcached.getserverlist.php
+ *
+ * @return array The list of all servers in the server pool.
  */
 function wp_cache_get_server_list() {
 …
 /**
  * Get server pool statistics.
+ *
  * @link http://www.php.net/manual/en/memcached.getstats.php
+ *
  * @return array    Array of server statistics, one entry per server.
+ * Gets server pool statistics.
+ *
+ * @link https://www.php.net/manual/en/memcached.getstats.php
+ *
+ * @return array Array of server statistics, one entry per server.
  */
 function wp_cache_get_stats() {
 …
 /**
  * Get server pool memcached version information.
+ *
  * @link http://www.php.net/manual/en/memcached.getversion.php
+ *
  * @return array    Array of server versions, one entry per server.
+ * Gets server pool memcached version information.
+ *
+ * @link https://www.php.net/manual/en/memcached.getversion.php
+ *
+ * @return array Array of server versions, one entry per server.
  */
 function wp_cache_get_version() {
 …
 /**
  * Increment a numeric item's value.
+ *
  * @link http://www.php.net/manual/en/memcached.increment.php
+ *
  * @param string    $key    The key under which to store the value.
  * @param int       $offset The amount by which to increment the item's value.
  * @param string    $group  The group value appended to the $key.
  * @return int|bool         Returns item's new value on success or FALSE on failure.
+ * Increments a numeric item's value.
+ *
+ * @link https://www.php.net/manual/en/memcached.increment.php
+ *
+ * @param string $key    The key under which to store the value.
+ * @param int    $offset The amount by which to increment the item's value.
+ * @param string $group  The group value appended to the $key.
+ * @return int|bool Item's new value on success, false on failure.
  */
 function wp_cache_increment( $key, $offset = 1, $group = '' ) {
 …
 /**
  * Increment a numeric item's value.
+ *
  * This is the same as wp_cache_increment, but kept for back compatibility. The original
  * WordPress caching backends use wp_cache_incr. I want both to work.
+ *
  * @link http://www.php.net/manual/en/memcached.increment.php
+ *
  * @param string    $key    The key under which to store the value.
  * @param int       $offset The amount by which to increment the item's value.
  * @param string    $group  The group value appended to the $key.
  * @return int|bool         Returns item's new value on success or FALSE on failure.
+ * Increments a numeric item's value.
+ *
+ * This is the same as wp_cache_increment(), but kept for backward compatibility.
+ * The original WordPress caching backends use wp_cache_incr().
+ *
+ * @link https://www.php.net/manual/en/memcached.increment.php
+ *
+ * @param string $key    The key under which to store the value.
+ * @param int    $offset The amount by which to increment the item's value.
+ * @param string $group  The group value appended to the $key.
+ * @return int|bool Item's new value on success, false on failure.
  */
 function wp_cache_incr( $key, $offset = 1, $group = '' ) {
 …
 /**
  * Prepend data to an existing item.
+ * Prepends data to an existing item.
+ *
  * This method should throw an error if it is used with compressed data. This is an expected behavior.
  * Memcached casts the value to be prepended to the initial value to the type of the initial value. Be
  * careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23 to
  * (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
+ * Memcached casts the value to be prepended to the initial value to the type of the initial value.
+ * Be careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23
+ * to (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
  * (the original value), which will be (int) 45. Due to how memcached treats types, the behavior has been
  * mimicked in the internal cache to produce similar results and improve consistency. It is recommend
+ * mimicked in the internal cache to produce similar results and improve consistency. It is recommended
  * that prepends only occur with data of the same type.
+ *
  * @link http://www.php.net/manual/en/memcached.prepend.php
+ *
  * @param string    $key    The key under which to store the value.
  * @param string    $value  Must be string as prepending mixed values is not well-defined.
  * @param string    $group  The group value prepended to the $key.
  * @return bool             Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.prepend.php
+ *
+ * @param string $key   The key under which to store the value.
+ * @param string $value Must be string as prepending mixed values is not well-defined.
+ * @param string $group The group value prepended to the $key.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_prepend( $key, $value, $group = '' ) {
 …
 /**
  * Append data to an existing item by server key.
+ * Appends data to an existing item by server key.
+ *
  * This method should throw an error if it is used with compressed data. This is an expected behavior.
  * Memcached casts the value to be prepended to the initial value to the type of the initial value. Be
  * careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23 to
  * (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
+ * Memcached casts the value to be prepended to the initial value to the type of the initial value.
+ * Be careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23
+ * to (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
  * (the original value), which will be (int) 45. Due to how memcached treats types, the behavior has been
  * mimicked in the internal cache to produce similar results and improve consistency. It is recommend
+ * mimicked in the internal cache to produce similar results and improve consistency. It is recommended
  * that prepends only occur with data of the same type.
+ *
  * @link http://www.php.net/manual/en/memcached.prependbykey.php
+ *
  * @param string    $server_key     The key identifying the server to store the value on.
  * @param string    $key            The key under which to store the value.
  * @param string    $value          Must be string as prepending mixed values is not well-defined.
  * @param string    $group          The group value prepended to the $key.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.prependbykey.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @param string $key        The key under which to store the value.
+ * @param string $value      Must be string as prepending mixed values is not well-defined.
+ * @param string $group      The group value prepended to the $key.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_prepend_by_key( $server_key, $key, $value, $group = '' ) {
 …
  * Replaces a value in cache.
+ *
  * This method is similar to "add"; however, is does not successfully set a value if
  * the object's key is not already set in cache.
+ *
  * @link http://www.php.net/manual/en/memcached.replace.php
+ *
  * @param string    $key        The key under which to store the value.
  * @param mixed     $value      The value to store.
  * @param string    $group      The group value appended to the $key.
  * @param int       $expiration The expiration time, defaults to 0.
  * @return bool                 Returns TRUE on success or FALSE on failure.
+ * This method is similar to "add"; however, is does not successfully set a value
+ * if the object's key is not already set in cache.
+ *
+ * @link https://www.php.net/manual/en/memcached.replace.php
+ *
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_replace( $key, $value, $group = '', $expiration = 0 ) {
 …
  * Replaces a value in cache on a specific server.
+ *
  * This method is similar to "addByKey"; however, is does not successfully set a value if
  * the object's key is not already set in cache.
+ *
  * @link http://www.php.net/manual/en/memcached.addbykey.php
+ *
  * @param string    $server_key     The key identifying the server to store the value on.
  * @param string    $key            The key under which to store the value.
  * @param mixed     $value          The value to store.
  * @param string    $group          The group value appended to the $key.
  * @param int       $expiration     The expiration time, defaults to 0.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * This method is similar to "addByKey"; however, is does not successfully set a value
+ * if the object's key is not already set in cache.
+ *
+ * @link https://www.php.net/manual/en/memcached.addbykey.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_replace_by_key( $server_key, $key, $value, $group = '', $expiration = 0 ) {
 …
  * The value is set whether or not this key already exists in memcached.
+ *
  * @link http://www.php.net/manual/en/memcached.set.php
+ *
  * @param string    $key        The key under which to store the value.
  * @param mixed     $value      The value to store.
  * @param string    $group      The group value appended to the $key.
  * @param int       $expiration The expiration time, defaults to 0.
  * @return bool                 Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.set.php
+ *
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_set( $key, $value, $group = '', $expiration = 0 ) {
 …
  * The value is set whether or not this key already exists in memcached.
+ *
  * @link http://www.php.net/manual/en/memcached.set.php
+ *
  * @param string    $server_key     The key identifying the server to store the value on.
  * @param string    $key            The key under which to store the value.
  * @param mixed     $value          The value to store.
  * @param string    $group          The group value appended to the $key.
  * @param int       $expiration     The expiration time, defaults to 0.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * @link https://www.php.net/manual/en/memcached.set.php
+ *
+ * @param string $server_key The key identifying the server to store the value on.
+ * @param string $key        The key under which to store the value.
+ * @param mixed  $value      The value to store.
+ * @param string $group      The group value appended to the $key.
+ * @param int    $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_set_by_key( $server_key, $key, $value, $group = '', $expiration = 0 ) {
 …
 /**
  * Set multiple values to cache at once.
+ * Sets multiple values to cache at once.
+ *
  * By sending an array of $items to this function, all values are saved at once to
 …
  * final key for the object.
+ *
  * @param array         $items      An array of key/value pairs to store on the server.
  * @param string|array  $groups     Group(s) to merge with key(s) in $items.
  * @param int           $expiration The expiration time, defaults to 0.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * @param array        $items      An array of key/value pairs to store on the server.
+ * @param string|array $groups     Group(s) to merge with key(s) in $items.
+ * @param int          $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_set_multi( $items, $groups = '', $expiration = 0 ) {
 …
 /**
  * Set multiple values to cache at once on specified server.
+ * Sets multiple values to cache at once on specified server.
+ *
  * By sending an array of $items to this function, all values are saved at once to
 …
  * final key for the object.
+ *
  * @param string        $server_key The key identifying the server to store the value on.
  * @param array         $items      An array of key/value pairs to store on the server.
  * @param string|array  $groups     Group(s) to merge with key(s) in $items.
  * @param int           $expiration The expiration time, defaults to 0.
  * @return bool                     Returns TRUE on success or FALSE on failure.
+ * @param string       $server_key The key identifying the server to store the value on.
+ * @param array        $items      An array of key/value pairs to store on the server.
+ * @param string|array $groups     Group(s) to merge with key(s) in $items.
+ * @param int          $expiration The expiration time, defaults to 0.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_set_multi_by_key( $server_key, $items, $groups = 'default', $expiration = 0 ) {
 …
 /**
  * Set a Memcached option.
+ *
  * @link http://www.php.net/manual/en/memcached.setoption.php
+ *
  * @param int       $option Option name.
  * @param mixed     $value  Option value.
  * @return bool             Returns TRUE on success or FALSE on failure.
+ * Sets a Memcached option.
+ *
+ * @link https://www.php.net/manual/en/memcached.setoption.php
+ *
+ * @param int   $option Option name.
+ * @param mixed $value  Option value.
+ * @return bool True on success, false on failure.
  */
 function wp_cache_set_option( $option, $value ) {
 …
 /**
  * Switch blog prefix, which changes the cache that is accessed.
+ *
  * @param  int     $blog_id    Blog to switch to.
+ * Switches blog prefix, which changes the cache that is accessed.
+ *
+ * @param int $blog_id Blog to switch to.
  * @return void
  */
 …
  * Sets up Object Cache Global and assigns it.
+ *
  * @global  WP_Object_Cache     $wp_object_cache    WordPress Object Cache
  * @return  void
+ * @global WP_Object_Cache $wp_object_cache WordPress Object Cache
+ * @return void
  */
 function wp_cache_init() {
 …
  * Adds a group or set of groups to the list of non-persistent groups.
+ *
  * @param   string|array    $groups     A group or an array of groups to add.
  * @return  void
+ * @param string|array $groups A group or an array of groups to add.
+ * @return void
  */
 function wp_cache_add_global_groups( $groups ) {
 …
  * Adds a group or set of groups to the list of non-Memcached groups.
+ *
  * @param   string|array    $groups     A group or an array of groups to add.
  * @return  void
+ * @param string|array $groups A group or an array of groups to add.
+ * @return void
  */
 function wp_cache_add_non_persistent_groups( $groups ) {
 …
     /**
      * Instantiate the Memcached class.
+     * Instantiates the Memcached class.
+     *
      * Instantiates the Memcached class and returns adds the servers specified
      * in the $memcached_servers global array.
+     *
+     * @link    http://www.php.net/manual/en/memcached.construct.php
+     *
+     * @param   null    $persistent_id      To create an instance that persists between requests, use persistent_id to specify a unique ID for the instance.
+     * @link https://www.php.net/manual/en/memcached.construct.php
+     *
+     * @param null $persistent_id To create an instance that persists between requests,
+     *                            use persistent_id to specify a unique ID for the instance.
      */
     public function __construct( $persistent_id = null ) {
 …
         /**
          * This approach is borrowed from Sivel and Boren. Use the salt for easy cache invalidation and for
          * multi single WP installations on the same server.
+         * This approach is borrowed from Sivel and Boren. Use the salt for easy cache invalidation
+         * and for multi single WP installations on the same server.
          */
         if ( ! defined( 'WP_CACHE_KEY_SALT' ) ) {
 …
+        }
         // Assign global and blog prefixes for use with keys
+        // Assign global and blog prefixes for use with keys.
         if ( function_exists( 'is_multisite' ) ) {
             $this->global_prefix = ( is_multisite() || defined( 'CUSTOM_USER_TABLE' ) && defined( 'CUSTOM_USER_META_TABLE' ) ) ? '' : $table_prefix;
 …
+        }
         // Setup cacheable values for handling expiration times
+        // Setup cacheable values for handling expiration times.
         $this->thirty_days = 60 * 60 * 24 * 30;
         $this->now         = time();
 …
      * returns false.
+     *
      * @link    http://www.php.net/manual/en/memcached.add.php
+     *
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          The value to store.
      * @param   string      $group          The group value appended to the $key.
      * @param   int         $expiration     The expiration time, defaults to 0.
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   bool        $by_key         True to store in internal cache by key; false to not store by key
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.add.php
+     *
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param bool   $by_key     True to store in internal cache by key; false to not store by key.
+     * @return bool True on success, false on failure.
      */
     public function add( $key, $value, $group = 'default', $expiration = 0, $server_key = '', $by_key = false ) {
 …
         $expiration  = $this->sanitize_expiration( $expiration );
         // If group is a non-Memcached group, save to runtime cache, not Memcached
+        // If group is a non-Memcached group, save to runtime cache, not Memcached.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             // Add does not set the value if the key exists; mimic that here
+            // Add does not set the value if the key exists; mimic that here.
             if ( isset( $this->cache[ $derived_key ] ) ) {
                 return false;
 …
+        }
         // Save to Memcached
+        // Save to Memcached.
         if ( $by_key ) {
             $result = $this->m->addByKey( $server_key, $derived_key, $value, $expiration );
 …
+        }
         // Store in runtime cache if add was successful
+        // Store in runtime cache if add was successful.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $this->add_to_internal_cache( $derived_key, $value );
 …
      * specified server_key.
+     *
      * @link    http://www.php.net/manual/en/memcached.addbykey.php
+     *
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          The value to store.
      * @param   string      $group          The group value appended to the $key.
      * @param   int         $expiration     The expiration time, defaults to 0.
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.addbykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @return bool True on success, false on failure.
      */
     public function addByKey( $server_key, $key, $value, $group = 'default', $expiration = 0 ) {
 …
     /**
+     * Add a single server to the list of Memcached servers.
+     *
+     * @link http://www.php.net/manual/en/memcached.addserver.php
+     *
+     * @param   string      $host           The hostname of the memcache server.
+     * @param   int         $port           The port on which memcache is running.
+     * @param   int         $weight         The weight of the server relative to the total weight of all the servers in the pool.
+     * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * Adds a single server to the list of Memcached servers.
+     *
+     * @link https://www.php.net/manual/en/memcached.addserver.php
+     *
+     * @param string $host   The hostname of the memcache server.
+     * @param int    $port   The port on which memcache is running.
+     * @param int    $weight The weight of the server relative to the total weight
+     *                       of all the servers in the pool.
+     * @return bool True on success, false on failure.
      */
     public function addServer( $host, $port, $weight = 0 ) {
 …
      * weight value: $servers = array( array( '127.0.0.1', 11211, 0 ) );
+     *
      * @link    http://www.php.net/manual/en/memcached.addservers.php
+     *
      * @param   array       $servers        Array of server to register.
      * @return  bool                        True on success; false on failure.
+     * @link https://www.php.net/manual/en/memcached.addservers.php
+     *
+     * @param array $servers Array of server to register.
+     * @return bool True on success, false on failure.
      */
     public function addServers( $servers ) {
 …
     /**
      * Append data to an existing item.
+     *
      * This method should throw an error if it is used with compressed data. This
      * is an expected behavior. Memcached casts the value to be appended to the initial value to the
      * type of the initial value. Be careful as this leads to unexpected behavior at times. Due to
      * how memcached treats types, the behavior has been mimicked in the internal cache to produce
      * similar results and improve consistency. It is recommend that appends only occur with data of
+     * Appends data to an existing item.
+     *
+     * This method should throw an error if it is used with compressed data.
+     * This is an expected behavior. Memcached casts the value to be appended to the initial value
+     * to the type of the initial value. Be careful as this leads to unexpected behavior at times.
+     * Due to how memcached treats types, the behavior has been mimicked in the internal cache to produce
+     * similar results and improve consistency. It is recommended that appends only occur with data of
      * the same type.
+     *
      * @link    http://www.php.net/manual/en/memcached.append.php
+     *
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          Must be string as appending mixed values is not well-defined.
      * @param   string      $group          The group value appended to the $key.
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   bool        $by_key         True to store in internal cache by key; false to not store by key
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.append.php
+     *
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      Must be string as appending mixed values is not well-defined.
+     * @param string $group      The group value appended to the $key.
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param bool   $by_key     True to store in internal cache by key; false to not store by key.
+     * @return bool True on success, false on failure.
      */
     public function append( $key, $value, $group = 'default', $server_key = '', $by_key = false ) {
 …
         $derived_key = $this->buildKey( $key, $group );
         // If group is a non-Memcached group, append to runtime cache value, not Memcached
+        // If group is a non-Memcached group, append to runtime cache value, not Memcached.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             if ( ! isset( $this->cache[ $derived_key ] ) ) {
 …
+        }
         // Append to Memcached value
+        // Append to Memcached value.
         if ( $by_key ) {
             $result = $this->m->appendByKey( $server_key, $derived_key, $value );
 …
+        }
         // Store in runtime cache if add was successful
+        // Store in runtime cache if add was successful.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $combined = $this->combine_values( $this->cache[ $derived_key ], $value, 'app' );
 …
     /**
      * Append data to an existing item by server key.
+     *
      * This method should throw an error if it is used with compressed data. This
      * is an expected behavior. Memcached casts the value to be appended to the initial value to the
      * type of the initial value. Be careful as this leads to unexpected behavior at times. Due to
      * how memcached treats types, the behavior has been mimicked in the internal cache to produce
      * similar results and improve consistency. It is recommend that appends only occur with data of
+     * Appends data to an existing item by server key.
+     *
+     * This method should throw an error if it is used with compressed data.
+     * This is an expected behavior. Memcached casts the value to be appended to the initial value
+     * to the type of the initial value. Be careful as this leads to unexpected behavior at times.
+     * Due to how memcached treats types, the behavior has been mimicked in the internal cache to produce
+     * similar results and improve consistency. It is recommended that appends only occur with data of
      * the same type.
+     *
      * @link    http://www.php.net/manual/en/memcached.appendbykey.php
+     *
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          Must be string as appending mixed values is not well-defined
      * @param   string      $group          The group value appended to the $key.
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.appendbykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      Must be string as appending mixed values is not well-defined.
+     * @param string $group      The group value appended to the $key.
+     * @return bool True on success, false on failure.
      */
     public function appendByKey( $server_key, $key, $value, $group = 'default' ) {
 …
      * Performs a "check and set" to store data.
+     *
      * The set will be successful only if the no other request has updated the value since it was fetched since
      * this request.
+     *
      * @link    http://www.php.net/manual/en/memcached.cas.php
+     *
      * @param   float       $cas_token      Unique value associated with the existing item. Generated by memcached.
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          The value to store.
      * @param   string      $group          The group value appended to the $key.
      * @param   int         $expiration     The expiration time, defaults to 0.
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   bool        $by_key         True to store in internal cache by key; false to not store by key
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * The set will be successful only if the no other request has updated the value
+     * since it was fetched by this request.
+     *
+     * @link https://www.php.net/manual/en/memcached.cas.php
+     *
+     * @param float  $cas_token  Unique value associated with the existing item. Generated by memcached.
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param bool   $by_key     True to store in internal cache by key; false to not store by key.
+     * @return bool True on success, false on failure.
      */
     public function cas( $cas_token, $key, $value, $group = 'default', $expiration = 0, $server_key = '', $by_key = false ) {
 …
+        }
         // Save to Memcached
+        // Save to Memcached.
         if ( $by_key ) {
             $result = $this->m->casByKey( $cas_token, $server_key, $derived_key, $value, $expiration );
 …
+        }
         // Store in runtime cache if cas was successful
+        // Store in runtime cache if cas was successful.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $this->add_to_internal_cache( $derived_key, $value );
 …
      * Performs a "check and set" to store data with a server key.
+     *
      * The set will be successful only if the no other request has updated the value since it was fetched by
      * this request.
+     *
      * @link    http://www.php.net/manual/en/memcached.casbykey.php
+     *
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   float       $cas_token      Unique value associated with the existing item. Generated by memcached.
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          The value to store.
      * @param   string      $group          The group value appended to the $key.
      * @param   int         $expiration     The expiration time, defaults to 0.
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * The set will be successful only if the no other request has updated the value
+     * since it was fetched by this request.
+     *
+     * @link https://www.php.net/manual/en/memcached.casbykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param float  $cas_token  Unique value associated with the existing item. Generated by memcached.
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @return bool True on success, false on failure.
      */
     public function casByKey( $cas_token, $server_key, $key, $value, $group = 'default', $expiration = 0 ) {
 …
     /**
      * Decrement a numeric item's value.
+     *
      * @link http://www.php.net/manual/en/memcached.decrement.php
+     *
      * @param string    $key    The key under which to store the value.
      * @param int       $offset The amount by which to decrement the item's value.
      * @param string    $group  The group value appended to the $key.
      * @return int|bool         Returns item's new value on success or FALSE on failure.
+     * Decrements a numeric item's value.
+     *
+     * @link https://www.php.net/manual/en/memcached.decrement.php
+     *
+     * @param string $key    The key under which to store the value.
+     * @param int    $offset The amount by which to decrement the item's value.
+     * @param string $group  The group value appended to the $key.
+     * @return int|bool Item's new value on success, false on failure.
      */
     public function decrement( $key, $offset = 1, $group = 'default' ) {
         $derived_key = $this->buildKey( $key, $group );
         // Decrement values in no_mc_groups
+        // Decrement values in no_mc_groups.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             // Only decrement if the key already exists and value is 0 or greater (mimics memcached behavior)
+            // Only decrement if the key already exists and value is 0 or greater (mimics memcached behavior).
             if ( isset( $this->cache[ $derived_key ] ) && $this->cache[ $derived_key ] >= 0 ) {
                 // If numeric, subtract; otherwise, consider it 0 and do nothing
+                // If numeric, subtract; otherwise, consider it 0 and do nothing.
                 if ( is_numeric( $this->cache[ $derived_key ] ) ) {
                     $this->cache[ $derived_key ] -= (int) $offset;
 …
+                }
                 // Returned value cannot be less than 0
+                // Returned value cannot be less than 0.
                 if ( $this->cache[ $derived_key ] < 0 ) {
                     $this->cache[ $derived_key ] = 0;
 …
     /**
+     * Decrement a numeric item's value.
+     *
+     * Alias for $this->decrement. Other caching backends use this abbreviated form of the function. It *may* cause
+     * breakage somewhere, so it is nice to have. This function will also allow the core unit tests to pass.
+     *
+     * @param string    $key    The key under which to store the value.
+     * @param int       $offset The amount by which to decrement the item's value.
+     * @param string    $group  The group value appended to the $key.
+     * @return int|bool         Returns item's new value on success or FALSE on failure.
+     * Decrements a numeric item's value.
+     *
+     * Alias for $this->decrement(). Other caching backends use this abbreviated form
+     * of the function. It *may* cause breakage somewhere, so it is nice to have.
+     * This function will also allow the core unit tests to pass.
+     *
+     * @param string $key    The key under which to store the value.
+     * @param int    $offset The amount by which to decrement the item's value.
+     * @param string $group  The group value appended to the $key.
+     * @return int|bool Item's new value on success, false on failure.
      */
     public function decr( $key, $offset = 1, $group = 'default' ) {
 …
     /**
      * Remove the item from the cache.
+     *
      * Remove an item from memcached with identified by $key after $time seconds. The
      * $time parameter allows an object to be queued for deletion without immediately
      * deleting. Between the time that it is queued and the time it's deleted, add,
      * replace, and get will fail, but set will succeed.
+     *
      * @link http://www.php.net/manual/en/memcached.delete.php
+     *
      * @param   string      $key        The key under which to store the value.
      * @param   string      $group      The group value appended to the $key.
      * @param   int         $time       The amount of time the server will wait to delete the item in seconds.
      * @param   string      $server_key The key identifying the server to store the value on.
      * @param   bool        $by_key     True to store in internal cache by key; false to not store by key
      * @return  bool                    Returns TRUE on success or FALSE on failure.
+     * Removes the item from the cache.
+     *
+     * Removes an item from memcached with identified by $key after $time seconds.
+     * The $time parameter allows an object to be queued for deletion without
+     * immediately deleting. Between the time that it is queued and the time it's deleted,
+     * add, replace, and get will fail, but set will succeed.
+     *
+     * @link https://www.php.net/manual/en/memcached.delete.php
+     *
+     * @param string $key        The key under which to store the value.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $time       The amount of time the server will wait to delete the item in seconds.
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param bool   $by_key     True to store in internal cache by key; false to not store by key.
+     * @return bool True on success, false on failure.
      */
     public function delete( $key, $group = 'default', $time = 0, $server_key = '', $by_key = false ) {
         $derived_key = $this->buildKey( $key, $group );
         // Remove from no_mc_groups array
+        // Remove from no_mc_groups array.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             if ( isset( $this->cache[ $derived_key ] ) ) {
 …
     /**
      * Remove the item from the cache by server key.
+     *
      * Remove an item from memcached with identified by $key after $time seconds. The
      * $time parameter allows an object to be queued for deletion without immediately
      * deleting. Between the time that it is queued and the time it's deleted, add,
      * replace, and get will fail, but set will succeed.
+     *
      * @link http://www.php.net/manual/en/memcached.deletebykey.php
+     *
      * @param   string      $server_key The key identifying the server to store the value on.
      * @param   string      $key        The key under which to store the value.
      * @param   string      $group      The group value appended to the $key.
      * @param   int         $time       The amount of time the server will wait to delete the item in seconds.
      * @return  bool                    Returns TRUE on success or FALSE on failure.
+     * Removes the item from the cache by server key.
+     *
+     * Removes an item from memcached with identified by $key after $time seconds.
+     * The $time parameter allows an object to be queued for deletion without
+     * immediately deleting. Between the time that it is queued and the time it's deleted,
+     * add, replace, and get will fail, but set will succeed.
+     *
+     * @link https://www.php.net/manual/en/memcached.deletebykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param string $key        The key under which to store the value.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $time       The amount of time the server will wait to delete the item in seconds.
+     * @return bool True on success, false on failure.
      */
     public function deleteByKey( $server_key, $key, $group = 'default', $time = 0 ) {
 …
     /**
      * Fetch the next result.
+     *
      * @link http://www.php.net/manual/en/memcached.fetch.php
+     *
      * @return array|bool   Returns the next result or FALSE on failure.
+     * Fetches the next result.
+     *
+     * @link https://www.php.net/manual/en/memcached.fetch.php
+     *
+     * @return array|false The next result on success, false on failure.
      */
     public function fetch() {
 …
     /**
      * Fetch all remaining results from the last request.
+     *
      * @link http://www.php.net/manual/en/memcached.fetchall.php
+     *
      * @return  array|bool          Returns the results or FALSE on failure.
+     * Fetches all remaining results from the last request.
+     *
+     * @link https://www.php.net/manual/en/memcached.fetchall.php
+     *
+     * @return array|false The results on success, false on failure.
      */
     public function fetchAll() {
 …
     /**
      * Invalidate all items in the cache.
+     *
      * @link http://www.php.net/manual/en/memcached.flush.php
+     *
      * @param   int     $delay      Number of seconds to wait before invalidating the items.
      * @return  bool                Returns TRUE on success or FALSE on failure.
+     * Invalidates all items in the cache.
+     *
+     * @link https://www.php.net/manual/en/memcached.flush.php
+     *
+     * @param int $delay Number of seconds to wait before invalidating the items.
+     * @return bool True on success, false on failure.
      */
     public function flush( $delay = 0 ) {
         $result = $this->m->flush( $delay );
         // Only reset the runtime cache if memcached was properly flushed
+        // Only reset the runtime cache if memcached was properly flushed.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $this->cache = array();
 …
     /**
+     * Retrieve object from cache.
+     *
+     * Gets an object from cache based on $key and $group. In order to fully support the $cache_cb and $cas_token
+     * parameters, the runtime cache is ignored by this function if either of those values are set. If either of
+     * those values are set, the request is made directly to the memcached server for proper handling of the
+     * callback and/or token. Note that the $cas_token variable cannot be directly passed to the function. The
+     * variable need to be first defined with a non null value.
+     *
+     * If using the $cache_cb argument, the new value will always have an expiration of time of 0 (forever). This
+     * is a limitation of the Memcached PECL extension.
+     *
+     * @link http://www.php.net/manual/en/memcached.get.php
+     *
+     * @param   string          $key        The key under which to store the value.
+     * @param   string          $group      The group value appended to the $key.
+     * @param   bool            $force      Whether or not to force a cache invalidation.
+     * @param   null|bool       $found      Variable passed by reference to determine if the value was found or not.
+     * @param   string          $server_key The key identifying the server to store the value on.
+     * @param   bool            $by_key     True to store in internal cache by key; false to not store by key
+     * @param   null|callable   $cache_cb   Read-through caching callback.
+     * @param   null|float      $cas_token  The variable to store the CAS token in.
+     * @return  bool|mixed                  Cached object value.
+     * Retrieves object from cache.
+     *
+     * Gets an object from cache based on $key and $group. In order to fully support
+     * the $cache_cb and $cas_token parameters, the runtime cache is ignored by this function
+     * if either of those values are set. In that case, the request is made directly
+     * to the memcached server for proper handling of the callback and/or token.
+     * Note that the $cas_token variable cannot be directly passed to the function.
+     * The variable needs to be first defined with a non-null value.
+     *
+     * If using the $cache_cb argument, the new value will always have an expiration
+     * of time of 0 (forever). This is a limitation of the Memcached PECL extension.
+     *
+     * @link https://www.php.net/manual/en/memcached.get.php
+     *
+     * @param string        $key        The key under which to store the value.
+     * @param string        $group      The group value appended to the $key.
+     * @param bool          $force      Whether or not to force a cache invalidation.
+     * @param null|bool     $found      Variable passed by reference to determine if the value was found or not.
+     * @param string        $server_key The key identifying the server to store the value on.
+     * @param bool          $by_key     True to store in internal cache by key; false to not store by key.
+     * @param null|callable $cache_cb   Read-through caching callback.
+     * @param null|float    $cas_token  The variable to store the CAS token in.
+     * @return bool|mixed Cached object value.
      */
     public function get( $key, $group = 'default', $force = false, &$found = null, $server_key = '', $by_key = false, $cache_cb = null, &$cas_token = null ) {
         $derived_key = $this->buildKey( $key, $group );
         // Assume object is not found
+        // Assume object is not found.
         $found = false;
         // If either $cache_db, or $cas_token is set, must hit Memcached and bypass runtime cache
+        // If either $cache_db, or $cas_token is set, must hit Memcached and bypass runtime cache.
         if ( func_num_args() > 6 && ! in_array( $group, $this->no_mc_groups, true ) ) {
             if ( $by_key ) {
 …
     /**
+     * Retrieve object from cache from specified server.
+     *
+     * Gets an object from cache based on $key, $group and $server_key. In order to fully support the $cache_cb and $cas_token
+     * parameters, the runtime cache is ignored by this function if either of those values are set. If either of
+     * those values are set, the request is made directly to the memcached server for proper handling of the
+     * callback and/or token. Note that the $cas_token variable cannot be directly passed to the function. The
+     * variable need to be first defined with a non null value.
+     *
+     * If using the $cache_cb argument, the new value will always have an expiration of time of 0 (forever). This
+     * is a limitation of the Memcached PECL extension.
+     *
+     * @link http://www.php.net/manual/en/memcached.getbykey.php
+     *
+     * @param   string          $server_key The key identifying the server to store the value on.
+     * @param   string          $key        The key under which to store the value.
+     * @param   string          $group      The group value appended to the $key.
+     * @param   bool            $force      Whether or not to force a cache invalidation.
+     * @param   null|bool       $found      Variable passed by reference to determine if the value was found or not.
+     * @param   null|string     $cache_cb   Read-through caching callback.
+     * @param   null|float      $cas_token  The variable to store the CAS token in.
+     * @return  bool|mixed                  Cached object value.
+     * Retrieves object from cache from specified server.
+     *
+     * Gets an object from cache based on $key and $group, and $server_key. In order to fully support
+     * the $cache_cb and $cas_token parameters, the runtime cache is ignored by this function
+     * if either of those values are set. In that case, the request is made directly
+     * to the memcached server for proper handling of the callback and/or token.
+     * Note that the $cas_token variable cannot be directly passed to the function.
+     * The variable needs to be first defined with a non-null value.
+     *
+     * If using the $cache_cb argument, the new value will always have an expiration
+     * of time of 0 (forever). This is a limitation of the Memcached PECL extension.
+     *
+     * @link https://www.php.net/manual/en/memcached.getbykey.php
+     *
+     * @param string      $server_key The key identifying the server to store the value on.
+     * @param string      $key        The key under which to store the value.
+     * @param string      $group      The group value appended to the $key.
+     * @param bool        $force      Whether or not to force a cache invalidation.
+     * @param null|bool   $found      Variable passed by reference to determine if the value was found or not.
+     * @param null|string $cache_cb   Read-through caching callback.
+     * @param null|float  $cas_token  The variable to store the CAS token in.
+     * @return bool|mixed Cached object value.
      */
     public function getByKey( $server_key, $key, $group = 'default', $force = false, &$found = null, $cache_cb = null, &$cas_token = null ) {
 …
     /**
+     * Request multiple keys without blocking.
+     *
+     * @link http://www.php.net/manual/en/memcached.getdelayed.php
+     *
+     * @param   string|array    $keys       Array or string of key(s) to request.
+     * @param   string|array    $groups     Array or string of group(s) for the key(s). See buildKeys for more on how these are handled.
+     * @param   bool            $with_cas   Whether to request CAS token values also.
+     * @param   null            $value_cb   The result callback or NULL.
+     * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * Requests multiple keys without blocking.
+     *
+     * @link https://www.php.net/manual/en/memcached.getdelayed.php
+     *
+     * @param string|array $keys     Array or string of key(s) to request.
+     * @param string|array $groups   Array or string of group(s) for the key(s).
+     *                               See buildKeys for more on how these are handled.
+     * @param bool         $with_cas Whether to request CAS token values also.
+     * @param null         $value_cb The result callback or null.
+     * @return bool True on success, false on failure.
      */
     public function getDelayed( $keys, $groups = 'default', $with_cas = false, $value_cb = null ) {
 …
     /**
+     * Request multiple keys without blocking from a specified server.
+     *
+     * @link http://www.php.net/manual/en/memcached.getdelayed.php
+     *
+     * @param   string          $server_key The key identifying the server to store the value on.
+     * @param   string|array    $keys       Array or string of key(s) to request.
+     * @param   string|array    $groups     Array or string of group(s) for the key(s). See buildKeys for more on how these are handled.
+     * @param   bool            $with_cas   Whether to request CAS token values also.
+     * @param   null            $value_cb   The result callback or NULL.
+     * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * Requests multiple keys without blocking from a specified server.
+     *
+     * @link https://www.php.net/manual/en/memcached.getdelayed.php
+     *
+     * @param string       $server_key The key identifying the server to store the value on.
+     * @param string|array $keys       Array or string of key(s) to request.
+     * @param string|array $groups     Array or string of group(s) for the key(s).
+     *                                 See buildKeys for more on how these are handled.
+     * @param bool         $with_cas   Whether to request CAS token values also.
+     * @param null         $value_cb   The result callback or null.
+     * @return bool True on success, false on failure.
      */
     public function getDelayedByKey( $server_key, $keys, $groups = 'default', $with_cas = false, $value_cb = null ) {
 …
      * See the buildKeys method definition to understand the $keys/$groups parameters.
+     *
+     * @link http://www.php.net/manual/en/memcached.getmulti.php
+     *
+     * @param   array           $keys       Array of keys to retrieve.
+     * @param   string|array    $groups     If string, used for all keys. If arrays, corresponds with the $keys array.
+     * @param   string          $server_key The key identifying the server to store the value on.
+     * @param   null|array      $cas_tokens The variable to store the CAS tokens for the found items.
+     * @param   int             $flags      The flags for the get operation.
+     * @return  bool|array                  Returns the array of found items or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.getmulti.php
+     *
+     * @param array        $keys       Array of keys to retrieve.
+     * @param string|array $groups     If string, used for all keys.
+     *                                 If arrays, corresponds with the $keys array.
+     * @param string       $server_key The key identifying the server to store the value on.
+     * @param null|array   $cas_tokens The variable to store the CAS tokens for the found items.
+     * @param int          $flags      The flags for the get operation.
+     * @return bool|array The array of found items on success, false on failure.
      */
     public function getMulti( $keys, $groups = 'default', $server_key = '', &$cas_tokens = null, $flags = null ) {
 …
         /**
          * If either $cas_tokens, or $flags is set, must hit Memcached and bypass runtime cache. Note that
          * this will purposely ignore no_mc_groups values as they cannot handle CAS tokens or the special
          * flags; however, if the groups of groups contains a no_mc_group, this is bypassed.
+         * If either $cas_tokens, or $flags is set, must hit Memcached and bypass runtime cache.
+         * Note that this will purposely ignore no_mc_groups values as they cannot handle CAS tokens
+         * or the special flags; however, if the groups of groups contains a no_mc_group, this is bypassed.
          */
         if ( func_num_args() > 3 && ! $this->contains_no_mc_group( $groups ) ) {
 …
             $need_to_get = array();
             // Pull out values from runtime cache, or mark for retrieval
+            // Pull out values from runtime cache, or mark for retrieval.
             foreach ( $derived_keys as $key ) {
                 if ( isset( $this->cache[ $key ] ) ) {
 …
+            }
             // Get those keys not found in the runtime cache
+            // Get those keys not found in the runtime cache.
             if ( ! empty( $need_to_get ) ) {
                 if ( ! empty( $server_key ) ) {
 …
+            }
             // Merge with values found in runtime cache
+            // Merge with values found in runtime cache.
             if ( isset( $result ) && Memcached::RES_SUCCESS === $this->getResultCode() ) {
                 $values = array_merge( $values, $result );
+            }
             // If order should be preserved, reorder now
+            // If order should be preserved, reorder now.
             if ( ! empty( $need_to_get ) && Memcached::GET_PRESERVE_ORDER === $flags ) {
                 $ordered_values = array();
 …
+        }
         // Add the values to the runtime cache
+        // Add the values to the runtime cache.
         $this->cache = array_merge( $this->cache, $values );
 …
      * See the buildKeys method definition to understand the $keys/$groups parameters.
+     *
+     * @link http://www.php.net/manual/en/memcached.getmultibykey.php
+     *
+     * @param   string          $server_key The key identifying the server to store the value on.
+     * @param   array           $keys       Array of keys to retrieve.
+     * @param   string|array    $groups     If string, used for all keys. If arrays, corresponds with the $keys array.
+     * @param   null|array      $cas_tokens The variable to store the CAS tokens for the found items.
+     * @param   int             $flags      The flags for the get operation.
+     * @return  bool|array                  Returns the array of found items or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.getmultibykey.php
+     *
+     * @param string       $server_key The key identifying the server to store the value on.
+     * @param array        $keys       Array of keys to retrieve.
+     * @param string|array $groups     If string, used for all keys.
+     *                                 If arrays, corresponds with the $keys array.
+     * @param null|array   $cas_tokens The variable to store the CAS tokens for the found items.
+     * @param int          $flags      The flags for the get operation.
+     * @return bool|array The array of found items on success, false on failure.
      */
     public function getMultiByKey( $server_key, $keys, $groups = 'default', &$cas_tokens = null, $flags = null ) {
 …
     /**
      * Retrieve a Memcached option value.
+     *
      * @link http://www.php.net/manual/en/memcached.getoption.php
+     *
      * @param   int         $option     One of the Memcached::OPT_* constants.
      * @return  mixed                   Returns the value of the requested option, or FALSE on error.
+     * Retrieves a Memcached option value.
+     *
+     * @link https://www.php.net/manual/en/memcached.getoption.php
+     *
+     * @param int $option One of the Memcached::OPT_* constants.
+     * @return mixed The value of the requested option on success, false on failure.
      */
     public function getOption( $option ) {
 …
     /**
      * Return the result code of the last option.
+     *
      * @link http://www.php.net/manual/en/memcached.getresultcode.php
+     *
      * @return  int     Result code of the last Memcached operation.
+     * Returns the result code of the last option.
+     *
+     * @link https://www.php.net/manual/en/memcached.getresultcode.php
+     *
+     * @return int Result code of the last Memcached operation.
      */
     public function getResultCode() {
 …
      * Return the message describing the result of the last operation.
+     *
      * @link    http://www.php.net/manual/en/memcached.getresultmessage.php
+     *
      * @return  string      Message describing the result of the last Memcached operation.
+     * @link https://www.php.net/manual/en/memcached.getresultmessage.php
+     *
+     * @return string Message describing the result of the last Memcached operation.
      */
     public function getResultMessage() {
 …
     /**
      * Get server information by key.
+     *
      * @link    http://www.php.net/manual/en/memcached.getserverbykey.php
+     *
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @return  array                       Array with host, post, and weight on success, FALSE on failure.
+     * Gets server information by key.
+     *
+     * @link https://www.php.net/manual/en/memcached.getserverbykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @return array Array with host, post, and weight on success, false on failure.
      */
     public function getServerByKey( $server_key ) {
 …
     /**
      * Get the list of servers in the pool.
+     *
      * @link    http://www.php.net/manual/en/memcached.getserverlist.php
+     *
      * @return  array       The list of all servers in the server pool.
+     * Gets the list of servers in the pool.
+     *
+     * @link https://www.php.net/manual/en/memcached.getserverlist.php
+     *
+     * @return array The list of all servers in the server pool.
      */
     public function getServerList() {
 …
     /**
      * Get server pool statistics.
+     *
      * @link    http://www.php.net/manual/en/memcached.getstats.php
+     *
      * @return  array       Array of server statistics, one entry per server.
+     * Gets server pool statistics.
+     *
+     * @link https://www.php.net/manual/en/memcached.getstats.php
+     *
+     * @return array Array of server statistics, one entry per server.
      */
     public function getStats() {
 …
     /**
      * Get server pool memcached version information.
+     *
      * @link    http://www.php.net/manual/en/memcached.getversion.php
+     *
      * @return  array       Array of server versions, one entry per server.
+     * Gets server pool memcached version information.
+     *
+     * @link https://www.php.net/manual/en/memcached.getversion.php
+     *
+     * @return array Array of server versions, one entry per server.
      */
     public function getVersion() {
 …
     /**
      * Increment a numeric item's value.
+     *
      * @link http://www.php.net/manual/en/memcached.increment.php
+     *
      * @param   string      $key        The key under which to store the value.
      * @param   int         $offset     The amount by which to increment the item's value.
      * @param   string      $group      The group value appended to the $key.
      * @return  int|bool                Returns item's new value on success or FALSE on failure.
+     * Increments a numeric item's value.
+     *
+     * @link https://www.php.net/manual/en/memcached.increment.php
+     *
+     * @param string $key    The key under which to store the value.
+     * @param int    $offset The amount by which to increment the item's value.
+     * @param string $group  The group value appended to the $key.
+     * @return int|bool Item's new value on success, false on failure.
      */
     public function increment( $key, $offset = 1, $group = 'default' ) {
         $derived_key = $this->buildKey( $key, $group );
         // Increment values in no_mc_groups
+        // Increment values in no_mc_groups.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             // Only increment if the key already exists and the number is currently 0 or greater (mimics memcached behavior)
+            // Only increment if the key already exists and the number is currently 0 or greater (mimics memcached behavior).
             if ( isset( $this->cache[ $derived_key ] ) && $this->cache[ $derived_key ] >= 0 ) {
                 // If numeric, add; otherwise, consider it 0 and do nothing
+                // If numeric, add; otherwise, consider it 0 and do nothing.
                 if ( is_numeric( $this->cache[ $derived_key ] ) ) {
                     $this->cache[ $derived_key ] += (int) $offset;
 …
+                }
                 // Returned value cannot be less than 0
+                // Returned value cannot be less than 0.
                 if ( $this->cache[ $derived_key ] < 0 ) {
                     $this->cache[ $derived_key ] = 0;
 …
     /**
+     * Synonymous with $this->incr.
+     *
+     * Certain plugins expect an "incr" method on the $wp_object_cache object (e.g., Batcache). Since the original
+     * version of this library matched names to the memcached methods, the "incr" method was missing. Adding this
+     * method restores compatibility with plugins expecting an "incr" method.
+     *
+     * @param   string      $key        The key under which to store the value.
+     * @param   int         $offset     The amount by which to increment the item's value.
+     * @param   string      $group      The group value appended to the $key.
+     * @return  int|bool                Returns item's new value on success or FALSE on failure.
+     * Alias for $this->incr().
+     *
+     * Certain plugins expect an "incr" method on the $wp_object_cache object (e.g., Batcache).
+     * Since the original version of this library matched names to the memcached methods,
+     * the "incr" method was missing. Adding this method restores compatibility with plugins
+     * expecting an "incr" method.
+     *
+     * @param string $key    The key under which to store the value.
+     * @param int    $offset The amount by which to increment the item's value.
+     * @param string $group  The group value appended to the $key.
+     * @return int|bool Item's new value on success, false on failure.
      */
     public function incr( $key, $offset = 1, $group = 'default' ) {
 …
     /**
      * Prepend data to an existing item.
+     * Prepends data to an existing item.
+     *
      * This method should throw an error if it is used with compressed data. This is an expected behavior.
      * Memcached casts the value to be prepended to the initial value to the type of the initial value. Be
      * careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23 to
      * (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
+     * Memcached casts the value to be prepended to the initial value to the type of the initial value.
+     * Be careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23
+     * to (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
      * (the original value), which will be (int) 45. Due to how memcached treats types, the behavior has been
      * mimicked in the internal cache to produce similar results and improve consistency. It is recommend
+     * mimicked in the internal cache to produce similar results and improve consistency. It is recommended
      * that prepends only occur with data of the same type.
+     *
      * @link    http://www.php.net/manual/en/memcached.prepend.php
+     *
      * @param   string    $key          The key under which to store the value.
      * @param   string    $value        Must be string as prepending mixed values is not well-defined.
      * @param   string    $group        The group value prepended to the $key.
      * @param   string    $server_key   The key identifying the server to store the value on.
      * @param   bool      $by_key       True to store in internal cache by key; false to not store by key
      * @return  bool                    Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.prepend.php
+     *
+     * @param string $key        The key under which to store the value.
+     * @param string $value      Must be string as prepending mixed values is not well-defined.
+     * @param string $group      The group value prepended to the $key.
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param bool   $by_key     True to store in internal cache by key; false to not store by key.
+     * @return bool True on success, false on failure.
      */
     public function prepend( $key, $value, $group = 'default', $server_key = '', $by_key = false ) {
 …
         $derived_key = $this->buildKey( $key, $group );
         // If group is a non-Memcached group, prepend to runtime cache value, not Memcached
+        // If group is a non-Memcached group, prepend to runtime cache value, not Memcached.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             if ( ! isset( $this->cache[ $derived_key ] ) ) {
 …
+        }
         // Append to Memcached value
+        // Append to Memcached value.
         if ( $by_key ) {
             $result = $this->m->prependByKey( $server_key, $derived_key, $value );
 …
+        }
         // Store in runtime cache if add was successful
+        // Store in runtime cache if add was successful.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $combined = $this->combine_values( $this->cache[ $derived_key ], $value, 'pre' );
 …
     /**
      * Append data to an existing item by server key.
+     * Appends data to an existing item by server key.
+     *
      * This method should throw an error if it is used with compressed data. This is an expected behavior.
      * Memcached casts the value to be prepended to the initial value to the type of the initial value. Be
      * careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23 to
      * (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
+     * Memcached casts the value to be prepended to the initial value to the type of the initial value.
+     * Be careful as this leads to unexpected behavior at times. For instance, prepending (float) 45.23
+     * to (int) 23 will result in 45, because the value is first combined (45.2323) then cast to "integer"
      * (the original value), which will be (int) 45. Due to how memcached treats types, the behavior has been
      * mimicked in the internal cache to produce similar results and improve consistency. It is recommend
+     * mimicked in the internal cache to produce similar results and improve consistency. It is recommended
      * that prepends only occur with data of the same type.
+     *
      * @link    http://www.php.net/manual/en/memcached.prependbykey.php
+     *
      * @param   string    $server_key   The key identifying the server to store the value on.
      * @param   string    $key          The key under which to store the value.
      * @param   string    $value        Must be string as prepending mixed values is not well-defined.
      * @param   string    $group        The group value prepended to the $key.
      * @return  bool                    Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.prependbykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param string $key        The key under which to store the value.
+     * @param string $value      Must be string as prepending mixed values is not well-defined.
+     * @param string $group      The group value prepended to the $key.
+     * @return bool True on success, false on failure.
      */
     public function prependByKey( $server_key, $key, $value, $group = 'default' ) {
 …
      * Replaces a value in cache.
+     *
      * This method is similar to "add"; however, is does not successfully set a value if
      * the object's key is not already set in cache.
+     *
      * @link    http://www.php.net/manual/en/memcached.replace.php
+     *
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          The value to store.
      * @param   string      $group          The group value appended to the $key.
      * @param   bool        $by_key         True to store in internal cache by key; false to not store by key
      * @param   int         $expiration     The expiration time, defaults to 0.
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * This method is similar to "add"; however, is does not successfully set a value
+     * if the object's key is not already set in cache.
+     *
+     * @link https://www.php.net/manual/en/memcached.replace.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param bool   $by_key     True to store in internal cache by key; false to not store by key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @return bool True on success, false on failure.
      */
     public function replace( $key, $value, $group = 'default', $expiration = 0, $server_key = '', $by_key = false ) {
 …
         $expiration  = $this->sanitize_expiration( $expiration );
         // If group is a non-Memcached group, save to runtime cache, not Memcached
+        // If group is a non-Memcached group, save to runtime cache, not Memcached.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             // Replace won't save unless the key already exists; mimic this behavior here
+            // Replace won't save unless the key already exists; mimic this behavior here.
             if ( ! isset( $this->cache[ $derived_key ] ) ) {
                 return false;
 …
+        }
         // Save to Memcached
+        // Save to Memcached.
         if ( $by_key ) {
             $result = $this->m->replaceByKey( $server_key, $derived_key, $value, $expiration );
 …
+        }
         // Store in runtime cache if add was successful
+        // Store in runtime cache if add was successful.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $this->add_to_internal_cache( $derived_key, $value );
 …
      * Replaces a value in cache on a specific server.
+     *
      * This method is similar to "addByKey"; however, is does not successfully set a value if
      * the object's key is not already set in cache.
+     *
      * @link    http://www.php.net/manual/en/memcached.addbykey.php
+     *
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          The value to store.
      * @param   string      $group          The group value appended to the $key.
      * @param   int         $expiration     The expiration time, defaults to 0.
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * This method is similar to "addByKey"; however, is does not successfully set a value
+     * if the object's key is not already set in cache.
+     *
+     * @link https://www.php.net/manual/en/memcached.addbykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @return bool True on success, false on failure.
      */
     public function replaceByKey( $server_key, $key, $value, $group = 'default', $expiration = 0 ) {
 …
      * The value is set whether or not this key already exists in memcached.
+     *
      * @link http://www.php.net/manual/en/memcached.set.php
+     *
      * @param   string      $key        The key under which to store the value.
      * @param   mixed       $value      The value to store.
      * @param   string      $group      The group value appended to the $key.
      * @param   int         $expiration The expiration time, defaults to 0.
      * @param   string      $server_key The key identifying the server to store the value on.
      * @param   bool        $by_key     True to store in internal cache by key; false to not store by key
      * @return  bool                    Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.set.php
+     *
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param bool   $by_key     True to store in internal cache by key; false to not store by key.
+     * @return bool True on success, false on failure.
      */
     public function set( $key, $value, $group = 'default', $expiration = 0, $server_key = '', $by_key = false ) {
 …
         $expiration  = $this->sanitize_expiration( $expiration );
         // If group is a non-Memcached group, save to runtime cache, not Memcached
+        // If group is a non-Memcached group, save to runtime cache, not Memcached.
         if ( in_array( $group, $this->no_mc_groups, true ) ) {
             $this->add_to_internal_cache( $derived_key, $value );
 …
+        }
         // Save to Memcached
+        // Save to Memcached.
         if ( $by_key ) {
             $result = $this->m->setByKey( $server_key, $derived_key, $value, $expiration );
 …
+        }
         // Store in runtime cache if add was successful
+        // Store in runtime cache if add was successful.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $this->add_to_internal_cache( $derived_key, $value );
 …
      * The value is set whether or not this key already exists in memcached.
+     *
      * @link    http://www.php.net/manual/en/memcached.setbykey.php
+     *
      * @param   string      $server_key     The key identifying the server to store the value on.
      * @param   string      $key            The key under which to store the value.
      * @param   mixed       $value          The value to store.
      * @param   string      $group          The group value appended to the $key.
      * @param   int         $expiration     The expiration time, defaults to 0.
      * @return  bool                        Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.setbykey.php
+     *
+     * @param string $server_key The key identifying the server to store the value on.
+     * @param string $key        The key under which to store the value.
+     * @param mixed  $value      The value to store.
+     * @param string $group      The group value appended to the $key.
+     * @param int    $expiration The expiration time, defaults to 0.
+     * @return bool True on success, false on failure.
      */
     public function setByKey( $server_key, $key, $value, $group = 'default', $expiration = 0 ) {
 …
     /**
      * Set multiple values to cache at once.
+     * Sets multiple values to cache at once.
+     *
      * By sending an array of $items to this function, all values are saved at once to
 …
      * final key for the object.
+     *
      * @link    http://www.php.net/manual/en/memcached.setmulti.php
+     *
      * @param   array           $items          An array of key/value pairs to store on the server.
      * @param   string|array    $groups         Group(s) to merge with key(s) in $items.
      * @param   int             $expiration     The expiration time, defaults to 0.
      * @param   string          $server_key     The key identifying the server to store the value on.
      * @param   bool            $by_key         True to store in internal cache by key; false to not store by key
      * @return  bool                            Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.setmulti.php
+     *
+     * @param array        $items      An array of key/value pairs to store on the server.
+     * @param string|array $groups     Group(s) to merge with key(s) in $items.
+     * @param int          $expiration The expiration time, defaults to 0.
+     * @param string       $server_key The key identifying the server to store the value on.
+     * @param bool         $by_key     True to store in internal cache by key; false to not store by key.
+     * @return bool True on success, false on failure.
      */
     public function setMulti( $items, $groups = 'default', $expiration = 0, $server_key = '', $by_key = false ) {
         // Build final keys and replace $items keys with the new keys
+        // Build final keys and replace $items keys with the new keys.
         $derived_keys  = $this->buildKeys( array_keys( $items ), $groups );
         $expiration    = $this->sanitize_expiration( $expiration );
         $derived_items = array_combine( $derived_keys, $items );
         // Do not add to memcached if in no_mc_groups
+        // Do not add to memcached if in no_mc_groups.
         foreach ( $derived_items as $derived_key => $value ) {
             // Get the individual item's group
+            // Get the individual item's group.
             $key_pieces = explode( ':', $derived_key );
             // If group is a non-Memcached group, save to runtime cache, not Memcached
+            // If group is a non-Memcached group, save to runtime cache, not Memcached.
             if ( in_array( $key_pieces[1], $this->no_mc_groups, true ) ) {
                 $this->add_to_internal_cache( $derived_key, $value );
 …
+        }
         // Save to memcached
+        // Save to memcached.
         if ( $by_key ) {
             $result = $this->m->setMultiByKey( $server_key, $derived_items, $expiration );
 …
+        }
         // Store in runtime cache if add was successful
+        // Store in runtime cache if add was successful.
         if ( Memcached::RES_SUCCESS === $this->getResultCode() ) {
             $this->cache = array_merge( $this->cache, $derived_items );
 …
     /**
      * Set multiple values to cache at once on specified server.
+     * Sets multiple values to cache at once on specified server.
+     *
      * By sending an array of $items to this function, all values are saved at once to
 …
      * final key for the object.
+     *
      * @link    http://www.php.net/manual/en/memcached.setmultibykey.php
+     *
      * @param   string          $server_key     The key identifying the server to store the value on.
      * @param   array           $items          An array of key/value pairs to store on the server.
      * @param   string|array    $groups         Group(s) to merge with key(s) in $items.
      * @param   int             $expiration     The expiration time, defaults to 0.
      * @return  bool                            Returns TRUE on success or FALSE on failure.
+     * @link https://www.php.net/manual/en/memcached.setmultibykey.php
+     *
+     * @param string       $server_key  The key identifying the server to store the value on.
+     * @param array        $items       An array of key/value pairs to store on the server.
+     * @param string|array $groups      Group(s) to merge with key(s) in $items.
+     * @param int          $expiration  The expiration time, defaults to 0.
+     * @return bool True on success, false on failure.
      */
     public function setMultiByKey( $server_key, $items, $groups = 'default', $expiration = 0 ) {
 …
     /**
      * Set a Memcached option.
+     *
      * @link    http://www.php.net/manual/en/memcached.setoption.php
+     *
      * @param   int         $option     Option name.
      * @param   mixed       $value      Option value.
      * @return  bool                Returns TRUE on success or FALSE on failure.
+     * Sets a Memcached option.
+     *
+     * @link https://www.php.net/manual/en/memcached.setoption.php
+     *
+     * @param int   $option Option name.
+     * @param mixed $value  Option value.
+     * @return bool True on success, false on failure.
      */
     public function setOption( $option, $value ) {
 …
      * Builds a key for the cached object using the blog_id, key, and group values.
+     *
+     * @author  Ryan Boren   This function is inspired by the original WP Memcached Object cache.
+     * @link    http://wordpress.org/extend/plugins/memcached/
+     *
+     * @param   string      $key        The key under which to store the value.
+     * @param   string      $group      The group value appended to the $key.
+     * @return  string
+     * This function is inspired by the original WP Memcached Object cache.
+     *
+     * @author Ryan Boren
+     * @link http://wordpress.org/extend/plugins/memcached/
+     *
+     * @param string $key   The key under which to store the value.
+     * @param string $group The group value appended to the $key.
+     * @return string
      */
     public function buildKey( $key, $group = 'default' ) {
 …
      * that call memcached with an array of keys.
+     *
      * @param   string|array    $keys       Key(s) to merge with group(s).
      * @param   string|array    $groups     Group(s) to merge with key(s).
      * @return  array                       Array that combines keys and groups into a single set of memcached keys.
+     * @param string|array $keys   Key(s) to merge with group(s).
+     * @param string|array $groups Group(s) to merge with key(s).
+     * @return array Array that combines keys and groups into a single set of memcached keys.
      */
     public function buildKeys( $keys, $groups = 'default' ) {
         $derived_keys = array();
         // If strings sent, convert to arrays for proper handling
+        // If strings sent, convert to arrays for proper handling.
         if ( ! is_array( $groups ) ) {
             $groups = (array) $groups;
 …
+        }
         // If we have equal numbers of keys and groups, merge $keys[n] and $group[n]
+        // If we have equal numbers of keys and groups, merge $keys[n] and $group[n].
         if ( count( $keys ) === count( $groups ) ) {
             for ( $i = 0; $i < count( $keys ); $i++ ) {
 …
+            }
+            // If more keys are received than groups, merge $keys[n] and $group[n] until no more group are left; remaining groups are 'default'
+            // If more keys are received than groups, merge $keys[n] and $group[n]
+            // until no more groups are left; remaining groups are 'default'.
         } elseif ( count( $keys ) > count( $groups ) ) {
             for ( $i = 0; $i < count( $keys ); $i++ ) {
 …
     /**
      * Ensure that a proper expiration time is set.
+     *
      * Memcached treats any value over 30 days as a timestamp. If a developer sets the expiration for greater than 30
      * days or less than the current timestamp, the timestamp is in the past and the value isn't cached. This function
      * detects values in that range and corrects them.
+     *
      * @param  string|int    $expiration    The dirty expiration time.
      * @return string|int                   The sanitized expiration time.
+     * Ensures that a proper expiration time is set.
+     *
+     * Memcached treats any value over 30 days as a timestamp. If a developer sets the expiration
+     * for greater than 30 days or less than the current timestamp, the timestamp is in the past
+     * and the value isn't cached. This function detects values in that range and corrects them.
+     *
+     * @param string|int $expiration The dirty expiration time.
+     * @return string|int The sanitized expiration time.
      */
     public function sanitize_expiration( $expiration ) {
 …
      * will dictate the type of the combined value.
+     *
      * @param   mixed       $original   Original value that dictates the combined type.
      * @param   mixed       $pended     Value to combine with original value.
      * @param   string      $direction  Either 'pre' or 'app'.
      * @return  mixed                   Combined value casted to the type of the first value.
+     * @param mixed  $original  Original value that dictates the combined type.
+     * @param mixed  $pended    Value to combine with original value.
+     * @param string $direction Either 'pre' or 'app'.
+     * @return mixed Combined value casted to the type of the first value.
      */
     public function combine_values( $original, $pended, $direction ) {
         $type = gettype( $original );
         // Combine the values based on direction of the "pend"
+        // Combine the values based on direction of the "pend".
         if ( 'pre' === $direction ) {
             $combined = $pended . $original;
 …
+        }
         // Cast type of combined value
+        // Cast type of combined value.
         settype( $combined, $type );
 …
      * Simple wrapper for saving object to the internal cache.
+     *
      * @param   string      $derived_key    Key to save value under.
      * @param   mixed       $value          Object value.
+     * @param string $derived_key Key to save value under.
+     * @param mixed  $value       Object value.
      */
     public function add_to_internal_cache( $derived_key, $value ) {
 …
      * Determines if a no_mc_group exists in a group of groups.
+     *
      * @param   mixed   $groups     The groups to search.
      * @return  bool                True if a no_mc_group is present; false if a no_mc_group is not present.
+     * @param mixed $groups The groups to search.
+     * @return bool True if a no_mc_group is present; false if a no_mc_group is not present.
      */
     public function contains_no_mc_group( $groups ) {
 …
     /**
+     * Add global groups.
+     *
+     * @author  Ryan Boren   This function comes straight from the original WP Memcached Object cache
+     * @link    http://wordpress.org/extend/plugins/memcached/
+     *
+     * @param   array       $groups     Array of groups.
+     * @return  void
+     * Adds global groups.
+     *
+     * This function comes straight from the original WP Memcached Object cache.
+     *
+     * @author Ryan Boren
+     * @link http://wordpress.org/extend/plugins/memcached/
+     *
+     * @param array $groups Array of groups.
+     * @return void
      */
     public function add_global_groups( $groups ) {
 …
     /**
+     * Add non-persistent groups.
+     *
+     * @author  Ryan Boren   This function comes straight from the original WP Memcached Object cache
+     * @link    http://wordpress.org/extend/plugins/memcached/
+     *
+     * @param   array       $groups     Array of groups.
+     * @return  void
+     * Adds non-persistent groups.
+     *
+     * This function comes straight from the original WP Memcached Object cache.
+     *
+     * @author Ryan Boren
+     * @link http://wordpress.org/extend/plugins/memcached/
+     *
+     * @param array $groups Array of groups.
+     * @return void
      */
     public function add_non_persistent_groups( $groups ) {
 …
     /**
      * Get a value specifically from the internal, run-time cache, not memcached.
+     *
      * @param   int|string  $key        Key value.
      * @param   int|string  $group      Group that the value belongs to.
      * @return  bool|mixed              Value on success; false on failure.
+     * Gets a value specifically from the internal, run-time cache, not memcached.
+     *
+     * @param int|string $key   Key value.
+     * @param int|string $group Group that the value belongs to.
+     * @return bool|mixed Value on success, false on failure.
      */
     public function get_from_runtime_cache( $key, $group ) {
 …
     /**
      * Switch blog prefix, which changes the cache that is accessed.
+     *
      * @param  int     $blog_id    Blog to switch to.
+     * Switches blog prefix, which changes the cache that is accessed.
+     *
+     * @param int $blog_id Blog to switch to.
      * @return void
      */

Note: See TracChangeset for help on using the changeset viewer.

Trac UI Preferences

Make WordPress Core

Context Navigation

Changeset 47121

Legend:

trunk/tests/phpunit/includes/object-cache.php

Download in other formats: