https://github.com/python/cpython/commit/73d7393780b6d92909782148f50ec03f0db5892d commit: 73d7393780b6d92909782148f50ec03f0db5892d branch: 3.12 author: Adam Turner <[email protected]> committer: AA-Turner <[email protected]> date: 2024-10-06T22:42:11Z summary:
[3.12] Doc: Simplify the definition of 'soft deprecated' (GH-124988) (#125030) (cherry picked from commit feca4cf64e9742b9c002d5533ced47e68b34a880) Co-authored-by: Andrés Delfino <[email protected]> Co-authored-by: Sergey B Kirpichev <[email protected]> Co-authored-by: Carol Willing <[email protected]> files: M Doc/glossary.rst diff --git a/Doc/glossary.rst b/Doc/glossary.rst index f78701559307939..b233967adc9e6a5 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -1134,6 +1134,17 @@ Glossary when several are given, such as in ``variable_name[1:3:5]``. The bracket (subscript) notation uses :class:`slice` objects internally. + soft deprecated + A soft deprecated API should not be used in new code, + but it is safe for already existing code to use it. + The API remains documented and tested, but will not be enhanced further. + + Soft deprecation, unlike normal deprecation, does not plan on removing the API + and will not emit warnings. + + See `PEP 387: Soft Deprecation + <https://peps.python.org/pep-0387/#soft-deprecation>`_. + special method .. index:: pair: special; method _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3/lists/python-checkins.python.org/ Member address: [email protected]
