RFR: 8357063: Document preconditions for DecimalDigits methods

[Raffaello Giulietti]

On Thu, 15 May 2025 06:24:44 GMT, Shaojin Wen <swen at 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