RFR: 8326627: Document Double/Float.valueOf(String) behaviour for numeric strings with non-ASCII digits

[Iris Clark]

On Wed, 27 Mar 2024 19:58:17 GMT, Naoto Sato <naoto at openjdk.org> wrote:

> Clarifying the behavior for non-ASCII digits in Double/Float.valueOf(String) method descriptions. A draft CSR has also been created.

Associated CSR also Reviewed.  I like the relocation of existing text to the more appropriate `@apiNote`.  The example provides additional clarity.

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

Marked as reviewed by iris (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/18526#pullrequestreview-1964850180