Mailing-List: contact java-dev-help@lucene.apache.org; run by ezmlm
Precedence: bulk
Reply-To: java-dev@lucene.apache.org
Received-SPF: neutral (nike.apache.org: local policy)
MIME-Version: 1.0
In-Reply-To: <4EE92A40-F518-4B33-A13D-40CCF521C496@gmail.com>
References: <9ac0c6aa0905181406l5c951016k97a16d8db766716e@mail.gmail.com>
	 <9ac0c6aa0905200914t142dfd59hef160d26e879d989@mail.gmail.com>
	 <alpine.OSX.2.00.0905200933140.71522@yuzu.local>
	 <9ac0c6aa0905201210l2becda41ic5d51b22fca043e@mail.gmail.com>
	 <786fde50905201224i56c6184et463254a8aeb83949@mail.gmail.com>
	 <9ac0c6aa0905201306p7948fae0sfe57e3a70eebe137@mail.gmail.com>
	 <D2502CE9-5B29-434B-8DBC-0540B5EF32C7@apache.org>
	 <786fde50905202034n5250bc9dk844c39a7d734668c@mail.gmail.com>
	 <9ac0c6aa0905210417t8b06085j54dd207ac86e76b8@mail.gmail.com>
	 <4EE92A40-F518-4B33-A13D-40CCF521C496@gmail.com>
Date: Thu, 21 May 2009 12:09:17 -0400
Message-ID: <9ac0c6aa0905210909icaf86c3ke81740e40993adb5@mail.gmail.com>
Subject: Re: Lucene's default settings & back compatibility
From: Michael McCandless <lucene@mikemccandless.com>
To: java-dev@lucene.apache.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Thu, May 21, 2009 at 8:24 AM, DM Smith <dmsmith555@gmail.com> wrote:
>
> On May 21, 2009, at 7:17 AM, Michael McCandless wrote:
>
>> =A01) Default settings can change; we will always choose defaults based
>> =A0 =A0on "latest & greatest for new users". =A0This only affects "runti=
me
>> =A0 =A0behavior". =A0EG in 2.9, when sorting by field you won't get scor=
es
>> =A0 =A0by default. =A0When we do this we should clearly document the
>> =A0 =A0change, and what settings one could use to get back to the old
>> =A0 =A0behavior, in CHANGES.txt.
>
> I'd reverse 1 and 2 and note in 1 that the old behavior might be deprecat=
ed.

OK.

>> =A02) An API, once released as deprecated, is fair game to be removed
>> =A0 =A0in the next minor release.
>
> I presume you mean that it will be present for at least one full minor
> release. So, if at 3.1.5 a deprecation is introduced, then it won't be
> removed until 3.3 at the earliest, because 3.2 was the first minor releas=
e
> in which it appeared at the start. I don't think it is fair to expect use=
rs
> to get every last point release.

Right.

>> We still only make bug fixes on point releases, support the index file
>> format until the next major release -- those don't change.
>
> Is it just the index file format? I would hope that the behavior of filte=
rs,
> analyzers and such would not change so as to invalidate an index.

Can you give an example of such changes?  EG if we fix a bug in
StandardAnalyzer, we will default it to fixed for new users and expect
you on upgrading to read CHANGES.txt and change your app to set that
setting to its non-defaulted value.

Mike

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