How to test? (was: [vote] Release Cocoon 3.0.0-alpha-2)

[Reinhard Pötz]

(Note: Those instructions require the usage of Maven 2. If you want to
use/test Cocoon without Maven, pls let me know.)

If you already use Cocoon 3 the best way to test is setting the version
to 3.0.0-alpha-2, e.g.:

<dependency>
  <groupId>org.apache.cocoon.sax</groupId>
  <artifactId>cocoon-sax</artifactId>
  <version>3.0.0-alpha-2</version>
</dependency>


If you want to explore how a Cocoon 3 web application works, use the
'Samples Archetype':

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create
-DarchetypeGroupId=org.apache.cocoon.archetype-sample
-DarchetypeArtifactId=cocoon-archetype-sample
-DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany
-DartifactId=mysample
-DremoteRepositories=http://people.apache.org/builds/cocoon/

Then move into the base directory and run

mvn jetty:run -P cocoon-staging

Make sure that the 'cocoon-staging' profile is set in your
~/.m2/settings.xml:

    <profile>
      <id>cocoon-staging</id>
      <repositories>
        <repository>
          <id>cocoon.staging</id>
          <name>Cocoon staging repository</name>
          <url>http://people.apache.org/builds/cocoon</url>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>cocoon.staging</id>
          <name>Cocoon staging repository</name>
          <url>http://people.apache.org/builds/cocoon</url>
        </pluginRepository>
      </pluginRepositories>
    </profile>



In order to start a new Cocoon 3 webapp project, use one of the
following archetypes:

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create
-DarchetypeGroupId=org.apache.cocoon.archetype-block
-DarchetypeArtifactId=cocoon-archetype-block
-DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany
-DartifactId=mysite
-DremoteRepositories=http://people.apache.org/builds/cocoon/

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create
-DarchetypeGroupId=org.apache.cocoon.archetype-parent
-DarchetypeArtifactId=cocoon-archetype-parent
-DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany
-DartifactId=myparent
-DremoteRepositories=http://people.apache.org/builds/cocoon/

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create
-DarchetypeGroupId=org.apache.cocoon.archetype-webapp
-DarchetypeArtifactId=cocoon-archetype-webapp
-DarchetypeVersion=3.0.0-alpha-2 -DgroupId=com.mycompany
-DartifactId=mywebapp
-DremoteRepositories=http://people.apache.org/builds/cocoon/

Again, make sure that you activate the 'cocoon-staging' profile when you
build your project.

One final note, all Cocoon artifacts require Maven 2.0.9 or higher.
Otherwise the transitive dependency resolution of Maven doesn't work
properly.

-- 
Reinhard Pötz                           Managing Director, {Indoqa} GmbH
                         http://www.indoqa.com/en/people/reinhard.poetz/

Member of the Apache Software Foundation
Apache Cocoon Committer, PMC member                  reinh...@apache.org
________________________________________________________________________