commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gary Gregory <garydgreg...@gmail.com>
Subject Re: [POOL] @inheritDoc tags for @throws clauses in LinkedBlockingDeque
Date Wed, 17 Aug 2011 15:15:07 GMT
+1, who's on first again?

Gary

On Wed, Aug 17, 2011 at 11:09 AM, sebb <sebbaz@gmail.com> wrote:

> Eclipse complains about all the @inheritDoc tags in LinkedBlockingDeque.
>
> AFAICT, @inheritDoc is allowed in @throws, but only if the method has
> something to inherit from, i.e.. it overrides a super-class method or
> implements an interface (Java 1.6+)
> It does not inherit from the Throwable, which was perhaps the intention?
>
> Oracle Java 1.5 is happy to allow @inheritDoc in the add() method -
> because that overrides - but Eclipse complains.
> [Looks like bug in Eclipse javadoc handling]
>
> However, neither Oracle nor Eclipse allow the tag if there is no
> parent, so I propose to remove such tags.
>
> OK?
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>


-- 
Thank you,
Gary

http://garygregory.wordpress.com/
http://garygregory.com/
http://people.apache.org/~ggregory/
http://twitter.com/GaryGregory

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message