On Thu, 15 May 2025 06:24:44 GMT, Shaojin Wen <s...@openjdk.org> wrote:

> Similar to PR #24982 
> Document preconditions on certain DecimalDigits methods that use operations 
> either unsafe and/or without range checks.

The renaming is nice and useful.
But #24982, in addition to renaming, emphasizes the expectations about correct 
usage with bold WARNINGs in the JavaDoc. That's the "document preconditions" in 
the title.
Adding similar warnings in the JavaDoc, rather than in plain comments in the 
methods, would be clearer.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/25246#issuecomment-2885920485

Reply via email to