diff -r f2d1dba10a0e Doc/library/xml.sax.utils.rst
--- a/Doc/library/xml.sax.utils.rst	Thu Jun 30 14:03:21 2016 +0300
+++ b/Doc/library/xml.sax.utils.rst	Sun Jul 03 22:16:18 2016 +0800
@@ -25,6 +25,11 @@
    replaced with its corresponding value.  The characters ``'&'``, ``'<'`` and
    ``'>'`` are always escaped, even if *entities* is provided.
 
+   .. note::
+
+      This function should only be used to escape characters that are
+      problematic to include directly. Do not use this function as a general
+      string translation function.
 
 .. function:: unescape(data, entities={})