xml-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Mike Pogue <mpo...@apache.org>
Subject Re: [Proposal] Guidlines for package distribution of Java projects
Date Fri, 19 Nov 1999 21:24:15 GMT
The proposal should address C++ as well, I think, because xml.apache.org
is not only about Java!  A similar scheme should work for C++, I
believe.

Yes, I'd like to see all the subprojects/components use a common naming
and versioning scheme.

Mike

Stefano Mazzocchi wrote:
> 
> Background
> ----------
> 
> Many of xml.apache.org projects are components. Components are used and
> somehow hidden to the users. This is good for installation and usage,
> but sometimes you need a way to tell if these components are the latest
> available or not. Also, you need to have a common look and feel of
> components packaging and distribution.
> 
> Proposal
> --------
> 
> 1) Versioning
> 
> I propose that every package named
> 
>  org.apache.xxx
> 
> contains a class named Version like this (example for Cocoon)
> 
> public class Version {
>    public static String getName() {
>         return "Cocoon";
>    }
>    public static String getVersion() {
>         return "1.6"
>    }
>    public static URL getLatestRelease() {
>         return new URL("http://xml.apache.org/dist/cocoon.jar");
>    }
> }
> 
> 2) archive type
> 
> I propose that every java project is distributed as one or more jar
> file.
> 
> 3) package name
> 
> I propose the following name model for packages
> 
>  name[-type]-version.jar
> 
> where
> 
>  name := the project name
>  type := an optional indication (bin|src|all|???)
>  version := the version information
> 
> note that "name" and "version" _must_ be the one passed by "getName()"
> and "getVersion()" methods in Version.
> 
> 4) latest package name
> 
> I propose to add a symlink to the http://xml.apache.org/dist/ directory
> for each couple (name-type) of the format
> 
>   name[-type]-latest.jar
> 
> which points to the latest release for that (name,type) couple.
> 
> Comments?
> 
> --
> Stefano Mazzocchi      One must still have chaos in oneself to be
>                           able to give birth to a dancing star.
> <stefano@apache.org>                             Friedrich Nietzsche

Mime
View raw message