Jon,
> From: Jon Stevens [mailto:[EMAIL PROTECTED]]
>
> I disagree. Documentation == website. All of the documentation
> for a product
> should be available on the website. The reason is simple...we are creating
> open source. Documentation is lacking in general as well as people to
> maintain it. So, whatever we have, we should make it readily accessible.
>
I think I would see that as website >= Documentation. There is stuff that I
want on the web
(Call for Ant 2 requirements & news, for example) that I don't think is
appropriate in the documentaion that ships with the build.
Additionally, in Ant, we don't have the generated API docs in CVS (or the
web site), which we do have in the distributions.
Perhaps your suggestion of docs/site is the way to go. I'll think about that
for Ant.
> > build directory
> > ================
> > Many of the Jakarta projects put the build files in the project's root
> > directory and use the build directory for build results, such as build
> > classes which will be jarred up into the distribution
>
> Right and we are saying it should be "dist/classes" for that directory.
But classes are not part of the "dist" image, if you know what I mean. If
you look at this message,
http://marc.theaimsgroup.com/?l=ant-dev&m=98018389428408&w=2, you will see
that some others also view dist as an image of the binary distribution and
build as a build area. The idea is to be able to use this dist in-situ as
you are developing (by setting ANT_HOME, in the case of Ant).
Personally, I can live with dist not being a distribution image but I was
just reflecting what I thought was the current common practice. If it is not
the common view, then I would certainly try to move Ant into line.
>
> > build/lib
> > ==========
> > If this is a non-binding recommendation, I don't see why it supports two
> > locations to put the binary jars. It should either be lib or build/lib,
> > IMHO.
>
> The reason is to allow easy *.jar separation of files needed for building
> and files need for running. For example, I do not need ant.jar to run
> Velocity.
Ok, that is clear now. I think this page should make that distinction clear
(yes, I will change the XML :-))
>
> Personally, I like bin/classes. :-) Compromise is a bitch eh? :-)
Indeed.
>
> > Other
> > ======
I'll make some changes to the XML tonight to cover the structure of the
generated distribution (wherever it may end up living) :-)
Conor
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
