Sure , Hoss Point taken . We will document them accordingly --Noble On Sat, Jun 28, 2008 at 3:09 AM, Chris Hostetter <[EMAIL PROTECTED]> wrote: > > : These are "read only" interfaces exposed to users as a part of the > : API. They never implement but use them a lot so they have to be > : public > > Yeah, but there's no such thing as a "read only" interface :) ... even if > you can't think of a reason why someone would implement your interface, if > it's public they might, and then they might complain that their app > doesn't compile when they upgrade from Solr 1.3.0 to Solr 1.3.1 becuase > you added a method to it. > > it's silly, i agree, but it's happened ... more then once, which is why > the safe thing to do is add a simple javadoc comment in cases like this > .... "Note: This interface is not intended to be implemented by third > party code, it may change without warning." > > > -Hoss > >
-- --Noble Paul
