From 2b16ebdc11fcce44d23b31e5360837d629b48bf6 Mon Sep 17 00:00:00 2001
From: Pablo Hoffman <pablo@pablohoffman.com>
Date: Wed, 29 Feb 2012 07:19:01 -0200
Subject: [PATCH] added minor clarification on cookiejar request meta key usage

---
 docs/topics/downloader-middleware.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/topics/downloader-middleware.rst b/docs/topics/downloader-middleware.rst
index d295142a7..1dd00e641 100644
--- a/docs/topics/downloader-middleware.rst
+++ b/docs/topics/downloader-middleware.rst
@@ -195,6 +195,15 @@ For example::
         yield Request("http://www.example.com", meta={'cookiejar': i},
             callback=self.parse_page)
 
+Keep in mind that the :reqmeta:`cookiejar` meta key is not "sticky". You need to keep
+passing it along on subsequent requests. For example::
+
+    def parse_page(self, response):
+        # do some processing
+        return Request("http://www.example.com/otherpage",
+            meta={'cookiejar': response.meta['cookiejar']},
+            callback=self.parse_other_page)
+
 .. setting:: COOKIES_ENABLED
 
 COOKIES_ENABLED