API documentation update to address #35399
Closes #35627
https://github.com/dart-lang/sdk/pull/35627
GitOrigin-RevId: 31d1e45514ce672e01af2062bce193b97f6eb94a
Change-Id: I82f0aefb3acfbb937f61bb15b2999482f28eb5df
Reviewed-on: https://dart-review.googlesource.com/c/89021
Reviewed-by: Lasse R.H. Nielsen <lrn@google.com>
Commit-Queue: Lasse R.H. Nielsen <lrn@google.com>
diff --git a/sdk/lib/math/math.dart b/sdk/lib/math/math.dart
index 658c834..f33a7a8 100644
--- a/sdk/lib/math/math.dart
+++ b/sdk/lib/math/math.dart
@@ -145,8 +145,9 @@
*
* This corresponds to the `pow` function defined in the IEEE Standard 754-2008.
*
- * Notice that an [int] result cannot overflow, but a [double] result might
- * be [double.infinity].
+ * Notice that the result may overflow. If integers are represented as 64-bit
+ * numbers, an integer result may be truncated, and a double result may overflow
+ * to positive or negative [double.infinity].
*/
external num pow(num x, num exponent);
