Document cache_set and cache_update
* Document cache_set and cache_update
It wasn't exactly clear before how these differ.
@@ -70,7 +70,7 @@ Cache functions
.. function:: cache_set(key, value[, expire, cache_name])
- Set a value in the cache.
+ Set a value in the cache. If the key is already set but not expired, it doesn't set anything.
:param key: The cache key to write.
:param value: The cache value to write.
@@ -78,7 +78,14 @@ Cache functions
:param cache_name: The name of the cache in multiple cache mode (can be in the form name@address). Optional.
-.. function:: cache_update(key, value[, expire, cache_server])
+.. function:: cache_update(key, value[, expire, cache_name])
+
+ Update a value in the cache. This always sets the key, whether it was already set before or not and whether it has expired or not.
+
+ :param key: The cache key to write.
+ :param value: The cache value to write.
+ :param expire: Expiry time of the value, in seconds.
+ :param cache_name: The name of the cache in multiple cache mode (can be in the form name@address). Optional.
.. function:: cache_del(key[, cache_name])
