PyCode_Addr2Line point to out of date PEP 626

Documentation

The docs for PyCode_Addr2Line say:

For efficiently iterating over the line numbers in a code object, use the API described in PEP 626.

That section of the PEP describes PyCodeAddressRange, PyLineTable_InitAddressRange, PyLineTable_NextAddressRange, and PyLineTable_PreviousAddressRange . Those function have been renamed with a _ prefix. Some are not exported symbols (even in private headers). That's fine for the PEP, we treat them as historical documents, but the docs should be up to date.

Ideally we:

1. Document that PyCode_Addr2Line may be O(N) in the size of the code. This is important and not obvious!
2. Describe how to iterate efficiently in the docs.
3. In a future version of Python, expose the functions as public, documented, unstable C APIs. (I think PyUnstable makes sense for these)

Linked PRs

• gh-156736

Bắt đầu với tài liệu PyCode_Addr2Line và so sánh phần tham chiếu đến PEP 626 của tài liệu này với các hàm về phạm vi địa chỉ đã được đổi tên được mô tả trong issue. Trước tiên, hãy kiểm tra PR được liên kết gh-156736; công việc tài liệu hoàn tất khi ghi chú về độ phức tạp và hướng dẫn lặp hiệu quả là chính xác, đồng thời mọi khả năng cung cấp API trong tương lai được tách biệt rõ ràng.