expand Motivation

Author: skirpichev

peps/pep-0791.rst

@@ -38,7 +38,10 @@ subsection of the documentation return a float, but the
 documentation doesn't say so.  In the documentation for the proposed ``imath`` module the sentence "All
 return values are integers." would be accurate.  In a similar way we
 can simplify the description of the accepted arguments for functions in both the
-:external+py3.14:mod:`math` and the new module.
+new module and the :external+py3.14:mod:`math`.
+Which content, as in beginning, will be again related to work with "just
+numbers" --- that for most people with basic education means some model of real
+numbers).
 
 Apparently, the :external+py3.14:mod:`math` module can't serve as a catch-all place
 for mathematical functions since we also have the :external+py3.14:mod:`cmath` and
@@ -52,6 +55,14 @@ Currently the :external+py3.14:mod:`math` module code in the CPython is around
 comparable with the :external+py3.14:mod:`cmath` (1340LOC), which is *not* a
 simple wrapper to the ``libm``, as most functions in the
 :external+py3.14:mod:`math` module.
+And this situation tends to be worse.  When the module split `was first
+proposed
+<https://mail.python.org/archives/list/python-ideas@python.org/thread/YYJ5YJBJNCVXQWK5K3WSVNMPUSV56LOR/>`_,
+there were only two integer-related functions:
+:external+py3.14:func:`~math.factorial` and :external+py3.14:func:`~math.gcd`.
+Now there are six, :external+py3.14:func:`~math.factorial` doesn't accept
+:class:`float`'s anymore and :external+py3.14:func:`~math.gcd` changed it's
+signature.
 
 
 Rationale