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

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

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 9
    • 9
    • core-libs

        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.

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

                Created:
                Updated:
                Resolved: