United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: 4455590 JavaDoc: comments for Math, StrictMath don't provide enough detail
4455590 : JavaDoc: comments for Math, StrictMath don't provide enough detail

Details
Type:
Bug
Submit Date:
2001-05-08
Status:
Closed
Updated Date:
2001-10-08
Project Name:
JDK
Resolved Date:
2001-05-25
Component:
core-libs
OS:
generic
Sub-Component:
java.lang
CPU:
generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
1.4.0
Fixed Versions:
1.4.0

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

Sub Tasks

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
2004-06-14 
EVALUATION

Changes made to explain ulps and monotonicity in Math; minor javadoc cleanup throughout Math and StrictMath.

joe.darcy@eng 2001-05-15
2001-05-15


Hardware and Software, Engineered to Work Together