Return-Path: X-Original-To: apmail-commons-dev-archive@www.apache.org Delivered-To: apmail-commons-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 6320410D98 for ; Tue, 8 Oct 2013 20:54:49 +0000 (UTC) Received: (qmail 61212 invoked by uid 500); 8 Oct 2013 20:54:44 -0000 Delivered-To: apmail-commons-dev-archive@commons.apache.org Received: (qmail 61134 invoked by uid 500); 8 Oct 2013 20:54:43 -0000 Mailing-List: contact dev-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Commons Developers List" Delivered-To: mailing list dev@commons.apache.org Received: (qmail 61105 invoked by uid 99); 8 Oct 2013 20:54:42 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 08 Oct 2013 20:54:42 +0000 X-ASF-Spam-Status: No, hits=-0.7 required=5.0 tests=RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of garydgregory@gmail.com designates 209.85.214.42 as permitted sender) Received: from [209.85.214.42] (HELO mail-bk0-f42.google.com) (209.85.214.42) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 08 Oct 2013 20:54:38 +0000 Received: by mail-bk0-f42.google.com with SMTP id my10so3582158bkb.1 for ; Tue, 08 Oct 2013 13:54:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type:content-transfer-encoding; bh=TfxHMDqCnR8OybRqPZDLDuKySUL2knfExhJEnUahSmI=; b=fTbBh7z2isOSW1iIaRdGWOkSBM/QqYEha3j8lvTao4CL3DsA/NwQo9t5N2DtMCKI7S M3VQ8iq2GhyhBbKLKXu2oaGpEiwlBQzH5nGOG0/AGVZmv/9NF3maYnjgfKKrZMlDWC4F IY/dZd2fxtIwvo+09iNabq7RNa6h4uH0tlJ7yKQVpOnYqLifwyf+fzejLxLpidS4Xkus Pqp3/PHJEaCDvV/jODizM5O4o1q9VTrKvUgi6S4awfccUGQoimuNDTEHJoWolYLfnKiC x7f1Ay3B4bkodIELqtEJkXZ7EQIdSIOOJ0Nbd6Jg+feRrFhVsXIXWfVD6TA+OEk/1Q6B SSGQ== MIME-Version: 1.0 X-Received: by 10.204.60.66 with SMTP id o2mr3550485bkh.22.1381265657360; Tue, 08 Oct 2013 13:54:17 -0700 (PDT) Received: by 10.205.6.7 with HTTP; Tue, 8 Oct 2013 13:54:17 -0700 (PDT) In-Reply-To: References: <5253C871.2050307@apache.org> <8738oc5b31.fsf@v35516.1blu.de> Date: Tue, 8 Oct 2013 16:54:17 -0400 Message-ID: Subject: Re: [DISCUSS] API compatibility policy From: Gary Gregory To: Commons Developers List Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Virus-Checked: Checked by ClamAV on apache.org On Tue, Oct 8, 2013 at 4:50 PM, Siegfried Goeschl wrote: > That's a reasonable style of versioning :) > > I had many issues with binary compatibilty with a commons-email release d= ue to changing the return value from void to a this reference plus some mov= ing of constants. You basically end up with either many restrictions or cre= ating major releases Then just create major releases! ;) Why would you not want to provide BC? Why add to the jar hell problem? I, the developer, have no control over how the API I provide will be used and distributed... G > > Cheers, > > Siegfried Goeschl > >> Am 08.10.2013 um 12:40 schrieb Torsten Curdt : >> >> Cannot remember which component from the top of my head - but it was >> related to package name changes. >> >> My style of thinking: x.y.z >> >> x - no compatibility >> y - source compatibility >> z - binary compatibility >> >> is simple and makes sense. >> >> It's OK to put some burden on the users when upgrading - as long as the >> expectations are set correctly. >> But I am pretty sure we discussed that before and some people did not ag= ree. >> >> cheers, >> Torsten >> >> >>> On Tue, Oct 8, 2013 at 12:08 PM, Stefan Bodewig wr= ote: >>> >>>> On 2013-10-08, Emmanuel Bourg wrote: >>>> >>>> Le 07/10/2013 20:14, Benedikt Ritter a =C3=A9crit : >>> >>>>> - loosen API compatibility policy? >>> >>>> This topic alone deserves its own thread I think. >>> >>>> Ensuring binary/source compatibility is very important. >>> >>> +1 >>> >>> I guess I've done too much ruby with "every bundle update runs the risk >>> of breaking everything" lately. I really value the stability commons >>> provides. >>> >>> That being said, I'm sure there are cases where our policy seems >>> stricter than it needs to be - even though I haven't seen a really >>> difficult case in the one component I contribute to. >>> >>> Stefan >>> >>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org >>> For additional commands, e-mail: dev-help@commons.apache.org >>> >>> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org > For additional commands, e-mail: dev-help@commons.apache.org > --=20 E-Mail: garydgregory@gmail.com | ggregory@apache.org Java Persistence with Hibernate, Second Edition JUnit in Action, Second Edition Spring Batch in Action Blog: http://garygregory.wordpress.com Home: http://garygregory.com/ Tweet! http://twitter.com/GaryGregory --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org For additional commands, e-mail: dev-help@commons.apache.org