From d707f8b5d94856ba13bd8e76acb1efb8de377f9c Mon Sep 17 00:00:00 2001
From: Aditya <k.aditya00@gmail.com>
Date: Thu, 30 Jul 2020 18:06:21 +0530
Subject: [PATCH] docs: mention H2DownloadHandler in settings.rst

---
 docs/topics/settings.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/topics/settings.rst b/docs/topics/settings.rst
index 5178f272f..670b44f3c 100644
--- a/docs/topics/settings.rst
+++ b/docs/topics/settings.rst
@@ -620,6 +620,13 @@ handler (without replacement), place this in your ``settings.py``::
         'ftp': None,
     }
 
+The default https handler uses HTTP/1.x, to use HTTP/2.0 update :setting:`DOWNLOAD_HANDLERS`
+as::
+
+    DOWNLOAD_HANDLERS = {
+        'https': 'scrapy.core.downloader.handlers.http2.H2DownloadHandler',
+    }
+
 .. setting:: DOWNLOAD_TIMEOUT
 
 DOWNLOAD_TIMEOUT
@@ -697,6 +704,14 @@ Optionally, this can be set per-request basis by using the
   If :setting:`RETRY_ENABLED` is ``True`` and this setting is set to ``True``,
   the ``ResponseFailed([_DataLoss])`` failure will be retried as usual.
 
+.. warning::
+
+    This is ignored when :class:`~scrapy.core.downloader.handlers.http2.H2DownloadHandler`
+    is set as ``https`` download handler in :setting:`DOWNLOAD_HANDLERS`. In
+    case of data loss error the connection may be corrupted affecting other streams,
+    hence all streams return with the ``ResponseFailed([InvalidBodyLengthError])``
+    failure.
+
 .. setting:: DUPEFILTER_CLASS
 
 DUPEFILTER_CLASS