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

(spec) Math.asin(...) says arc sine of _angle_; acos, atan wrong too

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 6
    • 5.0
    • core-libs
    • b12
    • x86
    • windows_xp

      Name: js151677 Date: 08/02/2004


      A DESCRIPTION OF THE PROBLEM :
      The method description for java.lang.Math.asin(double) says:

         Returns the arc sine of an angle, in the range of -pi/2 through pi/2. ....

      Saying "the arc sine of an angle" makes no sense, because the arc sine function not a
      function of an angle. It is a function whose _return_ value represents an angle. The
      argument is not an angle.

      Additionally, the return value description does not say that the value is the angle
      in radians (as the parameter descriptions for sin(...), etc., document that they are
      angles expression in radians).

      The descriptions of asin(double) and atan(double) have the same error.



      ACTUAL -
      see above

      URL OF FAULTY DOCUMENTATION :
      http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Math.html
      (Incident Review ID: 290560)
      ======================================================================
      ###@###.### 10/25/04 20:37 GMT

            darcy Joe Darcy
            jssunw Jitender S (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: