From: Eric Wieser <wieser.eric@gmail.com>
Date: Thu, 7 Apr 2022 01:31:39 +0000 (+0100)
Subject: doc: Link to `string.capwords` from `str.title` (GH-20913)
X-Git-Tag: v3.11.0b1~430
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b786d9ec52a2c2b0b6627be7fd4a3948c61fbdea;p=thirdparty%2FPython%2Fcpython.git

doc: Link to `string.capwords` from `str.title` (GH-20913)

Since `title()` mentions its own short-comings, it should also mention the library function which does not possess them.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index d6d90cd462c2..f25e8303f94a 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2189,7 +2189,11 @@ expression support in the :mod:`re` module).
         >>> "they're bill's friends from the UK".title()
         "They'Re Bill'S Friends From The Uk"
 
-   A workaround for apostrophes can be constructed using regular expressions::
+   The :func:`string.capwords` function does not have this problem, as it
+   splits words on spaces only.
+
+   Alternatively, a workaround for apostrophes can be constructed using regular
+   expressions::
 
         >>> import re
         >>> def titlecase(s):