diff --git a/docs/topics/selectors.rst b/docs/topics/selectors.rst
index 293628953..9f8143db1 100644
--- a/docs/topics/selectors.rst
+++ b/docs/topics/selectors.rst
@@ -628,8 +628,7 @@ Built-in Selectors reference
 
     .. note::
 
-        Note that ``re`` and ``re_first`` both escape HTML entities. If you want to
-        get raw unescaped content, use extract() or extract_first()
+        Note that ``re()`` and ``re_first()`` both decode HTML entities (except ``<`` and ``&``).
 
   .. method:: register_namespace(prefix, uri)