On Mon, May 24, 2010 at 3:00 AM, Simon Nash <[email protected]> wrote: > I've started a new thread for this discussion so as not to pollute > the vote thread. > >> - There should be a travel sample source distribution that has no >> binaries or third party dependencies included. > >> > The travel sample distribution packaging was discussed on threads [1] > and [2]. > > The third-party binaries are included because the travel sample has > an ant build as well as a maven build. If these binaries weren't > included, it would be necessary for people running the ant build to > manually download these dependencies and set the following environment > variables to point to their locations: > JUNIT_JAR > OPENEJB_HOME > JAXWS_HOME (if building or running on JDK 5) > > In the previous dev list discussion the need for users to do these > prereq downloads and set environment variables was felt to be a > significant inconvenience, so the packaging was changed to include > these files within the travel sample distribution (see [3] and [4]). > The only prereq download that's needed is the Tuscany SCA Java > binary distribution. > >> In a minor note, having >> the BUILDING, CHANGES, LICENSE, NOTICE, README and RELEASE_NOTES on >> the root of the travel sample might make things simpler to generate >> the source distribution and also for users starting from the tag or >> project root. > >> > > The BUILDING, CHANGES, LICENSE, NOTICE, README and RELEASE_NOTES > are already in the root directory of the travel sample distribution, > so I'm not sure what you are suggesting. The packaging is as follows: > > tuscany-scatours-1.0 > BUILDING > CHANGES > LICENSE > NOTICE > README > RELEASE_NOTES > travelsample > ...source for the travel sample... > lib > ...third-party binary dependencies... > >> - The binary distribution could then handle the binary portions of >> the travel sample with the necessary binaries (maybe non-tuscany >> dependencies) to run the application. The current distribution seems >> to be more aligned as a binary distribution, rather then a source >> distribution. > >> > The travel sample was previously built as separate source and binary > distributions. However, from the previous dev list discussion (see [2]) > it was felt that there was little value in providing a binary-only > distribution as the value of this sample to users was in seeing the > source and building it rather than just running it. > > The RC1 distribution is a source distribution of the travel sample > that also includes a minimum set of third-party binaries needed to > build and run the travel sample using ant. The travel sample source > and the third-party binaries are clearly separated from each other > by putting them into different top-level directories in the distribution > ("travelsample" for the source code and "lib" for the dependencies). > > It would be possible to split the "travelsample" and "lib" portions into > separate downloads, something like apache-tuscany-scatours-src-1.0.tar.gz > and apache-tuscany-scatours-dependencies.tar.gz. This seems more > complicated for users because they wouldn't have a simple "download > and go" solution but would first need to understand whether they need > one or both of these downloads and how to combine them correctly if > they need both of them. > > Simon > > [1] http://www.mail-archive.com/[email protected]/msg11512.html > [2] http://www.mail-archive.com/[email protected]/msg11997.html > [3] http://www.mail-archive.com/[email protected]/msg11519.html > [4] http://www.mail-archive.com/[email protected]/msg11545.html >
It looks like I missed the details of the packaging discussion, and thanks for the clarification. I'd be +1 for the release once the unix/mac os build issues are resolved. -- Luciano Resende http://people.apache.org/~lresende http://twitter.com/lresende1975 http://lresende.blogspot.com/
