JDK-4640428 : REGRESSION: JDK 1.4 API: java.sql.DatabaseMetaData "Use" is incorrect
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P3
  • Status: Closed
  • Resolution: Duplicate
  • OS: generic
  • CPU: generic
  • Submitted: 2002-02-20
  • Updated: 2014-05-05
  • Resolved: 2002-02-20
Related Reports
Duplicate :  
Description

Name: rmT116609			Date: 02/20/2002


FULL PRODUCT VERSION :
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)

DESCRIPTION OF THE PROBLEM :

I have no idea if Javadoc was run incorrectly or whether it's a Java doc bug, but the "Use" section of the API documentation from java.sql.DatabaseMetaData is empty (and should at least list Connection.getMetaData() as a method which returns DatabaseMetaData), and java.sql as a package which uses it.

Obviously, the problem could be more widespread; I haven't done a comprehensive search through the API; just noticed this one.

REGRESSION.  Last worked in version 1.3.1_02.


http://java.sun.com/j2se/1.3/docs/api/java/sql/DatabaseMetaData.html

http://java.sun.com/j2se/1.3/docs/api/java/sql/class-use/DatabaseMetaData.html


http://java.sun.com/j2se/1.4/docs/api/java/sql/DatabaseMetaData.html

http://java.sun.com/j2se/1.4/docs/api/java/sql/class-use/DatabaseMetaData.html


STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1.  Browse to the java.sql.DatabaseMetaData javadoc.
2.  Click on "Use"
3.  Notice that it is empty.

EXPECTED VERSUS ACTUAL BEHAVIOR :
Should see java.sql as "package that uses DatabaseMetaData"

Should see java.sql.Connection.getMetaData() as "method which returns DatabaseMetaData"

Release Regression From : 1.3.1_02
The above release value was the last known release where this 
bug was knwon to work. Since then there has been a regression.

(Review ID: 139933) 
======================================================================

Comments
EVALUATION This is a javadoc bug. It is a dupe of 4496290 -use is severely broken ###@###.### 2002-02-20
20-02-2002