@@ -38,7 +38,7 @@ subsection of the documentation return a float, but the
38
38
documentation doesn't say so. In the documentation for the proposed ``imath `` module the sentence "All
39
39
return values are integers." would be accurate. In a similar way we
40
40
can 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 `.
42
42
Which content, as in beginning, will be again related to work with "just
43
43
numbers" --- that for most people with basic education means some model of real
44
44
numbers).
@@ -55,7 +55,7 @@ Currently the :external+py3.14:mod:`math` module code in the CPython is around
55
55
comparable with the :external+py3.14:mod: `cmath ` (1340LOC), which is *not * a
56
56
simple wrapper to the ``libm ``, as most functions in the
57
57
: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
59
59
proposed
60
60
<https://mail.python.org/archives/list/python-ideas@python.org/thread/YYJ5YJBJNCVXQWK5K3WSVNMPUSV56LOR/> `_,
61
61
there 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
73
73
that "the :external+py3.14:mod: `math ` module contains some mathematical
74
74
functions") and we can accurately describe input/output for each function.
75
75
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
77
77
application 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
79
79
fix issue with discoverability (to know in which module to find a function, and
80
80
that it can be found at all, you need to look at all the functions in the
81
81
module), nor with tab-completion.
@@ -158,8 +158,8 @@ interval math or numerical integration.
158
158
Other proposed names include ``ntheory `` (like SymPy's submodule),
159
159
``integermath `` and ``imaths ``.
160
160
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"
163
163
role for mathematics in the stdlib.
164
164
165
165
0 commit comments