RFR: JDK-6229853: BasicTextAreaUI:create incompletely documents the possible returned View types

[Phil Race]

On Wed, 21 Sep 2022 12:25:48 GMT, Prasanta Sadhukhan <psadhukhan at openjdk.org> wrote:

> API specification says about BasicTextAreaUI.create "Returns a WrappedPlainView or PlainView". 
> But for [bidi](https://github.com/openjdk/jdk/blob/d14e96d9701dae951aa365029f58afb6687a646a/src/java.desktop/share/classes/javax/swing/plaf/basic/BasicTextAreaUI.java#L168) text, this method returns BoxView and other views , so the documentation needs to be updated.

Yeah I don't  like the way this is documented at all. And it seems this can be swapped out on the fly when content changes too.
I think we need to start with WHY we need to document the return types. And if we don't then we don't.
If we do I'd like some detailed reasoning and contemplation of what we say about if it changes later.

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

PR: https://git.openjdk.org/jdk/pull/10376