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

Grammar problems in API-Documentation of Runnable

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: P4
    • Resolution: Won't Fix
    • Affects Version/s: 8, 11, 17, 18
    • Fix Version/s: None
    • Component/s: core-libs
    • Subcomponent:
    • CPU:
      generic
    • OS:
      generic

      Description

      ADDITIONAL SYSTEM INFORMATION :
      https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/Runnable.html

      A DESCRIPTION OF THE PROBLEM :
      https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/Runnable.html contains two grammatical errors:
      "the Runnable interface should be used if you are only planning to override the run() method and no other Thread methods. This is important because classes should not be subclassed unless the programmer intends on modifying or enhancing the fundamental behavior of the class."

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      Please, check with a linguist of (American) English.

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      right: "the Runnable interface should only be used if you are planning to override the run() method and no other Thread methods. This is important because classes should not be subclassed unless the programmer intends to modify or enhance the fundamental behavior of the class."
      ACTUAL -
      false: "the Runnable interface should be used if you are only planning to override the run() method and no other Thread methods. This is important because classes should not be subclassed unless the programmer intends on modifying or enhancing the fundamental behavior of the class."

        Attachments

          Activity

            People

            Assignee:
            alanb Alan Bateman
            Reporter:
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved: