#15438: add a note to math.pow() that suggests using **/pow() for integers. Patch by Mark Dickinson.
diff --git a/Doc/library/math.rst b/Doc/library/math.rst
index c082980..b014fc4 100644
--- a/Doc/library/math.rst
+++ b/Doc/library/math.rst
@@ -202,6 +202,10 @@
``x`` is negative, and ``y`` is not an integer then ``pow(x, y)``
is undefined, and raises :exc:`ValueError`.
+ Unlike the built-in ``**`` operator, :func:`math.pow` converts both
+ its arguments to type :class:`float`. Use ``**`` or the built-in
+ :func:`pow` function for computing exact integer powers.
+
.. function:: sqrt(x)