From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Wed, 17 Sep 2025 13:54:16 +0000 (+0200) Subject: [3.13] gh-139006: Doc: Clarify html.escape function description (GH-139016) (#139037) X-Git-Tag: v3.13.8~67 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c707d38e708d53f945fb1b4b345954396f2e0a88;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-139006: Doc: Clarify html.escape function description (GH-139016) (#139037) gh-139006: Doc: Clarify html.escape function description (GH-139016) (cherry picked from commit 81c975bcfc1ac0533f9489a37e501ad5d3bdb4eb) Doc: Clarify html.escape function description (GH-139006) Co-authored-by: PrinceNaroliya --- diff --git a/Doc/library/html.rst b/Doc/library/html.rst index 9aa39ba9a42b..65c49a4107a0 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