Skip to content

Commit 7e51943

Browse files
committed
intmath -> math.integer
1 parent 48caa4b commit 7e51943

File tree

1 file changed

+8
-9
lines changed

1 file changed

+8
-9
lines changed

peps/pep-0791.rst

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
PEP: 791
2-
Title: intmath --- module for integer-specific mathematics functions
2+
Title: math.integer --- submodule for integer-specific mathematics functions
33
Author: Sergey B Kirpichev <[email protected]>
44
Sponsor: Victor Stinner <[email protected]>
55
Discussions-To: https://discuss.python.org/t/92548
@@ -34,7 +34,7 @@ explicitly noted otherwise, all return values are floats." This is no longer
3434
true: *None* of the functions listed in the `Number-theoretic functions
3535
<https://docs.python.org/3.14/library/math.html#number-theoretic-functions>`_
3636
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
3838
"All return values are integers" would be accurate. In a similar way we can
3939
simplify the description of the accepted arguments for functions in both the
4040
new module and in :external+py3.14:mod:`math`.
@@ -129,8 +129,7 @@ Specification
129129
=============
130130

131131
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``:
134133

135134
* :external+py3.14:func:`~math.comb`
136135
* :external+py3.14:func:`~math.factorial`
@@ -207,18 +206,18 @@ is ultimately a different function: it is the floor of the square root. It
207206
would be confusing to give it the same name (under a different module).
208207

209208

210-
Open Issues
211-
===========
209+
Module name
210+
-----------
212211

213212
`Polling showed <https://discuss.python.org/t/92548/67>`_ ``intmath`` as most
214213
popular candidate with ``imath`` as a second winner.
215214

216215
Other proposed names include ``ntheory`` (like SymPy's submodule),
217216
``integermath``, ``zmath``, ``dmath`` and ``imaths``.
218217

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).
222221

223222

224223
Acknowledgements

0 commit comments

Comments
 (0)