Merge branch 'patch-1' of https://github.com/alecz20/urllib3 into alecz20-patch-1

1 files changed, 12 insertions, 0 deletions

diff --git a/docs/index.rst b/docs/index.rst
index 1188b5ad..c1882022 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -101,6 +101,18 @@ like buffering:
     >>> secondpart = b.read()
 
 
+The response can be treated as a file-like object.
+A file can be downloaded directly to a local file in a context without
+being saved in memory.
+
+.. doctest ::
+
+    >>> url = 'http://example.com/file'
+    >>> http = urllib3.PoolManager()
+    >>> with http.request('GET', url, preload_content=False) as r, open('filename', 'wb') as fp:
+    >>> ....    shutil.copyfileobj(r, fp)
+
+
 Upgrading & Versioning
 ----------------------