[3.12] gh-126719: Clarify math.fmod docs (GH-127741) (#128492)

(cherry picked from commit f28d471fbe99f9eaac05d60ed40da47b0b56fe86)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

diff --git a/Doc/library/math.rst b/Doc/library/math.rst
index fb8527128a25550622da27154c10a0adf0b33052..0648293bfa7b899976aa45f549063174fea4fdea 100644 (file)
--- a/Doc/library/math.rst
+++ b/Doc/library/math.rst
@@ -84,7 +84,8 @@ Number-theoretic and representation functions
 
 .. function:: fmod(x, y)
 
-   Return ``fmod(x, y)``, as defined by the platform C library. Note that the
+   Return the floating-point remainder of ``x / y``,
+   as defined by the platform C library function ``fmod(x, y)``. Note that the
    Python expression ``x % y`` may not return the same result.  The intent of the C
    standard is that ``fmod(x, y)`` be exactly (mathematically; to infinite
    precision) equal to ``x - n*y`` for some integer *n* such that the result has