During code review for JDK-8225372, I noticed Modality.html [1][2] extensively uses <u> element [3]. This element was deprecated in HTML 4; it was restored with HTML 5 with new semantic. I strongly believe the usage of <u> in this document does not correspond to the element semantics [4][5]. I think it should be replaced with <mark> "to mark key words or phrases" or <i> "to denote technical terms..." which better correspond to the usage on this page.

The entire java.desktop module should be analysed and cleaned of <u> where it's used for presentational purposes only.

(The usage of HTML elements <b> and <i> should also be analysed.)


The HTML element <u> was removed from Modality.html under JDK-8225372. However, I think it served its purpose [6].

[1] http://mail.openjdk.java.net/pipermail/swing-dev/2019-September/009786.html
[2] https://docs.oracle.com/en/java/javase/13/docs/api/java.desktop/java/awt/doc-files/Modality.html
[3] https://developer.mozilla.org/en-US/docs/Web/HTML/Element/u
[4] https://developer.mozilla.org/en-US/docs/Web/HTML/Element/u#Usage_notes
[5] https://developer.mozilla.org/en-US/docs/Web/HTML/Element/u#Avoiding_%3Cu%3E
[6] http://mail.openjdk.java.net/pipermail/swing-dev/2019-September/009791.html