Add documentation for retry=True

diff --git a/README b/README
index bc2eec0a3225db05d3142369368fb1875986d06c..f871629cf60f9c9325aa1cca58d2b973e8091c29 100644 (file)
--- a/README
+++ b/README
@@ -134,13 +134,20 @@ params = {"media[]": base64_image, "status": "PTT", "_base64": True}
 t.statuses.update_with_media(**params)
 ```
 
-
 Searching Twitter:
 ```python
 # Search for the latest tweets about #pycon
 t.search.tweets(q="#pycon")
 ```
 
+
+Retrying after reaching the API rate limit
+------------------------------------------
+
+Simply create the `Twitter` instance with the argument `retry=True`, then the
+HTTP error codes 429, 502, 503 and 504 will cause a retry of the last request.
+
+
 Using the data returned
 -----------------------