RFR: 8306036: Use @apiNote in String.toLowerCase, String.toUpperCase [v2]

[Alan Bateman]

On Sat, 15 Apr 2023 11:17:34 GMT, Eirik Bjorsnos <duke at openjdk.org> wrote:

>> Please review this PR which suggests to use `@apiNote` in the `String.toLowerCase()` and `String.toUpperCase()` API docs.
>> 
>> These methods include important usage notes which today are encoded using `<b>Note:</b>`.
>
> Eirik Bjorsnos has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains two additional commits since the last revision:
> 
>  - Merge branch 'master' into to-ul-case-apinote
>  - Use @apiNote in String.toLowerCase, String.toUpperCase

Replaces bolded-"Note" with "API Note" so looks reasonable. There may be a few like this around the JDK that pre-date the apiNote tag.

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

Marked as reviewed by alanb (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/13487#pullrequestreview-1386605766