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

The spec on javax.script.Compilable contains a typo and confusing inconsistency

    Details

    • Type: Bug
    • Status: Closed
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 9
    • Fix Version/s: 9
    • Component/s: core-libs
    • Labels:

      Backports

        Description

        The spec
        http://docs.oracle.com/javase/8/docs/api/javax/script/Compilable.html#compile-java.lang.String-

        has the following problems:

        1) typo: "Returns: An subclass ..."
        2) Returns is worded differently than the other - overloaded and functionally identical version of the same method. Please compare:
        "Returns:
        An subclass of CompiledScript to be executed later using one of the eval methods of CompiledScript."
        and
        "Returns:
        An implementation of CompiledScript to be executed later using one of its eval methods of CompiledScript."

        Different wording is confusing since it may give an impression that the methods behave differently and return different results.

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  sundar Sundararajan Athijegannathan
                  Reporter:
                  dbessono Dmitry Bessonov
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  3 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: