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

[Alan Snyder]

LGTM

> On Jun 3, 2021, at 7:41 AM, Phil Race <prr at openjdk.java.net> wrote:
> 
> On Wed, 2 Jun 2021 13:08:08 GMT, Alexander Zvegintsev <azvegint at openjdk.org> wrote:
> 
>>> Some useful documentation was added to the JPasswordField.
>> 
>> src/java.desktop/share/classes/javax/swing/JPasswordField.java line 68:
>> 
>>> 66:  * handling confidential information such as the password text, refer to the
>>> 67:  * relevant section at
>>> 68:  * <a href="https://www.oracle.com/java/technologies/javase/seccodeguide.html">
>> 
>> We might want to use the link with an anchor to the specific section, e.g.:
>> https://www.oracle.com/java/technologies/javase/seccodeguide.html#2-2
> 
> If we want to allow that the representation of what was typed is anything the UI decides then let's start from scratch,
> 
> The {@code JPasswordField} will not show the original characters that were typed, instead displaying alternative text or graphics.
> However this doesn't prevent... [and then the rest is as originally proposed]
>