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: 4621267
Votes 0
Synopsis Doclet API: ProgramElementDoc.qualifiedName() lacks parameter list - fix docs
Category doclet:tbd
Reported Against merlin-beta3
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, bug
Priority: 4-Low
Related Bugs
Submit Date 09-JAN-2002
Description
Fixed by removing parentheses from bar() as suggested.
No regression test required, as this is a doc comment change.

 xxxxx@xxxxx  2002-09-28




java version "1.4.0-beta3"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-beta3-b84)
Java HotSpot(TM) Client VM (build 1.4.0-beta3-b84, mixed mode)


 DESCRIPTION OF THE PROBLEM :

The documentation for ProgramElementDoc.qualifiedName() says that it will return "Foo.bar()" for the bar() method of the
Foo class in the unnamed package. However, it actually returns "Foo.bar". This is not used anywhere in the standard
doclet, and can be worked around by using (elt.qualifiedName()+((ExecutableMemberDoc)elt).signature()).
 Fixing the documentation would be as effective as fixing the method.


(Review ID: 138105) 
======================================================================
Work Around
N/A
Evaluation
Looks like changing the doc comment is the backward compatible way to go.
 xxxxx@xxxxx  2002-03-22

Changed synopsis from:
   ExecutableMemberDoc.qualifiedName() lacks signature - fix the docs

   ExecutableMemberDoc.qualifiedName() lacks parameter list - fix docs
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang