From 05312e63890526bfad0c5a557623b9aefba43401 Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Wed, 4 Jan 2012 09:33:23 +0530
Subject: [PATCH] ...

---
 src/calibre/utils/browser.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/calibre/utils/browser.py b/src/calibre/utils/browser.py
index 430ced9fdd..de21158ed7 100644
--- a/src/calibre/utils/browser.py
+++ b/src/calibre/utils/browser.py
@@ -11,7 +11,11 @@ from cookielib import CookieJar
 from mechanize import Browser as B
 
 class Browser(B):
-    'A cloneable mechanize browser'
+    '''
+    A cloneable mechanize browser. Useful for multithreading. The idea is that
+    each thread has a browser clone. Every clone uses the same thread safe
+    cookie jar. All clones share the same browser configuration.
+    '''
 
     def __init__(self):
         self._clone_actions = {}