Document huge_tree.

Author: wRAR

NEWS

@@ -10,7 +10,8 @@ History
 * Support for Python 2.7, 3.5 and 3.6 is removed
 * Support for Python 3.9-3.11 is added
 * Very large documents (with deep nesting or long tag content) can now be
-  parsed
+  parsed, and ``Selector`` now takes a new argument ``huge_tree`` to disable
+  this
 * Support for new features of cssselect 1.2.0 is added
 * The ``Selector.remove()`` and ``SelectorList.remove()`` methods are
   deprecated and replaced with the new ``Selector.drop()`` and

parsel/selector.py

@@ -269,6 +269,14 @@ class Selector:
 
     ``base_url`` allows setting a URL for the document. This is needed when looking up external entities with relative paths.
     See the documentation for :func:`lxml.etree.fromstring` for more information.
+
+    ``huge_tree`` controls the lxml/libxml2 feature that forbids parsing
+    certain large documents to protect from possible memory exhaustion. The
+    argument is ``True`` by default if the installed lxml version supports it,
+    which disables the protection to allow parsing such documents. Set it to
+    ``False`` if you want to enable the protection.
+    See `this lxml FAQ entry <https://lxml.de/FAQ.html#is-lxml-vulnerable-to-xml-bombs>`_
+    for more information.
     """
 
     __slots__ = [