HOWTO RELEASE COCOON 3
----------------------
* check your workstation's settings as described at http://cocoon.apache.org/1199_1_1.html (step 1)

* rename trunk/release.pom.xml to trunk/pom.xml
* comment modules section in parent/pom.xml
* set all versions in the generated pom.xml files of all archetypes
 
* mvn release:perform -Darguments="-Dgpg.passphrase='[secret passphrase]' -P release" -P release
  (-> from the root directory!)
 
* tag all modules manually (should write some script for that purpose)
* set all versions in the genreated pom.xml files of all archetypes back to SNAPSHOT
* update <parent> sections of unreleased modules (cocoon-docs, cocoon-sample-webapp)
* rename /pom.xml to release.pom.xml
 
HOWTO TEST A COCOON 3 RELEASE
-----------------------------
* use the new artifacts in projects that depend on previous or SNAPSHOT versions. Add the Cocoon staging repository to your ~/.m2/settings.xml

* run all archetypes:
mvn archetype:create -DarchetypeGroupId=org.apache.cocoon.archetype-sample -DarchetypeArtifactId=cocoon-archetype-sample -DarchetypeVersion=3.0.0 -DgroupId=com.mycompany -DartifactId=mysample

mvn archetype:create -DarchetypeGroupId=org.apache.cocoon.archetype-block -DarchetypeArtifactId=cocoon-archetype-block -DarchetypeVersion=3.0.0 -DgroupId=com.mycompany -DartifactId=mysite

mvn archetype:create -DarchetypeGroupId=org.apache.cocoon.archetype-parent -DarchetypeArtifactId=cocoon-archetype-parent -DarchetypeVersion=3.0.0 -DgroupId=com.mycompany -DartifactId=myparent

mvn archetype:create -DarchetypeGroupId=org.apache.cocoon.archetype-webapp -DarchetypeArtifactId=cocoon-archetype-webapp -DarchetypeVersion=3.0.0 -DgroupId=com.mycompany -DartifactId=mywebapp

* check GPG, MD5 and SHA1 files

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <profiles>
    <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>
</settings>

and use it: e.g. mvn install -P cocoon-staging