Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8231128

Cleanup usage of <u> in java.desktop files

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Open
    • Priority: P3
    • Resolution: Unresolved
    • Affects Version/s: 11, 12, 13, 14
    • Fix Version/s: tbd
    • Component/s: client-libs

      Description

      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

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              aivanov Alexey Ivanov
              Reporter:
              aivanov Alexey Ivanov
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Dates

                Created:
                Updated: