RFR: 8047722: @since tag cleanup in corba
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 :-)
More information about the core-libs-dev