Re: Hits deprecated note is wrong

[Michael McCandless <lu...@mikemccandless.com>]

It's too bad there's no way to express a "this code fragment should
compile" inside a javadoc (I think?).

Had we {@link ...}'d each method invocation we would have at least
seen javadoc warnings, but that's a real hassle.

Mike

On Wed, Sep 30, 2009 at 12:07 PM, Mark Miller <ma...@gmail.com> wrote:
> Shai Erera wrote:
>> We're giving users a wrong impression as if they really need to create
>> TSDC and this can confuse people (see other thread by Eks).
>>
> And even then, because Hits users tended to be less advanced users, they
> are likely to be confused with TSDC - this guy was like, what the heck,
> the class is abstract! What the heck am I supposed to do! He was quite
> confused :) Didn't see that static create method.
>
> No ones fault in particular - just a bummer.
>
> --
> - Mark
>
> http://www.lucidimagination.com
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>
>

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