This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 42216 - Update javadoc for API (JMI) methods with untyped return/parameter values (Collections and Objects)
Summary: Update javadoc for API (JMI) methods with untyped return/parameter values (Co...
Status: RESOLVED FIXED
Alias: None
Product: java
Classification: Unclassified
Component: Unsupported (show other bugs)
Version: 4.x
Hardware: All All
: P3 blocker (vote)
Assignee: issues@java
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-04-20 20:05 UTC by Martin Matula
Modified: 2007-09-26 09:14 UTC (History)
0 users

See Also:
Issue Type: TASK
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Martin Matula 2004-04-20 20:05:17 UTC 
From Tom Ball's e-mail:
Could we add a low-priority task to update the
javadoc comments for all
of the methods that are untyped?  By that I mean
any parameter or return
that is an Object (but really returns an
unspecified type) or
Collection?  We probably don't have time to do
this all at once, but
whenever a file is modified it would be great if
the surrounding doc
comments were improved.  When 1.5 is the minimum
JDK version, these
comments will point to what should use a generic type.
Comment 1 Martin Matula 2004-12-03 13:26:51 UTC 
Implemented by Jesse.
Comment 2 Jan Pokorsky 2004-12-06 17:30:59 UTC 
I can find just return types documented. Parameters are still cryptic
(see eg ClassDefinition.getConstructor or XXXClass interfaces). Reopening.
Comment 3 Jan Becicka 2006-10-26 16:26:52 UTC 
Javacore module was replaced by Retouche infrastructure. This bug is not valid
in trunk any more.
Comment 4 Quality Engineering 2007-09-20 10:12:54 UTC 
Reorganization of java component