Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-08 06:10:17 +00:00
Code Issues Projects Releases Packages Wiki Activity

gh-141004: Deprecate Py_MATH_El and Py_MATH_PIl macros (#141035)

Browse source 
Co-authored-by: Victor Stinner <vstinner@python.org>
This commit is contained in:
Sergey B Kirpichev 2025-11-10 18:36:01 +03:00 • committed by GitHub
parent 55ea132313
commit 88953d5deb
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 23 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/c-api/float.rst
View file

@ -78,6 +78,20 @@ Floating-Point Objects
Return the minimum normalized positive float *DBL_MIN* as C :c:expr:`double`. Return the minimum normalized positive float *DBL_MIN* as C :c:expr:`double`.
.. c:macro:: Py_MATH_El
High precision (long double) definition of :data:`~math.e` constant.
.. deprecated-removed:: 3.15 3.20
.. c:macro:: Py_MATH_PIl
High precision (long double) definition of :data:`~math.pi` constant.
.. deprecated-removed:: 3.15 3.20
.. c:macro:: Py_RETURN_NAN .. c:macro:: Py_RETURN_NAN
Return :data:`math.nan` from a function. Return :data:`math.nan` from a function.

2
Doc/deprecations/c-api-pending-removal-in-3.20.rst
View file

@ -5,3 +5,5 @@ Pending removal in Python 3.20
Use :c:func:`PyComplex_AsCComplex` and :c:func:`PyComplex_FromCComplex` Use :c:func:`PyComplex_AsCComplex` and :c:func:`PyComplex_FromCComplex`
to convert a Python complex number to/from the C :c:type:`Py_complex` to convert a Python complex number to/from the C :c:type:`Py_complex`
representation. representation.
* Macros :c:macro:`!Py_MATH_PIl` and :c:macro:`!Py_MATH_El`.

4
Doc/whatsnew/3.15.rst
View file

@ -1076,6 +1076,10 @@ Deprecated C APIs
since 3.15 and will be removed in 3.17. since 3.15 and will be removed in 3.17.
(Contributed by Nikita Sobolev in :gh:`136355`.) (Contributed by Nikita Sobolev in :gh:`136355`.)
* :c:macro:`!Py_MATH_El` and :c:macro:`!Py_MATH_PIl` are deprecated
since 3.15 and will be removed in 3.20.
(Contributed by Sergey B Kirpichev in :gh:`141004`.)
.. Add C API deprecations above alphabetically, not here at the end. .. Add C API deprecations above alphabetically, not here at the end.

2
Include/pymath.h
View file

@ -7,6 +7,7 @@
/* High precision definition of pi and e (Euler) /* High precision definition of pi and e (Euler)
* The values are taken from libc6's math.h. * The values are taken from libc6's math.h.
*/ */
// Deprecated since Python 3.15.
#ifndef Py_MATH_PIl #ifndef Py_MATH_PIl
#define Py_MATH_PIl 3.1415926535897932384626433832795029L #define Py_MATH_PIl 3.1415926535897932384626433832795029L
#endif #endif
@ -14,6 +15,7 @@
#define Py_MATH_PI 3.14159265358979323846 #define Py_MATH_PI 3.14159265358979323846
#endif #endif
// Deprecated since Python 3.15.
#ifndef Py_MATH_El #ifndef Py_MATH_El
#define Py_MATH_El 2.7182818284590452353602874713526625L #define Py_MATH_El 2.7182818284590452353602874713526625L
#endif #endif

1
Misc/NEWS.d/next/C_API/2025-11-05-05-45-49.gh-issue-141004.N9Ooh9.rst Normal file
View file

@ -0,0 +1 @@
:c:macro:`!Py_MATH_El` and :c:macro:`!Py_MATH_PIl` are deprecated.