JDK-8103241 : TableColumnBase contains strange @since tags
  • Type: Enhancement
  • Component: javafx
  • Sub-Component: controls
  • Affected Version: 8
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2013-05-31
  • Updated: 2015-06-16
  • Resolved: 2013-09-05
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8Fixed
Related Reports
Relates :  
JDK-8102161 - Add @since tag to all API classes
Description
The TableColumnBase class was added in 8.0, but contains quite a few methods marked as @since 2.2.

I suppose they existed since 2.2 in the subclass and were moved to newly created superclass. So the tags probably look correct in the subclass' doc, but looking to this class, they claim the methods had been added to the class before it was created, which is pretty confusing. We need to sort out if this is ok or if the tags should be deleted. I'm not sure.
Comments
Note that methods don't need to have @since tag if it would be the same as the class-level one, so instead of replacing 2.2 by 8.0 the 2.2 can be just removed (perhaps slightly decreasing the first-sight TableColumn confusion).
31-05-2013
My gut feeling is to change this to be since 8.0, although it is a little confusing from the TableColumn perspective.
31-05-2013