From a1d087ca2f51ee642b19d868552dfe050bd01375 Mon Sep 17 00:00:00 2001
From: Damien <81557462+Damien-Chen@users.noreply.github.com>
Date: Sun, 2 Mar 2025 17:29:12 +0800
Subject: [PATCH 1/2] gh-128481: Improve documentation for
 `traceback.FrameSummary` (GH-128484)

Complete the `traceback.FrameSummary` signature and add missing
documentation for the `colno` and `end_{col,line}no` attributes.
(cherry picked from commit 051f0e5683fec3840fa7fc99723741dd2d701eae)

Co-authored-by: Damien <81557462+Damien-Chen@users.noreply.github.com>
---
 Doc/library/traceback.rst | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/Doc/library/traceback.rst b/Doc/library/traceback.rst
index d7e9dadf9ca2e2..b966d7d65c7218 100644
--- a/Doc/library/traceback.rst
+++ b/Doc/library/traceback.rst
@@ -478,7 +478,9 @@ the module-level functions described above.
 A :class:`!FrameSummary` object represents a single :ref:`frame <frame-objects>`
 in a :ref:`traceback <traceback-objects>`.
 
-.. class:: FrameSummary(filename, lineno, name, lookup_line=True, locals=None, line=None)
+.. class:: FrameSummary(filename, lineno, name, *,\
+                        lookup_line=True, locals=None,\
+                        line=None, end_lineno=None, colno=None, end_colno=None)
 
    Represents a single :ref:`frame <frame-objects>` in the
    :ref:`traceback <traceback-objects>` or stack that is being formatted
@@ -514,6 +516,22 @@ in a :ref:`traceback <traceback-objects>`.
       trailing whitespace stripped.
       If the source is not available, it is ``None``.
 
+   .. attribute:: FrameSummary.end_lineno
+
+      The last line number of the source code for this frame.
+      By default, it is set to ``lineno`` and indexation starts from 1.
+
+   .. attribute:: FrameSummary.colno
+
+      The column number of the source code for this frame.
+      By default, it is ``None`` and indexation starts from 0.
+
+   .. attribute:: FrameSummary.end_colno
+
+      The last column number of the source code for this frame.
+      By default, it is ``None`` and indexation starts from 0.
+
+
 .. _traceback-example:
 
 Examples of Using the Module-Level Functions

From 44b9ee01f179fe3f284b9eb4139ee05da62be7f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?B=C3=A9n=C3=A9dikt=20Tran?=
 <10796600+picnixz@users.noreply.github.com>
Date: Sun, 2 Mar 2025 10:44:02 +0100
Subject: [PATCH 2/2] Update Doc/library/traceback.rst

---
 Doc/library/traceback.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Doc/library/traceback.rst b/Doc/library/traceback.rst
index b966d7d65c7218..89b7d024f68784 100644
--- a/Doc/library/traceback.rst
+++ b/Doc/library/traceback.rst
@@ -519,7 +519,7 @@ in a :ref:`traceback <traceback-objects>`.
    .. attribute:: FrameSummary.end_lineno
 
       The last line number of the source code for this frame.
-      By default, it is set to ``lineno`` and indexation starts from 1.
+      By default, it is set to ``None`` and indexation starts from 1.
 
    .. attribute:: FrameSummary.colno