Skip to content

Commit 73d7393

Browse files
AA-Turnerandresdelfinoskirpichevwillingc
authored
[3.12] Doc: Simplify the definition of 'soft deprecated' (GH-124988) (#125030)
(cherry picked from commit feca4cf) Co-authored-by: Andrés Delfino <[email protected]> Co-authored-by: Sergey B Kirpichev <[email protected]> Co-authored-by: Carol Willing <[email protected]>
1 parent db4b382 commit 73d7393

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

Doc/glossary.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1134,6 +1134,17 @@ Glossary
11341134
when several are given, such as in ``variable_name[1:3:5]``. The bracket
11351135
(subscript) notation uses :class:`slice` objects internally.
11361136

1137+
soft deprecated
1138+
A soft deprecated API should not be used in new code,
1139+
but it is safe for already existing code to use it.
1140+
The API remains documented and tested, but will not be enhanced further.
1141+
1142+
Soft deprecation, unlike normal deprecation, does not plan on removing the API
1143+
and will not emit warnings.
1144+
1145+
See `PEP 387: Soft Deprecation
1146+
<https://peps.python.org/pep-0387/#soft-deprecation>`_.
1147+
11371148
special method
11381149
.. index:: pair: special; method
11391150

0 commit comments

Comments
 (0)