gh-106318: Add an example for str.capitalize()

Doc/library/stdtypes.rst

@@ -1617,7 +1617,7 @@ category.
 |                          +-------------------------------------------+---------------------------------------------------+
 |                          |  :meth:`str.casefold`                     |                                                   |
 |                          +-------------------------------------------+---------------------------------------------------+
-|                          |  :meth:`str.capitalize`                   |  :meth:`bytes.capitalize`                         |
+|                          |  :meth:`str.`                   |  :meth:`bytes.capitalize`                         |
 |                          +-------------------------------------------+---------------------------------------------------+
 |                          |  :meth:`str.title`                        |  :meth:`bytes.title`                              |
 |                          +-------------------------------------------+---------------------------------------------------+
@@ -1759,7 +1759,21 @@ expression support in the :mod:`re` module).
 .. method:: str.capitalize()
 
    Return a copy of the string with its first character capitalized and the
-   rest lowercased.
+   rest lowercased. For example::
+
+      >>> 'PYTHON IS AMAZING'.capitalize()
+      'Python is amazing'
+      >>> 'Njemačka starts With a non-ASCII digraph'.capitalize()
+      'Njemačka starts with a non-ascii digraph'
+      >>> ' DZ, Dz, dz'.title()
+      >>> 'DŽ, Dž, dž '.title()
+      >>> 'IJ, ij'.title()
+      >>> 'LJ, Lj, lj '.title()
+      >>> 'NJ, Nj, nj '.title()
+      >>> 'ᵺ '.title()
+
+
+   See also :meth:`title`.
 
    .. versionchanged:: 3.8
       The first character is now put into titlecase rather than uppercase.