8000269: Cleanup javadoc warnings

Alan Bateman Alan.Bateman at oracle.com
Mon Oct 1 08:53:01 UTC 2012

On 01/10/2012 08:20, David Holmes wrote:
> Hi Alan,
> This one caught my eye:
> src/share/classes/java/net/AbstractPlainDatagramSocketImpl.java
> This entire class seems to re-declare inherited methods from 
> DatagramSocketImpl for no obvious reason and mess up the javadoc in 
> the process. In many/most cases there is no need to redeclare the 
> methods AFAICS. If there is some subtle reason then inheritance of the 
> existing javadoc should suffice in the majority of cases.
I agree. I talked to Chris about it as it's left over from the 
refactoring of the socket impls. As these are package-private classes 
and don't show up in the javadoc I decided to do the minimum and just 
fix up the @param tags. I create a separate issue to sort out the socket 
impl docs.


More information about the core-libs-dev mailing list