update comment

Author: picnixz

Lib/reprlib.py

@@ -192,9 +192,8 @@ def repr_int(self, x, level):
             # are rendered differently as their repr() raises a ValueError.
             # See https://github.com/python/cpython/issues/135487.
             k = 1 + int(math.log10(abs(x)))
-            # When math.log10(abs(x)) is overestimated or underestimated,
-            # the number of digits should be k - 1 or k + 1 respectively.
-            # For simplicity, we do not compute the exact number of digits.
+            # Note: math.log10(abs(x)) may be overestimated or underestimated,
+            # but for simplicity, we do not compute the exact number of digits.
             max_digits = sys.get_int_max_str_digits()
             return (f'<{x.__class__.__name__} instance with roughly {k} '
                     f'digits (limit at {max_digits}) at 0x{id(x):x}>')

Lib/test/test_reprlib.py

@@ -179,7 +179,7 @@ def re_msg(n, d):
                 self.assertRegex(r(n), re_msg(n, k + 1))
             with self.subTest(f'10 ** {k} - 1', k=k):
                 n = 10 ** k - 1
-                # For k >> 1, since math.log10(n) == math.log10(n-1),
+                # Here, since math.log10(n) == math.log10(n-1),
                 # the number of digits of n - 1 is overestimated.
                 self.assertRaises(ValueError, repr, n)
                 self.assertRegex(r(n), re_msg(n, k + 1))