[3.12] gh-89412: Add missing attributes (added in 3.10) to traceback module docs...

(cherry picked from commit a4f72fa39a9d391c7b931ba1906d81da4ae01949)

Co-authored-by: Jakub Kuczys <me@jacken.men>

diff --git a/Doc/library/traceback.rst b/Doc/library/traceback.rst
index 58f47818fcecabaef8eee00235137bb9689b7571..36171a3b5a610d0d8e0d2256f83af11c2f9c78d4 100644 (file)
--- a/Doc/library/traceback.rst
+++ b/Doc/library/traceback.rst
@@ -279,6 +279,13 @@ capture data for later printing in a lightweight fashion.
 
       For syntax errors - the line number where the error occurred.
 
+   .. attribute:: end_lineno
+
+      For syntax errors - the end line number where the error occurred.
+      Can be ``None`` if not present.
+
+      .. versionadded:: 3.10
+
    .. attribute:: text
 
       For syntax errors - the text where the error occurred.
@@ -287,6 +294,13 @@ capture data for later printing in a lightweight fashion.
 
       For syntax errors - the offset into the text where the error occurred.
 
+   .. attribute:: end_offset
+
+      For syntax errors - the end offset into the text where the error occurred.
+      Can be ``None`` if not present.
+
+      .. versionadded:: 3.10
+
    .. attribute:: msg
 
       For syntax errors - the compiler error message.

diff --git a/Lib/traceback.py b/Lib/traceback.py
index 0ea77bfb94612e04790d6ff4280162a207c9d5d6..21e32040ee9872243dd2ea1f7cc2748f61e45528 100644 (file)
--- a/Lib/traceback.py
+++ b/Lib/traceback.py
@@ -674,8 +674,8 @@ class TracebackException:
       occurred.
     - :attr:`offset` For syntax errors - the offset into the text where the
       error occurred.
-    - :attr:`end_offset` For syntax errors - the offset into the text where the
-      error occurred. Can be `None` if not present.
+    - :attr:`end_offset` For syntax errors - the end offset into the text where
+      the error occurred. Can be `None` if not present.
     - :attr:`msg` For syntax errors - the compiler error message.
     """
 

diff --git a/Misc/NEWS.d/next/Documentation/2023-05-28-19-08-42.gh-issue-89412.j4cg7K.rst b/Misc/NEWS.d/next/Documentation/2023-05-28-19-08-42.gh-issue-89412.j4cg7K.rst
new file mode 100644 (file)
index 0000000..00937e5
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2023-05-28-19-08-42.gh-issue-89412.j4cg7K.rst
@@ -0,0 +1,2 @@
+Add missing documentation for the ``end_lineno`` and ``end_offset`` attributes
+of the :class:`traceback.TracebackException` class.