----- Original Message -----
From: "Peter Donald" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>
Sent: Sunday, April 29, 2001 1:16 AM
Subject: Re: Common "ant dist" Behavior
> At 04:55 28/4/01 -0700, Craig R. McClanahan wrote:
> >(1) "ant dist" Output Directory:
> >
> > Suggestion:
> > ${commons.home}/${package}/build
> >
> > Reasoning:
> > - All current packages (except Cactus) do this already
>
> I have said this before but ... a lot of projects outside commons use
> "build" for an intermediate directory and "dist" for distribution
> directory. Other projects (turbine et al) use build to contain build
> related scripts etc. So why not flip to dist???
+1 for dist
>
> >(2) Binary Distribution Contents
> >
> > The "ant dist" target for a package should ensure that all of the
> > following contents are placed in the output directory:
> >
> > Suggestion:
> > LICENSE Copy of Apache License
> > README README with dependencies, etc.
> > commons-xxxxx.jar Package JAR (no version number)
> > javadoc/ Package Javadocs
>
> how about docs/api and then any extra documentation required by component
> sits in docs/. This conforms to what a lot of projects do and also matches
> jdk.
>
+1
> > Reasoning for "No Version Number":
> > - Allows build.xml files that use these JARs to define properties
> >
(commons-beanutils.jar=${commons-beanutils.home}/commons-beanutils.jar)
> > without worrying about version numbers
> > - We're going to maintain API stability, right? :-)
> > - Versioning information should be included in the MANIFEST.MF
> > file inside the JAR anyway, so it's redundant in the filename
>
> I agree that no version number is nice while building from CVS but for
> "real" releases it is very useful to be able to see versions of different
> components at a glance. Perhaps when creating a dist for public you can
set
> a flag or some such to modify this. Usually this is done anyway (see ant's
> own build file for example).
>
> For instance in normal building circumstances ant builds a distribution to
> "dist/". Then when it hits "real" distribution mode it will build to
> "jakarta-ant-1.4/". This is so that the correct directory is included in
> zip etc.
>
> Cheers,
>
> Pete
>
> *-----------------------------------------------------*
> | "Faced with the choice between changing one's mind, |
> | and proving that there is no need to do so - almost |
> | everyone gets busy on the proof." |
> | - John Kenneth Galbraith |
> *-----------------------------------------------------*
>
>
