Return-Path: 
 <dev-return-18896-apmail-geronimo-dev-archive=geronimo.apache.org@geronimo.apache.org>
Delivered-To: apmail-geronimo-dev-archive@www.apache.org
Received: (qmail 52650 invoked from network); 31 Oct 2005 05:30:22 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 31 Oct 2005 05:30:22 -0000
Received: (qmail 37621 invoked by uid 500); 31 Oct 2005 05:30:18 -0000
Delivered-To: apmail-geronimo-dev-archive@geronimo.apache.org
Received: (qmail 37571 invoked by uid 500); 31 Oct 2005 05:30:17 -0000
Mailing-List: contact dev-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:dev-help@geronimo.apache.org>
list-unsubscribe: <mailto:dev-unsubscribe@geronimo.apache.org>
List-Post: <mailto:dev@geronimo.apache.org>
Reply-To: dev@geronimo.apache.org
List-Id: <dev.geronimo.apache.org>
Delivered-To: mailing list dev@geronimo.apache.org
Received: (qmail 37560 invoked by uid 99); 31 Oct 2005 05:30:17 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 30 Oct 2005 21:30:17 -0800
X-ASF-Spam-Status: No, hits=-0.0 required=10.0
	tests=SPF_PASS
X-Spam-Check-By: apache.org
Received-SPF: pass (asf.osuosl.org: domain of brett.porter@gmail.com
 designates 66.249.82.203 as permitted sender)
Received: from [66.249.82.203] (HELO xproxy.gmail.com) (66.249.82.203)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 30 Oct 2005 21:30:13 -0800
Received: by xproxy.gmail.com with SMTP id t14so781706wxc
        for <dev@geronimo.apache.org>; Sun, 30 Oct 2005 21:29:55 -0800 (PST)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=gmail.com;
        h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references;
        b=F736nEQbI8BvmOU25v9/Xf0XPwbvf9iPcZ44OmYVstn36t6c1YvOOJE3irEtJ4v/c/qMyumKFiXTSTjqaxYkI9W45Oc8enVepCH27dnD9xSRfy1IrqCbEmISkbxoiRpOb+Y6GCircQXu8/76RylBPQ2TFjxIjUIVPitPmBR7Fgs=
Received: by 10.70.9.1 with SMTP id 1mr1500160wxi;
        Sun, 30 Oct 2005 21:29:55 -0800 (PST)
Received: by 10.70.40.13 with HTTP; Sun, 30 Oct 2005 21:29:55 -0800 (PST)
Message-ID: <9e3862d80510302129j4d199cbel2c258b19f876ba37@mail.gmail.com>
Date: Mon, 31 Oct 2005 16:29:55 +1100
From: Brett Porter <brett.porter@gmail.com>
To: dev@geronimo.apache.org
Subject: Re: Specs directory structure
In-Reply-To: <F53C0D5A-C1FF-4B5F-8933-9B68AB7CA27A@iq80.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
References: <F53C0D5A-C1FF-4B5F-8933-9B68AB7CA27A@iq80.com>
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

I think this versioning has potential to be confusing, and the
omission of <version/> below doesn't actually do that - though it is
probably possible with a version of (,) that includes everything.

Personally, I'd prefer to have:
servlet-api-2.4
servlet-api-2.4-1
servlet-api-2.4-2
or similar.

(Technically, the last "build number" is used for rebuilding the same
source code, not patching, but I think the alternative of 2.4.x
creates some more confusion and the above will work as intended).
Ideally, once 2.4 is compliant you don't need to release it again
anyway :)

Perhaps when we have proper spec-dependency handling in Maven it might
be less confusing to use the geronimo-spec version number instead of
the spec number.

My 2cents...

- Brett


On 10/30/05, Dain Sundstrom <dain@iq80.com> wrote:
> I know this has been talked about before on this list, but I'd like
> to get the proposal in one place.  With the help of Alan and Jason,
> this is what I got:
>
> Normally we just have this directory structure:
>
> specs/trunk/servlet-2.2/src/
> specs/trunk/servlet-2.4/src/
> specs/trunk/jsp-2.4/src/
> When we are happy with the specs we make a tag:
>
> specs/tags/1.0/servlet-2.2/src/
> specs/tags/1.0/servlet-2.4/src/
> specs/tags/1.0/javamail-2.2-r2/src/
> specs/tags/1.1/servlet-2.2/src/
> specs/tags/1.1/servlet-2.4/src/
> specs/tags/1.1/javamail-2.2-r2/src/
> The pom for the specs would be like this:
>
>    <groupId>org.apache.geronimo.specs</groupId>
>      <artifactId>servlet-2.4</artifactId>
>      <name>Geronimo :: Servlet API</name>
>    <version>1.0</version>
> With maven 2 version ranges a user can just have the following and
> maven will pick the most resent release of our spec automatically:
>
>    <dependency>
>      <groupId>org.apache.geronimo.specs</groupId>
>      <artifactId>servlet-2.4</artifactId>
>    <dependency>
>
> The current directory structure in https://svn.apache.org/repos/asf/
> geronimo/specs is very close to this.  The only big change will be to
> add the version number of the specification to the directory name.
>
> What do yo think?
>
> -dain
>