RFR: 8047722: @since tag cleanup in corba
henry.jen at oracle.com
Mon Jun 30 15:17:05 UTC 2014
On 06/30/2014 12:18 AM, Alan Bateman wrote:
> On 30/06/2014 02:30, Henry Jen wrote:
>> On 06/20/2014 02:28 PM, Henry Jen wrote:
>>> Please review a trivial webrev for jdk9/corba that do the same @since
>>> tag normalization as in jdk9/jdk.
> There are bunch of @since JDK 1.0 and JDK 1.1.6 that you are changing to
> 1.0 and 1.1.6. AFAIK, CORBA was added in 1.2 and I wonder if we should
> fix this as part of this change.
Thanks for review. You are correct that CORBA was added in 1.2.
My understadning to those 1.0 to 1.1.6 versions are for override
methods, I guess the author is putting down the version of the origin.
There are several cases where @since can be ambiguous without a common
- An method was private or package access only made public, should
@since denote the API availablity or the implementation?
- APIs from classed was extracted into a super class or interface in a
later version, what should be the @since?
- Implementation of interface methods
- Override methods
Guess they are actually all the same question, does @since mean API
availability or implementation?
For prior, interface/override methods should not carry it's own since,
for later, it should have @since as the owner class.
More information about the core-libs-dev