From: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
Date: Thu, 30 Jun 2022 15:18:30 +0000 (+0100)
Subject: [3.11] gh-89038: [doc] update dis.findlinestarts documentation for changes related... 
X-Git-Tag: v3.11.0b4~55
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=ecc8e77cc178707495dad7539348756fbe941bc5;p=thirdparty%2FPython%2Fcpython.git

[3.11] gh-89038: [doc] update dis.findlinestarts documentation for changes related to PEP-626 (GH-94247) (GH-94450)

(cherry picked from commit d68f2d27bbf85f3573a08fc7554889e1733a30f0)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
---

diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 505aa8188560..6f882b6d712a 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -268,15 +268,17 @@ operation is being performed, so the intermediate analysis object isn't useful:
 
 .. function:: findlinestarts(code)
 
-   This generator function uses the ``co_firstlineno`` and ``co_lnotab``
-   attributes of the code object *code* to find the offsets which are starts of
+   This generator function uses the ``co_lines`` method
+   of the code object *code* to find the offsets which are starts of
    lines in the source code.  They are generated as ``(offset, lineno)`` pairs.
-   See :source:`Objects/lnotab_notes.txt` for the ``co_lnotab`` format and
-   how to decode it.
 
    .. versionchanged:: 3.6
       Line numbers can be decreasing. Before, they were always increasing.
 
+   .. versionchanged:: 3.10
+      The :pep:`626` ``co_lines`` method is used instead of the ``co_firstlineno``
+      and ``co_lnotab`` attributes of the code object.
+
 
 .. function:: findlabels(code)