Bring cgi.escape docstring slightly more in line with the library ref

manual.  Closes #1243553.

1 files changed, 3 insertions, 1 deletions

diff --git a/Lib/cgi.py b/Lib/cgi.py
index 1a99868..eb96303 100755
--- a/Lib/cgi.py
+++ b/Lib/cgi.py
@@ -1041,7 +1041,9 @@ environment as well.  Here are some common variable names:
 # =========
 
 def escape(s, quote=None):
-    """Replace special characters '&', '<' and '>' by SGML entities."""
+    '''Replace special characters "&", "<" and ">" to HTML-safe sequences.
+    If the optional flag quote is true, the quotation mark character (")
+    is also translated.'''
     s = s.replace("&", "&amp;") # Must be done first!
     s = s.replace("<", "&lt;")
     s = s.replace(">", "&gt;")