hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Oleg Kalnichevski <ol...@apache.org>
Subject Re: Change Javadoc show level?
Date Tue, 25 Feb 2014 09:52:21 GMT
On Tue, 2014-02-25 at 01:08 +0000, sebb wrote:
> On 24 February 2014 16:33, Gary Gregory <garydgregory@gmail.com> wrote:
> > +1
> >
> > If we have a public subclass of a package private class, I should be able
> > to see all of the methods I can call on that class (and super class).
> 
> That's not the case here. It's a public class using a package class.
> 
> http://hc.apache.org/httpcomponents-client-4.3.x/httpclient-cache/apidocs/org/apache/http/impl/client/cache/ExponentialBackOffSchedulingStrategy.html#schedule%28org.apache.http.impl.client.cache.AsynchronousValidationRequest%29
> 
> Which begs the question - how is it used externally?
> 
> The schedule method implements an interface so has to be public, but
> perhaps it is only intended for use internally.
> In which case the Javadoc should probably make this clear.
> 

In this package private classes ought not be referenced by public
javadocs.

Oleg



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org


Mime
View raw message