From c7dfb5eb88e2cb9c489725e5ad81bc1c69f7b3fc Mon Sep 17 00:00:00 2001
From: gustavodeandrade <gu_andrade1@yahoo.com.br>
Date: Fri, 21 Oct 2016 00:08:08 -0200
Subject: [PATCH] Fix issue 1704

---
 docs/topics/selectors.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/topics/selectors.rst b/docs/topics/selectors.rst
index 39ec9b73c..293628953 100644
--- a/docs/topics/selectors.rst
+++ b/docs/topics/selectors.rst
@@ -626,6 +626,11 @@ Built-in Selectors reference
      ``regex`` can be either a compiled regular expression or a string which
      will be compiled to a regular expression using ``re.compile(regex)``
 
+    .. note::
+
+        Note that ``re`` and ``re_first`` both escape HTML entities. If you want to
+        get raw unescaped content, use extract() or extract_first()
+
   .. method:: register_namespace(prefix, uri)
 
      Register the given namespace to be used in this :class:`Selector`.