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

miss-islington · StanFromIreland · picnixz · web-flow · commit 98d3f2bc6e2b · 2025-01-04T17:45:19.000Z
(cherry picked from commit f28d471) 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
@@ -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
