Mailing-List: contact dev-help@commons.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Commons Developers List" <dev@commons.apache.org>
Received-SPF: pass (nike.apache.org: local policy)
Date: Wed, 17 Nov 2010 01:10:36 +0100
From: Gilles Sadowski <gilles@harfang.homelinux.org>
To: dev@commons.apache.org
Subject: Re: [math] preparing smooth interface upgrade for users
Message-ID: <20101117001036.GM10411@dusk.harfang.homelinux.org>
Mail-Followup-To: dev@commons.apache.org
References: <4CE2EEF4.2030204@free.fr>
 <20101116231944.GL10411@dusk.harfang.homelinux.org>
 <AANLkTimuDbTDCFSTf+h2sEk3qxyvFLMbPN6Y=5=3og-y@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <AANLkTimuDbTDCFSTf+h2sEk3qxyvFLMbPN6Y=5=3og-y@mail.gmail.com>
User-Agent: Mutt/1.5.20 (2009-06-14)
X-DCC-scarlet.be-Metrics: sif 20001; Body=1 Fuz1=1 Fuz2=1
X-Virus-Checked: Checked by ClamAV on apache.org

> >> [...]
> >> I think this transition is the smoother path for our users. Do you think
> >> this change is the way to go ?
> >
> > -0
> 
> +1
> 
> >
> > My first impression is that it is a lot of changes for 2.2 without any
> > benefit when users will switch to 3.0; they will still have to scan their
> > code for all the exceptions that will have disappeared.
> 
> Won't the deprecations take care of that?

I didn't mean that they have to scan "manually", just that they will have to
make the same change in 3.0 as they would in 2.2 (not more, not less work).
Hence, I see no benefit in breaking the "no compatibility breaking" rule in
2.2.

> 
> > In 3.0 it will clear that they *have* to do it while, in 2.2, you would
> > have to explain to users that it's better that they do it but that it
> > will still work if they don't... And they will probably say: "If it ain't
> > broken, I won't fix it." ;-)
> 
> However, deprecation warnings are a strong hint that failure is
> imminent, and they may wish to prepare for the change.

Yes. We should advertise the list of exceptions that are going to be
replaced by "MathUserException" when users switch 3.0, by deprecating
them in 2.2.
The preparation is to have a perl (or sed or ...) script ready.


Best,
Gilles

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