diff --git a/Doc/library/html.rst b/Doc/library/html.rst
index 9aa39ba9a42b0f..65c49a4107a048 100644
--- a/Doc/library/html.rst
+++ b/Doc/library/html.rst
@@ -14,9 +14,12 @@ This module defines utilities to manipulate HTML.
Convert the characters ``&``, ``<`` and ``>`` in string *s* to HTML-safe
sequences. Use this if you need to display text that might contain such
- characters in HTML. If the optional flag *quote* is true, the characters
- (``"``) and (``'``) are also translated; this helps for inclusion in an HTML
- attribute value delimited by quotes, as in ````.
+ characters in HTML. If the optional flag *quote* is true (the default), the
+ characters (``"``) and (``'``) are also translated; this helps for inclusion
+ in an HTML attribute value delimited by quotes, as in ````.
+ If *quote* is set to false, the characters (``"``) and (``'``) are not
+ translated.
+
.. versionadded:: 3.2