RFR: 8047722: @since tag cleanup in corba

Alan Bateman Alan.Bateman at oracle.com
Thu Jul 3 17:16:39 UTC 2014


On 02/07/2014 01:31, Stuart Marks wrote:
>
> There are some strange cases here.
>
> But the high order question is API vs implementation, and I think 
> @since really is about API.
I don't know if was a conclusion on what to do with some of these but 
maybe the simplest is to just remove @since from some of the 
implementation classes and just eliminate the confusion that they cause.

Looking com.sun.corba.se.impl.util.IdentityHashtable then it appears 
that the code was originally copied from code in what was the JDK1.1.6 
workspace at the time. It's not clear to me that having the @since 
JDK1.0 tags in several methods has anything but negative value here. One 
of the really odd ones is com.sun.corba.se.impl.io.IIOPInputStream where 
the readObjectDelegate has both @since JDK 1.1 and @since JDK 1.1.6 :-)

-Alan



More information about the core-libs-dev mailing list