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

Grammar problems in API-Documentation of Runnable

    XMLWordPrintable

Details

    • Bug
    • Resolution: Won't Fix
    • P4
    • None
    • 8, 11, 17, 18
    • core-libs
    • generic
    • 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

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

            Dates

              Created:
              Updated:
              Resolved: