On 24 February 2014 16:33, Gary Gregory <[email protected]> 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.

> Gary
>
>
> On Mon, Feb 24, 2014 at 11:18 AM, sebb <[email protected]> wrote:
>
>> The class ExponentialBackOffSchedulingStrategy references the package
>> class AsynchronousValidationRequest in Javadoc.
>>
>> However, because the default is to not show package-protected classes,
>> the generated Javadoc has a broken link:
>>
>>
>> http://hc.apache.org/httpcomponents-client-4.3.x/httpclient-cache/apidocs/org/apache/http/impl/client/cache/ExponentialBackOffSchedulingStrategy.html
>>
>> Just wondering whether we should change the default level?
>>
>> This can be done on the command-line with -Dshow=package
>>
>> [The above was found in the 4.3 branch, but is probably relevant in trunk]
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [email protected]
>> For additional commands, e-mail: [email protected]
>>
>>
>
>
> --
> E-Mail: [email protected] | [email protected]
> Java Persistence with Hibernate, Second 
> Edition<http://www.manning.com/bauer3/>
> JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> Spring Batch in Action <http://www.manning.com/templier/>
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to