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 <markrmil...@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-unsubscr...@lucene.apache.org > For additional commands, e-mail: java-dev-h...@lucene.apache.org > > --------------------------------------------------------------------- To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org For additional commands, e-mail: java-dev-h...@lucene.apache.org