Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4640428
Votes 0
Synopsis REGRESSION: JDK 1.4 API: java.sql.DatabaseMetaData "Use" is incorrect
Category doclet:tbd
Reported Against 1.4
Release Fixed
State 11-Closed, duplicate of 4496290, bug
Priority: 3-Medium
Related Bugs 4496290
Submit Date 20-FEB-2002
Description




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) 
======================================================================
Work Around
N/A
Evaluation
This is a javadoc bug.  It is a dupe of  4496290 -use is severely broken
  xxxxx@xxxxx   2002-02-20
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang