From 254925bed65bee2210a85d4888b25f23aa878a3d Mon Sep 17 00:00:00 2001 From: Petr Viktorin Date: Tue, 9 May 2023 11:44:32 +0200 Subject: [PATCH] PEP 689: Tweak a policy, add canonical-doc and Mark as Final (GH-3123) --- conf.py | 1 + pep-0689.rst | 9 ++++++--- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/conf.py b/conf.py index 9fa30be5d..a181e30b2 100644 --- a/conf.py +++ b/conf.py @@ -49,6 +49,7 @@ exclude_patterns = [ intersphinx_mapping = { 'python': ('https://docs.python.org/3/', None), 'packaging': ('https://packaging.python.org/en/latest/', None), + 'devguide': ('https://devguide.python.org/', None), 'py3.11': ('https://docs.python.org/3.11/', None), 'py3.12': ('https://docs.python.org/3.12/', None), } diff --git a/pep-0689.rst b/pep-0689.rst index 7775f07de..7928bb2ae 100644 --- a/pep-0689.rst +++ b/pep-0689.rst @@ -2,7 +2,7 @@ PEP: 689 Title: Unstable C API tier Author: Petr Viktorin Discussions-To: https://discuss.python.org/t/pep-689-unstable-c-api-tier/20452 -Status: Accepted +Status: Final Type: Standards Track Content-Type: text/x-rst Requires: 523 @@ -13,6 +13,10 @@ Post-History: `27-Apr-2022 `__, Resolution: https://discuss.python.org/t/pep-689-unstable-c-api-tier/20452/13 +.. canonical-doc:: :ref:`devguide:c-api` + + User-facing documentation is at :ref:`py3.12:unstable-c-api`. + Abstract ======== @@ -152,8 +156,7 @@ Several rules for dealing with the unstable tier will be introduced: - To move an API from the unstable tier to the public tier, it should be exposed without the ``PyUnstable_*`` prefix. - The old name should remain available until the first incompatible change - is made or the API is removed. + The old name should remain available until the API is deprecated or removed. - Adding new unstable API *for existing features* is allowed even after Beta feature freeze, up until the first Release Candidate.