Clarify distinction between string.Template and string.templatelib.Te…

…mplate
python · hugovk · Jul 22, 2025 · Jun 6, 2025 · Jun 8, 2025 · Jun 8, 2025
commit 5a8cf1b1f1534050631219530d07c31b46d5190e
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
@@ -2673,9 +2673,9 @@ For example:
    lead to a number of common errors (such as failing to display tuples and
    dictionaries correctly).  Using the newer :ref:`formatted string literals
    <f-strings>`, the :meth:`str.format` interface, or :ref:`template strings
-   dictionaries correctly).  Using the newer :ref:`formatted string literals
-   <f-strings>`, the :meth:`str.format` interface, or :ref:`template strings
+   dictionaries correctly).
+
+   Using the newer :ref:`formatted string literals <f-strings>`
+   or the :meth:`str.format` interface
-   dictionaries correctly).  Using the newer :ref:`formatted string literals
-   <f-strings>`, the :meth:`str.format` interface, or :ref:`template strings
+   dictionaries correctly).
+
+   Using the newer :ref:`formatted string literals <f-strings>`
+   or the :meth:`str.format` interface
-   <template-strings>` may help avoid these errors.  Each of these
-   alternatives provides their own trade-offs and benefits of simplicity,
-   flexibility, and/or extensibility.
+   ($-strings) <template-strings-pep292>` may help avoid these errors.
+   Each of these alternatives provides their own trade-offs and benefits of
+   simplicity, flexibility, and/or extensibility.
-   ($-strings) <template-strings-pep292>` may help avoid these errors.
-   Each of these alternatives provides their own trade-offs and benefits of
-   simplicity, flexibility, and/or extensibility.
+   may help avoid these errors.
+   Each of these alternatives provides their own trade-offs and benefits of
+   simplicity, flexibility, and/or extensibility.
+
-   ($-strings) <template-strings-pep292>` may help avoid these errors.
-   Each of these alternatives provides their own trade-offs and benefits of
-   simplicity, flexibility, and/or extensibility.
+   may help avoid these errors.
+   Each of these alternatives provides their own trade-offs and benefits of
+   simplicity, flexibility, and/or extensibility.
+
 
 String objects have one unique built-in operation: the ``%`` operator (modulo).
 This is also known as the string *formatting* or *interpolation* operator.

diff --git a/Doc/library/string.rst b/Doc/library/string.rst
@@ -790,10 +790,20 @@ Nesting arguments and more complex examples::
 
 
 
-.. _template-strings:
+.. _template-strings-pep292:
 
-Template strings
-----------------
+Template strings ($-strings)
+----------------------------
+
+.. note::
+
+   The :class:`~string.Template` class described here was introduced in Python
+   2.4.  It is entirely unrelated to, and should *not* be confused with, the
+   new :ref:`Template Strings <template-strings>` feature and
+   :ref:`t-string literal syntax <t-strings>` introduced in Python 3.14 and
+   originally described in :pep:`750`. Python's t-string literals evaluate to
+   instances of a different :class:`~string.templatelib.Template` class, which
+   is found in the :mod:`string.templatelib` module.
 
 Template strings provide simpler string substitutions as described in
 :pep:`292`.  A primary use case for template strings is for

@@ -14,6 +14,17 @@
    :ref:`Format strings <f-strings>`
 
 
-
+   * :pep:`750`
+
-
+   * :pep:`750`
+
+
+.. _template-strings:
+
+Template strings
+----------------
+
+Documentation forthcoming for PEP 750 template strings, also known as t-strings.
+
+.. versionadded:: 3.14
+
+
 .. _templatelib-template:
 
 Template