0
@@ -1144,14 +1144,24 @@ public final class MemcachedClient extends SpyThread {
0
   /**
0
    * Delete the given key from the cache.
0
    *
0
+   * <p>
0
+   * The hold argument specifies the amount of time in seconds (or Unix time
0
+   * until which) the client wishes the server to refuse "add" and "replace"
0
+   * commands with this key. For this amount of item, the item is put into a
0
+   * delete queue, which means that it won't possible to retrieve it by the
0
+   * "get" command, but "add" and "replace" command with this key will also
0
+   * fail (the "set" command will succeed, however). After the time passes,
0
+   * the item is finally deleted from server memory.
0
+   * </p>
0
+   *
0
    * @param key the key to delete
0
-   * @param when when the deletion should take effect
0
+   * @param hold how long the key should be unavailable to add commands
0
    */
0
-  public Future<Boolean> delete(String key, int when) {
0
+  public Future<Boolean> delete(String key, int hold) {
0
     final CountDownLatch latch=new CountDownLatch(1);
0
     final OperationFuture<Boolean> rv=new OperationFuture<Boolean>(latch,
0
       operationTimeout);
0
-    DeleteOperation op=opFact.delete(key, when,
0
+    DeleteOperation op=opFact.delete(key, hold,
0
         new OperationCallback() {
0
           public void receivedStatus(OperationStatus s) {
0
             rv.set(s.isSuccess());
0
@@ -1165,7 +1175,7 @@ public final class MemcachedClient extends SpyThread {
0
   }
0
 
0
   /**
0
-   * Shortcut to delete that will immediately delete the item from the cache.
0
+   * Shortcut to delete that doesn't put a hold on the key.
0
    */
0
   public Future<Boolean> delete(String key) {
0
     return delete(key, 0);