From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 14 Oct 2025 14:27:37 +0000 (+0200)
Subject: [3.14] gh-106318: Add examples for str.istitle()  (GH-140046) (#140113)
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=6a467d3edaf588971f48fd2cfaefd055ce72e8f6;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-106318: Add examples for str.istitle()  (GH-140046) (#140113)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index aea73724ef56..a9658820f66e 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2157,6 +2157,19 @@ expression support in the :mod:`re` module).
    character, for example uppercase characters may only follow uncased characters
    and lowercase characters only cased ones.  Return ``False`` otherwise.
 
+   For example:
+
+   .. doctest::
+
+      >>> 'Spam, Spam, Spam'.istitle()
+      True
+      >>> 'spam, spam, spam'.istitle()
+      False
+      >>> 'SPAM, SPAM, SPAM'.istitle()
+      False
+
+   See also :meth:`title`.
+
 
 .. method:: str.isupper()
 
@@ -2534,6 +2547,8 @@ expression support in the :mod:`re` module).
         >>> titlecase("they're bill's friends.")
         "They're Bill's Friends."
 
+   See also :meth:`istitle`.
+
 
 .. method:: str.translate(table, /)