RFR: 6955128: Spec for javax.swing.plaf.basic.BasicTextUI.getVisibleEditorRect contains inappropriate wording

[Phil Race]

On Tue, 17 Jun 2025 12:43:23 GMT, Prasanta Sadhukhan <psadhukhan at openjdk.org> wrote:

> BasicTextUI.getVisibleEditorRect wording is rephrased to remove the wording "Due to an unfortunate set of historical events this method is inappropriately named".

This may yet need a CSR depending on where the wording ends up.

src/java.desktop/share/classes/javax/swing/plaf/basic/BasicTextUI.java line 1033:

> 1031:     /**
> 1032:      * Gets the allocation to give the root View.
> 1033:      * The Rectangle returned has nothing to do with visibility but

"nothing to do with" ->  "unrelated to"


But what I'd really like to see is an explanation of what the return from this method ACTUALLY means / is used for.
What does "the allocation" mean ? Too woolly for me.

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

PR Comment: https://git.openjdk.org/jdk/pull/25850#issuecomment-2985613082
PR Review Comment: https://git.openjdk.org/jdk/pull/25850#discussion_r2155444301