JDK-4455590 : JavaDoc: comments for Math, StrictMath don't provide enough detail
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.lang
  • Affected Version: 1.4.0
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2001-05-08
  • Updated: 2001-10-08
  • Resolved: 2001-05-25
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
1.4.0 beta2Fixed
Related Reports
Relates :  
JDK-4929959 - Clarify math library ulp accuracy requirements and hypot spec
Relates :  
JDK-4875088 - Clarify definition of 1-ulp accuracy
Relates :  
JDK-4826732 - Add ulp method for floating-point value
Relates :  
JDK-4464532 - JavaDoc: docs of {Math, StrictMath}.atan2 parameters should be clarified
Description
The JavaDoc describing java.lang.Math says that certain math methods may have "1 ulp" accuracy and must be "semi-monotonic."  Unfortunately, the docs do not explain the meanings and implications of these terms.

In addition, there are miscellaneous minor problems with the JavaDoc, such as improper HTML tags, violations of Sun JavaDoc conventions, and misleading text.
Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: merlin-beta2 FIXED IN: merlin-beta2 INTEGRATED IN: merlin-beta2 VERIFIED IN: merlin-beta3
14-06-2004
EVALUATION Changes made to explain ulps and monotonicity in Math; minor javadoc cleanup throughout Math and StrictMath. joe.darcy@eng 2001-05-15
15-05-2001