----- Original Message -----
From: "Craig R. McClanahan" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Monday, February 26, 2001 1:10 AM
Subject: [PROPOSAL] Struts Source Directory Structure
> Based on the proposal to include unit tests in Struts, there is a desire
> to revise the organization of the source repository. Here is a summary
> of my understanding of the most recent proposal, plus some enhancements
> to be complete, with annotations on the contents of each directory.
>
> jakarta-struts/
>
> build/ Build scripts and batch files
+1
>
> conf/ Config files for components
> share/ Config files for struts.jar
> unit/ Config files for unit tests
>
+1
> doc/ Source documentation files
> xdocs/ XML input docs and stylesheets
+1
>
> lib/ JAR files of dependent packages
> (if we agree to include any)
>
-1 You have all convinced me that we should leave these outside struts and
have environment variables to point at them. However, they will be part of
the SDK or nightly build (or both). So, no lib/ directory. The list of
external dependencies are (to my knowledge) :
- Ant (build process)
- Stylebook (for generating the documentation/web site)
- An XSL processor compatible with Stylebook (Xalan)
- An XML parser compatible with Ant + Stylebook (Xerces, ...)
- Servletapi (or any Servlet engine servlet API jar)
- JUnit (unit tests)
- J2EEUnit (unit tests)
- As many servlet engine home directories as possible (ex: TOMCAT_HOME_31,
TOMCAT_HOME_40, RESIN_HOME_12, ...). These will be used to exercise the
J2EEUnit tests for Struts. There will be an automated build-test-all script
to start the tests on each of the servlet engines for whose an environment
variable is defined. If it is not defined then the tests will be skipped.
These variables can also be used to automatically deploy the generated
struts webapps to the servlet engine.
Am I missing something ?
> src/ Java sources for components
> example/ Sources for example webapp
> share/ Sources for struts.jar
> test/ Sources for test webapp
> unit/ Sources for unit tests
> upload/ Sources for upload webapp
+1
>
> target/ Output of "build" processes
> -- no files in CVS repository
> dist/ "build dist" output (i.e. the
> current nightly distribution)
> sdk/ "build sdk" output (i.e. the
> proposed Struts Dev. Kit)
> unit/ Output of unit test runs
>
+1
> web/ Webapp sources for components
> blank/ Web files for blank webapp
> example/ Web files for example webapp
> template/ Web files for template webapp
> test/ Web files for test webapp
> upload/ Web files for upload webapp
>
+1
>
> Comments?
>
> Craig
>
Vincent
