@@ -38,7 +38,7 @@ subsection of the documentation return a float, but the
3838documentation doesn't say so. In the documentation for the proposed ``imath `` module the sentence "All
3939return values are integers." would be accurate. In a similar way we
4040can simplify the description of the accepted arguments for functions in both the
41- new module and the :external+py3.14:mod: `math `.
41+ new module and in :external+py3.14:mod: `math `.
4242Which content, as in beginning, will be again related to work with "just
4343numbers" --- that for most people with basic education means some model of real
4444numbers).
@@ -55,7 +55,7 @@ Currently the :external+py3.14:mod:`math` module code in the CPython is around
5555comparable with the :external+py3.14:mod: `cmath ` (1340LOC), which is *not * a
5656simple wrapper to the ``libm ``, as most functions in the
5757:external+py3.14:mod: `math ` module.
58- And this situation tends to be worse. When the module split `was first
58+ And this situation tends to get worse. When the module split `was first
5959proposed
6060<https://mail.python.org/archives/list/python-ideas@python.org/thread/YYJ5YJBJNCVXQWK5K3WSVNMPUSV56LOR/> `_,
6161there were only two integer-related functions:
@@ -73,9 +73,9 @@ Sure, we can be much more vague in the module preamble (i.e. roughly say
7373that "the :external+py3.14:mod: `math ` module contains some mathematical
7474functions") and we can accurately describe input/output for each function.
7575
76- But the major issue is that current module mix different, almost non-interlaced
76+ But the major issue is that the current module mixes different, almost non-interlaced
7777application domains. Adding more documentation will just highlight this and
78- make the issue worse for end users (more stuff to read/skip). And it will not
78+ make the issue worse for end users (more text to read/skip). And it will not
7979fix issue with discoverability (to know in which module to find a function, and
8080that it can be found at all, you need to look at all the functions in the
8181module), nor with tab-completion.
@@ -158,8 +158,8 @@ interval math or numerical integration.
158158Other proposed names include ``ntheory `` (like SymPy's submodule),
159159``integermath `` and ``imaths ``.
160160
161- As a variant, new module can be added as a submodule of the
162- :external+py3.14:mod: `math `. The main module itself will preserve "catch-all"
161+ As a variant, the new module can be added as a submodule of the
162+ :external+py3.14:mod: `math `. The main module itself will preserve a "catch-all"
163163role for mathematics in the stdlib.
164164
165165
0 commit comments