struts-archetype-blank/README.txt

Struts Archetypes - Blank
================================

This directory contains the Struts Blank Archetype for Maven 2.

To use the archetype to create a blank project:

   $ cd ~/projects
   $ mvn archetype:create                                    \
         -DarchetypeGroupId=org.apache.struts                \
         -DarchetypeArtifactId=struts-archetype-blank        \
         -DarchetypeVersion=<version>                        \
         -DgroupId=com.example                               \
         -DpackageName=com.example.projectname               \
         -DartifactId=my-webapp

         If <version> ends in -SNAPSHOT, use the snapshot repo:
         -DremoteRepositories=http://people.apache.org/maven-snapshot-repository
         
To build your new webapp:

   $ cd my-webapp
   $ mvn install


To start run the new webapp inplace via Jetty plugin:

   $ mvn jetty:run

 Browse to http://localhost:8080/my-webapp/


To start Tomcat and deploy your new webapp:

  Modify pom.xml to provide the path to a local Tomcat 5.x installation:
       <plugin>
         <groupId>org.codehaus.cargo</groupId>
         <artifactId>cargo-maven2-plugin</artifactId>
         ...
               <home>c:/java/apache-tomcat-5.5.17</home>

  $ mvn package cargo:start

(Optional) To build and install the archetype in your local repository:

   $ svn co http://svn.apache.org/repos/asf/struts/maven/trunk/struts-archetype-blank
   $ cd struts-archetype-blank
   $ mvn install