|
1 | 1 | PEP: 791 |
2 | | -Title: intmath --- module for integer-specific mathematics functions |
| 2 | +Title: math.integer --- submodule for integer-specific mathematics functions |
3 | 3 | Author: Sergey B Kirpichev < [email protected]> |
4 | 4 | Sponsor: Victor Stinner < [email protected]> |
5 | 5 | Discussions-To: https://discuss.python.org/t/92548 |
@@ -34,7 +34,7 @@ explicitly noted otherwise, all return values are floats." This is no longer |
34 | 34 | true: *None* of the functions listed in the `Number-theoretic functions |
35 | 35 | <https://docs.python.org/3.14/library/math.html#number-theoretic-functions>`_ |
36 | 36 | subsection of the documentation return a float, but the documentation doesn't |
37 | | -say so. In the documentation for the proposed ``intmath`` module the sentence |
| 37 | +say so. In the documentation for the proposed ``math.integer`` submodule the sentence |
38 | 38 | "All return values are integers" would be accurate. In a similar way we can |
39 | 39 | simplify the description of the accepted arguments for functions in both the |
40 | 40 | new module and in :external+py3.14:mod:`math`. |
@@ -129,8 +129,7 @@ Specification |
129 | 129 | ============= |
130 | 130 |
|
131 | 131 | The PEP proposes moving the following integer-related functions to a new |
132 | | -module, called ``intmath`` (see `Open Issues`_ for alternatives for |
133 | | -it's name): |
| 132 | +submodule, called ``math.integer``: |
134 | 133 |
|
135 | 134 | * :external+py3.14:func:`~math.comb` |
136 | 135 | * :external+py3.14:func:`~math.factorial` |
@@ -207,18 +206,18 @@ is ultimately a different function: it is the floor of the square root. It |
207 | 206 | would be confusing to give it the same name (under a different module). |
208 | 207 |
|
209 | 208 |
|
210 | | -Open Issues |
211 | | -=========== |
| 209 | +Module name |
| 210 | +----------- |
212 | 211 |
|
213 | 212 | `Polling showed <https://discuss.python.org/t/92548/67>`_ ``intmath`` as most |
214 | 213 | popular candidate with ``imath`` as a second winner. |
215 | 214 |
|
216 | 215 | Other proposed names include ``ntheory`` (like SymPy's submodule), |
217 | 216 | ``integermath``, ``zmath``, ``dmath`` and ``imaths``. |
218 | 217 |
|
219 | | -As a variant, the new module can be added as a submodule of the |
220 | | -:external+py3.14:mod:`math`: ``integer`` (most preferred), ``discrete`` or |
221 | | -``ntheory`` (author preference). |
| 218 | +But the SC prefers a submodule rather than a new top-level module. Most |
| 219 | +popular variants of the :external+py3.14:mod:`math`'s submodule are: |
| 220 | +``integer``, ``discrete`` or ``ntheory`` (author preference). |
222 | 221 |
|
223 | 222 |
|
224 | 223 | Acknowledgements |
|
0 commit comments