svn commit: r1027825 - /wicket/common/site/trunk/contribute/release.md

[jr...@apache.org]

Author: jrthomerson
Date: Wed Oct 27 06:19:28 2010
New Revision: 1027825

URL: http://svn.apache.org/viewvc?rev=1027825&view=rev
Log:
updates to release documentation for 1.4.x

Modified:
    wicket/common/site/trunk/contribute/release.md

Modified: wicket/common/site/trunk/contribute/release.md
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/contribute/release.md?rev=1027825&r1=1027824&r2=1027825&view=diff
==============================================================================
--- wicket/common/site/trunk/contribute/release.md (original)
+++ wicket/common/site/trunk/contribute/release.md Wed Oct 27 06:19:28 2010
@@ -16,37 +16,48 @@ title: Build a release
 
 ### Building the release ###
 
-* query dev@ for any open issues, it helps to look at JIRA first
-* create tag, create release branch
-* check out release branch
+* Ask the dev@ mailing list if there are any issues that still need to be in the release (looking at JIRA is a good start)
+* Assuming there are none, and you are now in build mode, update the CHANGELOG-1.4 file 
+ * you can use JIRA for this list: go to "releases", and under "unreleased", next to your version, there's a release notes link
+* create a release branch to do your release work in (modifying poms, etc)
+ * then checkout that release branch and cd into it
+{% highlight console %}
+$ svn cp https://svn.apache.org/repos/asf/wicket/branches/wicket-1.4.x https://svn.apache.org/repos/asf/wicket/branches/wicket-1.4.13 -m "creating 1.4.13 release branch"
+Committed revision 1027818.
+$ cd ..
+$ svn co https://svn.apache.org/repos/asf/wicket/branches/wicket-1.4.13
+É lots of output É
+Checked out revision 1027818.
+$ cd wicket-1.4.13
+{% endhighlight %}
 * Set correct version in the pom files
-* Linux
+    * Linux
 {% highlight console %}
-find . -name "pom.xml" | xargs sed -i -e "s/1.4-SNAPSHOT/1.4-m1/g"
-find . -name "pom.xml" | xargs sed -i -e "s/wicket\/trunk/wicket\/releases\/wicket-1.4-m1/g"
+find . -name "pom.xml" | xargs sed -i -e "s/1.4-SNAPSHOT/1.4.13/g"
+find . -name "pom.xml" | xargs sed -i -e "s/wicket\/trunk/wicket\/releases\/wicket-1.4.13/g"
 {% endhighlight %}
-* Mac OS X
+    * Mac OS X
 {% highlight console %}
-find . -name "pom.xml" | xargs sed -i "" -e "s/1.4-SNAPSHOT/1.4-m1/g"
-find . -name "pom.xml" | xargs sed -i "" -e "s/wicket\/trunk/wicket\/releases\/wicket-1.4-m1/g"
-{% endhighlight %}
-* add JIRA generated release notes to CHANGELOG-1.4
-* commit to release branch
-* call release.sh (see note)
-* test the distribution (examples, rat, etc)
-* upload m2-repo and dist directory from target/ to p.a.o (see below)
-* upload commons/KEY into dist folder on p.a.o
-* send vote message
-* wait
-* upload to mirrors (see below)
-* release the version in JIRA
-* wait 24 hours for mirrors to pick them up
-* announce
+find . -name "pom.xml" | xargs sed -i "" -e "s/1.4-SNAPSHOT/1.4.13/g"
+find . -name "pom.xml" | xargs sed -i "" -e "s/wicket\/trunk/wicket\/releases\/wicket-1.4.13/g"
+{% endhighlight %}
+* Commit these modified pom files to the release branch
+* Call release.sh (still from the checkout out release branch code)
+    * NOTE: If you get an error while generating javadocs like "`java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl`", run a `mvn clean install -Dmaven.test.skip=true` followed by a `mvn javadoc:jar`, then re-run `release.sh`.
+* Test the distribution (examples, rat, etc)
+* Upload artifacts (including signing keys) to your people.apache.org account:
+{% highlight console %}
+svn export http://svn.apache.org/repos/asf/wicket/common/KEYS target/dist/KEYS
+ssh people.apache.org mkdir public_html/wicket-1.4.13
+scp -r target/dist target/m2-repo people.apache.org:public_html/wicket-1.4.13
+{% endhighlight %}
+* Send vote message to dev@ mailing list
+* Wait requisite 72 hours for the vote to pass (we hope)
+* Upload to mirrors (see below)
+* Release the version in JIRA
+* Wait 24 hours for mirrors to pick them up
+* Announce (see below)
 
-NOTE: If you get an error while generating javadocs like the one that follows,
-run a `mvn clean install` followed by a `mvn javadoc:jar`, then re-run
-`release.sh`. Example of error: `java.lang.ClassCastException:
-com.sun.tools.javadoc.ClassDocImpl`
 
 <a name="release-1.3.x">&nbsp;</a>
 ## Releasing Apache Wicket 1.3.x ## { #release13 }