JDK-4513840 : No @since tags in docs for e.g. java.beans.Introspector
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 1.3.1
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • OS: generic
  • CPU: generic
  • Submitted: 2001-10-11
  • Updated: 2001-10-30
  • Resolved: 2001-10-30
Related Reports
Duplicate :  
Description

Name: ddT132432			Date: 10/11/2001


java version "1.3.1"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1-b24)
Java HotSpot(TM) Client VM (build 1.3.1-b24, interpreted mode)


There's no way to see in the API specification which methods or fields in
java.beans.Introspector exist since Java2, and which are available in
Java-1.1.8 or earlier version.
The java.beans package docs seems to contain no @since tags at all.

E.g.:
java.beans.Introspector.getBeanInfo(Class, int) must have been introduced in
Java2, since it is not available in Java-1.1.8.
But there's no "Since: 1.2" in the documentation, no hint at all. You have to
compare a pre-Java2 API specification with a newer one, method by method.

The same applies to Introspector.IGNORE_ALL_BEAN_INFO and
Introspector.flushFromCaches(Class), for example.
(Review ID: 133599) 
======================================================================

Comments
EVALUATION This is part of a larger problem. There are many fields/methods missing @since tags. We have plans to write a script that checks for these missing tags. See bug 4466493. ###@###.### 2001-10-30
30-10-2001