Added protocol clarification

git-svn-id: http://code.sixapart.com/svn/memcached/trunk/server@484 b0b603af-a30f-0410-a34e-baf09ae79d0b

1 files changed, 12 insertions, 0 deletions

diff --git a/doc/protocol.txt b/doc/protocol.txt
index 6f61444..945e6b4 100644
--- a/doc/protocol.txt
+++ b/doc/protocol.txt
@@ -378,6 +378,18 @@ of what flush_all does is the following: it causes all items whose
 update time is earlier than the time at which flush_all was set to be
 executed to be ignored for retrieval purposes.
 
+The intent of flush_all with a delay, was that in a setting where you
+have a pool of memcached servers, and you need to flush all content,
+you have the option of not resetting all memcached servers at the
+same time (which could e.g. cause a spike in database load with all
+clients suddenly needing to recreate content that would otherwise
+have been found in the memcached daemon).
+
+The delay option allows you to have them reset in e.g. 10 second
+intervals (by passing 0 to the first, 10 to the second, 20 to the
+third, etc. etc.).
+
+
 "version" is a command with no arguments:
 
 version\r\n