<Swing Dev> RFR: 8268087: Update documentation of the JPasswordField

[Alan Snyder]

I think this statement is over-constraining the UI behavior.

What the password field displays does not have to be text in the ordinary sense of the word. It could be a series of large dots. It is really up to the UI.

Also, the sentence is turned around. It should not start with the “text entered”, which is irrelevant.

Also, a UI may allow the user to request that the entered text be displayed. That should not be ruled out.

How about:

For security reasons, JPasswordField does not display the entered text. (Some UIs may allow the user to request the display of the entered text.)



> On Jun 2, 2021, at 6:33 PM, Phil Race <prr at openjdk.java.net> wrote:
> 
> On Thu, 3 Jun 2021 01:23:25 GMT, Sergey Bylokhov <serb at openjdk.org> wrote:
> 
>>> I do not like the phrase "Although the text displayed in", the "text" is not displayed in the JPasswordField per se, please suggest something else.
>> 
>> "The text entered in {@code JPasswordField} displays that something was typed and does not show the original characters"
>> ?
> 
> change "and" to "but" and that will be good enough
> 
> "The text entered in {@code JPasswordField} displays that something was typed but does not show the original characters"
> 
> -------------
> 
> PR: https://git.openjdk.java.net/jdk/pull/4296
>