Skip to content

Commit d7b3aec

Browse files
committed
address review: add "How to Teach This"
1 parent 5054afb commit d7b3aec

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

peps/pep-0791.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,21 @@ As aliases in :external+py3.14:mod:`math` will be kept for an indefinite time
7878
(their use would be discouraged), there are no anticipated code breaks.
7979

8080

81+
How to Teach This
82+
=================
83+
84+
The new module will be a place to functions, that 1) accept
85+
:external+py3.14:class:`int`-like arguments and return also integers, 2) are
86+
also in the field of arbitrary-precision integer arithmetic, i.e. have no
87+
dependence on the platform floating-point format or behaviour and/or on the
88+
platorm math library (``libm``).
89+
90+
For users it would be natural first to look on the
91+
:external+py3.14:class:`int`'s methods, which cover most basic use-cases (e.g.
92+
:external+py3.14:meth:`int.bit_length` method), than to some dedicated place in
93+
the stdlib.
94+
95+
8196
Reference Implementation
8297
========================
8398

0 commit comments

Comments
 (0)