continuum-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From denn...@apache.org
Subject svn commit: r898083 - in /continuum/site/src/site: apt/development/building.apt apt/development/debugging.apt apt/development/release.apt apt/events.apt cwiki/confluence-template.txt resources/.htaccess
Date Mon, 11 Jan 2010 21:51:20 GMT
Author: dennisl
Date: Mon Jan 11 21:51:20 2010
New Revision: 898083

URL: http://svn.apache.org/viewvc?rev=898083&view=rev
Log:
Set EOL-style to Native.

Modified:
    continuum/site/src/site/apt/development/building.apt   (contents, props changed)
    continuum/site/src/site/apt/development/debugging.apt   (props changed)
    continuum/site/src/site/apt/development/release.apt   (contents, props changed)
    continuum/site/src/site/apt/events.apt   (props changed)
    continuum/site/src/site/cwiki/confluence-template.txt   (contents, props changed)
    continuum/site/src/site/resources/.htaccess   (props changed)

Modified: continuum/site/src/site/apt/development/building.apt
URL: http://svn.apache.org/viewvc/continuum/site/src/site/apt/development/building.apt?rev=898083&r1=898082&r2=898083&view=diff
==============================================================================
--- continuum/site/src/site/apt/development/building.apt (original)
+++ continuum/site/src/site/apt/development/building.apt Mon Jan 11 21:51:20 2010
@@ -1,103 +1,103 @@
- -------
- Building Continuum
- -------
- ------
- 2010-01-07
- ------
-
-Building Continuum
-
- This document will help you check out and build the Continuum source code.
-
-* Quick Start
-
-+--------+
-  svn co http://svn.apache.org/repos/asf/continuum/all continuum-all
-  cd /path/to/continuum-all/parent
-  mvn install
-  cd /path/to/continuum-all/continuum
-  mvn install
-+--------+
-
-  After a successful build, you will find the Continuum distributions in
-  <<<continuum-jetty/target>>> and the WAR file in <<<continuum-webapp/target>>>.
-
-* Maven
-
-  To build Continuum, you will need {{{http://maven.apache.org/}Apache Maven}}.
-  {{{http://maven.apache.org/download.html}Download}} and {{{http://maven.apache.org/download.html#Installation}
-  install}} the the latest stable version.
-
-* Subversion
-
-  The Continuum source code is stored in a {{{/source-repository.html}Subversion repository}}
hosted by The
-  Apache Software Foundation.  You will need a Subversion client in order to check out the
source code.  A list of
-  Subversion downloads and third-party clients is available on the {{{http://subversion.tigris.org/}Subversion}}
web
-  site.
-
-* All
-
-  In the Subversion repo, there is a convenience 'all' directory with an svn:externals definition
that allows you to check out
-  the trunk, parent POM and site all at once.  It will look empty when viewed in
-  your web browser, but checking it out with your Subversion client will bring down all
-  the code.
-
-  {{{http://svn.apache.org/repos/asf/continuum/all}
-  http://svn.apache.org/repos/asf/continuum/all}}
-
-* Trunk
-
-  The trunk of the Subversion repo has version 1.4.x, from which we're publishing
-  milestones.  You can find more information about planned features on the
-  {{{http://cwiki.apache.org/confluence/display/CONTINUUM/Continuum+Roadmap}Roadmap}}.
-  If you see something interesting, please join us on the {{{/mail-lists.html}dev list}}
to talk about it!
-
-  {{{http://svn.apache.org/repos/asf/continuum/trunk}
-  http://svn.apache.org/repos/asf/continuum/trunk}}
-
-* Parent
-
-  The Continuum parent POM contains configuration that is common to the entire
-  project.  It has a separate, less frequent release cycle than the distribution.
-
-  {{{http://svn.apache.org/repos/asf/continuum/parent/trunk}
-  http://svn.apache.org/repos/asf/continuum/parent/trunk}}
-
-* Site
-
-  The source for the top-level Continuum website (including this page) is in a
-  separate directory in Subversion.  It is published when changes are made, but
-  it is not tagged and "released".
-
-  {{{http://svn.apache.org/repos/asf/continuum/site}
-  http://svn.apache.org/repos/asf/continuum/site}}
-
-* Branches
-
-  We currently have one active release branch for 1.3.x bug fixes,
-  and several branches for ongoing work.  Generally there will be some discussion
-  on the dev list or a JIRA issue opened before a branch is created.
-
-  {{{http://svn.apache.org/repos/asf/continuum/branches}
-  http://svn.apache.org/repos/asf/continuum/branches}}
-
-* Sandbox
-
-  The sandbox is an area where committers are free to experiment.  No notice is
-  required to create something in the sandbox.
-
-  {{{http://svn.apache.org/repos/asf/continuum/sandbox}
-  http://svn.apache.org/repos/asf/continuum/sandbox}}
-
-* Tags
-
-  Tags for all past releases, test builds, and interesting points in time are
-  available.
-
-  {{{http://svn.apache.org/repos/asf/continuum/tags}
-  http://svn.apache.org/repos/asf/continuum/tags}}
-
-* Help
-
-  If you need help finding something or building it, please ask on the dev list
-  or on irc.
+ -------
+ Building Continuum
+ -------
+ ------
+ 2010-01-07
+ ------
+
+Building Continuum
+
+ This document will help you check out and build the Continuum source code.
+
+* Quick Start
+
++--------+
+  svn co http://svn.apache.org/repos/asf/continuum/all continuum-all
+  cd /path/to/continuum-all/parent
+  mvn install
+  cd /path/to/continuum-all/continuum
+  mvn install
++--------+
+
+  After a successful build, you will find the Continuum distributions in
+  <<<continuum-jetty/target>>> and the WAR file in <<<continuum-webapp/target>>>.
+
+* Maven
+
+  To build Continuum, you will need {{{http://maven.apache.org/}Apache Maven}}.
+  {{{http://maven.apache.org/download.html}Download}} and {{{http://maven.apache.org/download.html#Installation}
+  install}} the the latest stable version.
+
+* Subversion
+
+  The Continuum source code is stored in a {{{/source-repository.html}Subversion repository}}
hosted by The
+  Apache Software Foundation.  You will need a Subversion client in order to check out the
source code.  A list of
+  Subversion downloads and third-party clients is available on the {{{http://subversion.tigris.org/}Subversion}}
web
+  site.
+
+* All
+
+  In the Subversion repo, there is a convenience 'all' directory with an svn:externals definition
that allows you to check out
+  the trunk, parent POM and site all at once.  It will look empty when viewed in
+  your web browser, but checking it out with your Subversion client will bring down all
+  the code.
+
+  {{{http://svn.apache.org/repos/asf/continuum/all}
+  http://svn.apache.org/repos/asf/continuum/all}}
+
+* Trunk
+
+  The trunk of the Subversion repo has version 1.4.x, from which we're publishing
+  milestones.  You can find more information about planned features on the
+  {{{http://cwiki.apache.org/confluence/display/CONTINUUM/Continuum+Roadmap}Roadmap}}.
+  If you see something interesting, please join us on the {{{/mail-lists.html}dev list}}
to talk about it!
+
+  {{{http://svn.apache.org/repos/asf/continuum/trunk}
+  http://svn.apache.org/repos/asf/continuum/trunk}}
+
+* Parent
+
+  The Continuum parent POM contains configuration that is common to the entire
+  project.  It has a separate, less frequent release cycle than the distribution.
+
+  {{{http://svn.apache.org/repos/asf/continuum/parent/trunk}
+  http://svn.apache.org/repos/asf/continuum/parent/trunk}}
+
+* Site
+
+  The source for the top-level Continuum website (including this page) is in a
+  separate directory in Subversion.  It is published when changes are made, but
+  it is not tagged and "released".
+
+  {{{http://svn.apache.org/repos/asf/continuum/site}
+  http://svn.apache.org/repos/asf/continuum/site}}
+
+* Branches
+
+  We currently have one active release branch for 1.3.x bug fixes,
+  and several branches for ongoing work.  Generally there will be some discussion
+  on the dev list or a JIRA issue opened before a branch is created.
+
+  {{{http://svn.apache.org/repos/asf/continuum/branches}
+  http://svn.apache.org/repos/asf/continuum/branches}}
+
+* Sandbox
+
+  The sandbox is an area where committers are free to experiment.  No notice is
+  required to create something in the sandbox.
+
+  {{{http://svn.apache.org/repos/asf/continuum/sandbox}
+  http://svn.apache.org/repos/asf/continuum/sandbox}}
+
+* Tags
+
+  Tags for all past releases, test builds, and interesting points in time are
+  available.
+
+  {{{http://svn.apache.org/repos/asf/continuum/tags}
+  http://svn.apache.org/repos/asf/continuum/tags}}
+
+* Help
+
+  If you need help finding something or building it, please ask on the dev list
+  or on irc.

Propchange: continuum/site/src/site/apt/development/building.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: continuum/site/src/site/apt/development/debugging.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: continuum/site/src/site/apt/development/release.apt
URL: http://svn.apache.org/viewvc/continuum/site/src/site/apt/development/release.apt?rev=898083&r1=898082&r2=898083&view=diff
==============================================================================
--- continuum/site/src/site/apt/development/release.apt (original)
+++ continuum/site/src/site/apt/development/release.apt Mon Jan 11 21:51:20 2010
@@ -1,266 +1,266 @@
- ------
- Continuum Release Guidelines
- ------
-
-Continuum Release Guidelines
-
-
-    *  Continuum is versioned X.Y.Z -- Major.Minor.Build. The Major and Minor versions are
set at the beginning of a
-    series, after which we use sequential build numbers starting with .0. For example, 1.3.0,
1.3.1, 1.3.2.
-
-    * Ideally each version is tagged and built exactly once. The Release Manager (RM) has
discretion to re-build a
-    version if something goes wrong during the release process, but once a version has been
made available for public
-    download, that version number may not be re-used.
-
-    * During the vote, an additional qualifier is determined. For example: 1.3.0 (M1) or
1.3.7 (GA). Respectively,
-    these mean Milestone 1 and General Availability. Qualifiers such as Alpha and Beta are
also acceptable, as is RC
-    (Release Candidate).
-
-    * If the vote does not pass, the qualifier may be reused. For example, if 1.3.0 was meant
to be Milestone 1 but
-    does not get approved, 1.3.1 can become M1.
-
-    * When releases are announced to the community, the additional qualifier is used in addition
to the version number.
-    For example: [ANN] Continuum 1.3.3 (Milestone 2) Release or [ANN] Continuum 1.3.6 (GA)
Release
-
-    * A qualifier can be changed by calling a new vote. If we get to 1.3.8 (M5) and decide
that it has no problems and
-    there's nothing else we want to add, we can simply re-label it GA and update the website.
-
-    * New features may be added to 1.3.x releases until we reach GA, at which point only
minor changes should be made.
-
-    * If the vote does not pass, the binaries should be removed from the download area, and
the version should be
-    labeled "test build" on the release notes page.
-
-Continuum Release Preparation
-
- [[1]] Post to the dev list a few days before you plan to do a Continuum release
-
- [[2]] Check for SNAPSHOT dependencies, including the Continuum parent POM
-
- [[1]] Update <<<continuum-docs/src/site/xdoc/release-notes.xml>>>
-
-  * Copy and paste the html release notes from JIRA
-
-  * Add <<<\<h1\>>>> around the first line
-
-  []
-
- [[1]] Update the <<<site.xml>>> for version changes
-
- [[1]] Make sure that you have the "release" profile set in your <<<settings.xml>>>
as shown below.
-
-+-----+
-<profile>
-  <id>release</id>
-  <properties>
-    <gpg.passphrase>[GPG_PASS_PHRASE]</gpg.passphrase>
-  </properties>
-</profile>
-+-----+
-
- [[1]] Set your user credentials for the stage repo in the <<<<servers>>>>
section of your <<<settings.xml>>> file.
-
-Continuum Release Process
-
- By default, the release will be staged in <<<http://people.apache.org/builds/continuum/$\{version\}/staging-repo>>>.
- If you want to stage it elsewhere, set the <<<deploy.altRepository>>>
property in your <<<settings.xml>>> file.
-
- [[1]] Execute <<<mvn release:prepare>>> (check that it has been properly
tagged. The tag name must be <<<continuum-[VERSION]>>>)
-
- <<Note:>> SCM tag does not work with Subversion \> 1.5.1
-
-  * Use subversion 1.4.1 or
-
-  * After SCM tag fails with an error 'svn: File ... already exists',
-    do an svn update first then resume the release preparation from the SCM tag phase.
-
-+-----+
-svn up
-mvn release:prepare
-+-----+
-
-  []
-
- [[1]] Then execute <<<mvn release:perform>>>
-
- [[1]] ssh to <<<people.apache.org>>> and cd to <<</www/people.apache.org/builds/continuum/VERSION>>>.
 Execute the following commands to copy and rename the source and binary distributions.
-
-+-----+
-export VER=1.3.4
-
-find staging-repo -name "*.zip*"    -exec cp {} . \;
-find staging-repo -name "*.tar.gz*" -exec cp {} . \;
-find staging-repo -name "*.war*"    -exec cp {} . \;
-find . -name "*.asc.*" -exec rm {} \;
-
-mv continuum-$VER.zip apache-continuum-$VER-src.zip
-mv continuum-$VER.zip.md5 apache-continuum-$VER-src.zip.md5
-mv continuum-$VER.zip.sha1 apache-continuum-$VER-src.zip.sha1
-mv continuum-$VER.zip.asc apache-continuum-$VER-src.zip.asc
-
-mv continuum-jetty-$VER-bin.tar.gz apache-continuum-$VER-bin.tar.gz
-mv continuum-jetty-$VER-bin.tar.gz.md5 apache-continuum-$VER-bin.tar.gz.md5
-mv continuum-jetty-$VER-bin.tar.gz.sha1 apache-continuum-$VER-bin.tar.gz.sha1
-mv continuum-jetty-$VER-bin.tar.gz.asc apache-continuum-$VER-bin.tar.gz.asc
-
-mv continuum-jetty-$VER-bin.zip apache-continuum-$VER-bin.zip
-mv continuum-jetty-$VER-bin.zip.md5 apache-continuum-$VER-bin.zip.md5
-mv continuum-jetty-$VER-bin.zip.sha1 apache-continuum-$VER-bin.zip.sha1
-mv continuum-jetty-$VER-bin.zip.asc apache-continuum-$VER-bin.zip.asc
-
-mv continuum-webapp-$VER.war apache-continuum-$VER.war
-mv continuum-webapp-$VER.war.asc apache-continuum-$VER.war.asc
-mv continuum-webapp-$VER.war.md5 apache-continuum-$VER.war.md5
-mv continuum-webapp-$VER.war.sha1 apache-continuum-$VER.war.sha1
-
-mv continuum-buildagent-jetty-$VER-bin.tar.gz apache-continuum-buildagent-$VER-bin.tar.gz
-mv continuum-buildagent-jetty-$VER-bin.tar.gz.md5 apache-continuum-buildagent-$VER-bin.tar.gz.md5
-mv continuum-buildagent-jetty-$VER-bin.tar.gz.sha1 apache-continuum-buildagent-$VER-bin.tar.gz.sha1
-mv continuum-buildagent-jetty-$VER-bin.tar.gz.asc apache-continuum-buildagent-$VER-bin.tar.gz.asc
-
-mv continuum-buildagent-jetty-$VER-bin.zip apache-continuum-buildagent-$VER-bin.zip
-mv continuum-buildagent-jetty-$VER-bin.zip.md5 apache-continuum-buildagent-$VER-bin.zip.md5
-mv continuum-buildagent-jetty-$VER-bin.zip.sha1 apache-continuum-buildagent-$VER-bin.zip.sha1
-mv continuum-buildagent-jetty-$VER-bin.zip.asc apache-continuum-buildagent-$VER-bin.zip.asc
-
-mv continuum-buildagent-webapp-$VER.war apache-continuum-buildagent-$VER.war
-mv continuum-buildagent-webapp-$VER.war.asc apache-continuum-buildagent-$VER.war.asc
-mv continuum-buildagent-webapp-$VER.war.md5 apache-continuum-buildagent-$VER.war.md5
-mv continuum-buildagent-webapp-$VER.war.sha1 apache-continuum-buildagent-$VER.war.sha1
-
-mv continuum-buildagent-$VER.zip apache-continuum-buildagent-$VER-src.zip
-mv continuum-buildagent-$VER.zip.md5 apache-continuum-buildagent-$VER-src.zip.md5
-mv continuum-buildagent-$VER.zip.sha1 apache-continuum-buildagent-$VER-src.zip.sha1
-mv continuum-buildagent-$VER.zip.asc apache-continuum-buildagent-$VER-src.zip.asc
-
-script available with
-svn cat https://svn.apache.org/repos/asf/continuum/trunk/release-script.sh > release-script.sh
-+-----+
-
-~~  TODO:  copy and rename in one pass?
-
- [[1]] Stage the site <<<mvn site:stage-deploy -DstagingSiteURL=scp://people.apache.org/home/USERID/public_html/staging-sites/continuum/1.3.4>>>
from the release tag or <<<target/checkout>>> directory
-
- [[1]] Call for a vote in the dev list and wait for 72 hours for the vote results. 3 binding
votes from PMC members are necessary for the release to be finalized. <<{{{http://markmail.org/message/dhgdoz6aht6w5frl}Example}}>>
-
- [[1]] After the vote has passed, copy the sources and binaries from <<<people.apache.org>>>
to <<</www/www.apache.org/dist/continuum>>>.
-
- [[1]] To sync the JARs to the central repository, execute:
-
-+-----+
-mvn stage:copy -Dsource="[STAGE_REPO_URL]"
-     -Dtarget="scp://[APACHE_USERNAME]@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
-     -Dversion=1.3.4 -DrepositoryId=apache.releases
-+-----+
-
-    <<Note:>> Do not use Maven 2.0.9 because it has a bug when performing <<<mvn
stage:copy>>>
-
- [[1]] Execute fix permissions scripts. Login to <<<people.apache.org>>>
-
-+-----+
-/www/people.apache.org/repo/m2-snapshot-repository/fix-permissions.sh
-+-----+
-
- [[1]] Publish the docs with <<<mvn site-deploy>>> from the release tag
-
- [[1]] Update the Continuum site at <<<https://svn.apache.org/repos/asf/continuum/site/>>>
with the versions and release notes
- URL and run <<<mvn site-deploy>>>. Below is the list of pages that you
need to update:
-
-  * <<<src/site/xdoc/index.xml>>>
-
-  * <<<src/site/apt/known-issues.apt>>>
-
-  * <<<src/site/apt/versions.apt>>>
-
-  * <<<src/site/apt/download.apt>>>
-
-  * <<<src/site/apt/changelog.apt>>>
-
-  * <<<src/site/resources/.htaccess>>> - update
-  <<<Redirect Permanent /docs/current http://continuum.apache.org/docs/1.0.1/>>>
to the latest released GA version
-
-  []
-
- [[1]] Remove old versions from <<</www/www.apache.org/dist/continuum>>>
-
- [[1]] Publish the reference docs (<<<mvn site-deploy>>> from the release
tag.
- You may have to exclude the <<<continuum-webapp>>> module to do this,
and will require <<<MAVEN_OPTS=-Xmx256m>>>
-
- [[1]] Send out an announcement of the release
-
-Verifying a Release
-
- Download the uploaded files via wget:
-
-+-----+
- wget http://people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin.tar.gz
-+-----+
-
- Verify the signatures:
-
-+-----+
- gpg -v apache-continuum-1.3.4-bin.zip.asc
-+-----+
-
- Verify the checksums:
-
-+-----+
- md5sum apache-continuum-1.3.4-src.zip
- cat apache-continuum-1.3.4-src.zip.md5
-
- sha1sum apache-continuum-1.3.4-src.zip
- cat apache-continuum-1.3.4-src.zip.sha1
-+-----+
-
-Publishing a release
-
- Tally the vote and reply on the vote thread.  I prefer not to change the subject line as
it breaks threading in some clients.
-
- Copy the distribution files over to www.a.o/dist/continuum
-
-+-----+
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-src* /www/www.apache.org/dist/continuum/source/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-src* /www/www.apache.org/dist/continuum/source/
-+-----+
-
- Promote the staged repository contents
-
-+-----+
-mvn stage:copy -Dsource="http://people.apache.org/builds/continuum/1.3.4/staging-repo" \
--Dtarget="scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
\
--Dversion=1.3.4 \
--DtargetRepositoryId=apache.releases
-+-----+
-
- <<Note:>>  This copies <<everything>> in the staging repo, even
if you specify a version
-
- Update the <<<index.xml>>> and <<<downloads.apt>>> pages
on the main site
-
- Publish the versioned reference docs (<<<mvn site-deploy>>> from a checkout
of the tag)
-
- Publish the top-level website
-
- Announce the release on the dev and user lists
-
- Optionally announce on the Apache announcements list (only for major versions?)
-
- Remove old releases from www.a.o/dist (make sure to remove them from <<<downloads.apt>>>
or the links will be broken)
-
- Open a bottle of champagne ! :-)
-
-Releasing the parent POM
-
- Check out the source from <<<https://svn.apache.org/repos/asf/continuum/parent>>>
-
- * <<<mvn release:prepare>>> (verify that it has been properly tagged)
-
- * <<<mvn release:perform>>> (verify that it has been deployed correctly
in the staging repo)
-
- * Update the parent POM version in Continuum at <<<https://svn.apache.org/repos/asf/continuum/trunk>>>
(or in the branch)
-
- * Change the parent POM version to the <<<continuum-parent>>> version
that has just been released
-
- * Commit the changes made
+ ------
+ Continuum Release Guidelines
+ ------
+
+Continuum Release Guidelines
+
+
+    *  Continuum is versioned X.Y.Z -- Major.Minor.Build. The Major and Minor versions are
set at the beginning of a
+    series, after which we use sequential build numbers starting with .0. For example, 1.3.0,
1.3.1, 1.3.2.
+
+    * Ideally each version is tagged and built exactly once. The Release Manager (RM) has
discretion to re-build a
+    version if something goes wrong during the release process, but once a version has been
made available for public
+    download, that version number may not be re-used.
+
+    * During the vote, an additional qualifier is determined. For example: 1.3.0 (M1) or
1.3.7 (GA). Respectively,
+    these mean Milestone 1 and General Availability. Qualifiers such as Alpha and Beta are
also acceptable, as is RC
+    (Release Candidate).
+
+    * If the vote does not pass, the qualifier may be reused. For example, if 1.3.0 was meant
to be Milestone 1 but
+    does not get approved, 1.3.1 can become M1.
+
+    * When releases are announced to the community, the additional qualifier is used in addition
to the version number.
+    For example: [ANN] Continuum 1.3.3 (Milestone 2) Release or [ANN] Continuum 1.3.6 (GA)
Release
+
+    * A qualifier can be changed by calling a new vote. If we get to 1.3.8 (M5) and decide
that it has no problems and
+    there's nothing else we want to add, we can simply re-label it GA and update the website.
+
+    * New features may be added to 1.3.x releases until we reach GA, at which point only
minor changes should be made.
+
+    * If the vote does not pass, the binaries should be removed from the download area, and
the version should be
+    labeled "test build" on the release notes page.
+
+Continuum Release Preparation
+
+ [[1]] Post to the dev list a few days before you plan to do a Continuum release
+
+ [[2]] Check for SNAPSHOT dependencies, including the Continuum parent POM
+
+ [[1]] Update <<<continuum-docs/src/site/xdoc/release-notes.xml>>>
+
+  * Copy and paste the html release notes from JIRA
+
+  * Add <<<\<h1\>>>> around the first line
+
+  []
+
+ [[1]] Update the <<<site.xml>>> for version changes
+
+ [[1]] Make sure that you have the "release" profile set in your <<<settings.xml>>>
as shown below.
+
++-----+
+<profile>
+  <id>release</id>
+  <properties>
+    <gpg.passphrase>[GPG_PASS_PHRASE]</gpg.passphrase>
+  </properties>
+</profile>
++-----+
+
+ [[1]] Set your user credentials for the stage repo in the <<<<servers>>>>
section of your <<<settings.xml>>> file.
+
+Continuum Release Process
+
+ By default, the release will be staged in <<<http://people.apache.org/builds/continuum/$\{version\}/staging-repo>>>.
+ If you want to stage it elsewhere, set the <<<deploy.altRepository>>>
property in your <<<settings.xml>>> file.
+
+ [[1]] Execute <<<mvn release:prepare>>> (check that it has been properly
tagged. The tag name must be <<<continuum-[VERSION]>>>)
+
+ <<Note:>> SCM tag does not work with Subversion \> 1.5.1
+
+  * Use subversion 1.4.1 or
+
+  * After SCM tag fails with an error 'svn: File ... already exists',
+    do an svn update first then resume the release preparation from the SCM tag phase.
+
++-----+
+svn up
+mvn release:prepare
++-----+
+
+  []
+
+ [[1]] Then execute <<<mvn release:perform>>>
+
+ [[1]] ssh to <<<people.apache.org>>> and cd to <<</www/people.apache.org/builds/continuum/VERSION>>>.
 Execute the following commands to copy and rename the source and binary distributions.
+
++-----+
+export VER=1.3.4
+
+find staging-repo -name "*.zip*"    -exec cp {} . \;
+find staging-repo -name "*.tar.gz*" -exec cp {} . \;
+find staging-repo -name "*.war*"    -exec cp {} . \;
+find . -name "*.asc.*" -exec rm {} \;
+
+mv continuum-$VER.zip apache-continuum-$VER-src.zip
+mv continuum-$VER.zip.md5 apache-continuum-$VER-src.zip.md5
+mv continuum-$VER.zip.sha1 apache-continuum-$VER-src.zip.sha1
+mv continuum-$VER.zip.asc apache-continuum-$VER-src.zip.asc
+
+mv continuum-jetty-$VER-bin.tar.gz apache-continuum-$VER-bin.tar.gz
+mv continuum-jetty-$VER-bin.tar.gz.md5 apache-continuum-$VER-bin.tar.gz.md5
+mv continuum-jetty-$VER-bin.tar.gz.sha1 apache-continuum-$VER-bin.tar.gz.sha1
+mv continuum-jetty-$VER-bin.tar.gz.asc apache-continuum-$VER-bin.tar.gz.asc
+
+mv continuum-jetty-$VER-bin.zip apache-continuum-$VER-bin.zip
+mv continuum-jetty-$VER-bin.zip.md5 apache-continuum-$VER-bin.zip.md5
+mv continuum-jetty-$VER-bin.zip.sha1 apache-continuum-$VER-bin.zip.sha1
+mv continuum-jetty-$VER-bin.zip.asc apache-continuum-$VER-bin.zip.asc
+
+mv continuum-webapp-$VER.war apache-continuum-$VER.war
+mv continuum-webapp-$VER.war.asc apache-continuum-$VER.war.asc
+mv continuum-webapp-$VER.war.md5 apache-continuum-$VER.war.md5
+mv continuum-webapp-$VER.war.sha1 apache-continuum-$VER.war.sha1
+
+mv continuum-buildagent-jetty-$VER-bin.tar.gz apache-continuum-buildagent-$VER-bin.tar.gz
+mv continuum-buildagent-jetty-$VER-bin.tar.gz.md5 apache-continuum-buildagent-$VER-bin.tar.gz.md5
+mv continuum-buildagent-jetty-$VER-bin.tar.gz.sha1 apache-continuum-buildagent-$VER-bin.tar.gz.sha1
+mv continuum-buildagent-jetty-$VER-bin.tar.gz.asc apache-continuum-buildagent-$VER-bin.tar.gz.asc
+
+mv continuum-buildagent-jetty-$VER-bin.zip apache-continuum-buildagent-$VER-bin.zip
+mv continuum-buildagent-jetty-$VER-bin.zip.md5 apache-continuum-buildagent-$VER-bin.zip.md5
+mv continuum-buildagent-jetty-$VER-bin.zip.sha1 apache-continuum-buildagent-$VER-bin.zip.sha1
+mv continuum-buildagent-jetty-$VER-bin.zip.asc apache-continuum-buildagent-$VER-bin.zip.asc
+
+mv continuum-buildagent-webapp-$VER.war apache-continuum-buildagent-$VER.war
+mv continuum-buildagent-webapp-$VER.war.asc apache-continuum-buildagent-$VER.war.asc
+mv continuum-buildagent-webapp-$VER.war.md5 apache-continuum-buildagent-$VER.war.md5
+mv continuum-buildagent-webapp-$VER.war.sha1 apache-continuum-buildagent-$VER.war.sha1
+
+mv continuum-buildagent-$VER.zip apache-continuum-buildagent-$VER-src.zip
+mv continuum-buildagent-$VER.zip.md5 apache-continuum-buildagent-$VER-src.zip.md5
+mv continuum-buildagent-$VER.zip.sha1 apache-continuum-buildagent-$VER-src.zip.sha1
+mv continuum-buildagent-$VER.zip.asc apache-continuum-buildagent-$VER-src.zip.asc
+
+script available with
+svn cat https://svn.apache.org/repos/asf/continuum/trunk/release-script.sh > release-script.sh
++-----+
+
+~~  TODO:  copy and rename in one pass?
+
+ [[1]] Stage the site <<<mvn site:stage-deploy -DstagingSiteURL=scp://people.apache.org/home/USERID/public_html/staging-sites/continuum/1.3.4>>>
from the release tag or <<<target/checkout>>> directory
+
+ [[1]] Call for a vote in the dev list and wait for 72 hours for the vote results. 3 binding
votes from PMC members are necessary for the release to be finalized. <<{{{http://markmail.org/message/dhgdoz6aht6w5frl}Example}}>>
+
+ [[1]] After the vote has passed, copy the sources and binaries from <<<people.apache.org>>>
to <<</www/www.apache.org/dist/continuum>>>.
+
+ [[1]] To sync the JARs to the central repository, execute:
+
++-----+
+mvn stage:copy -Dsource="[STAGE_REPO_URL]"
+     -Dtarget="scp://[APACHE_USERNAME]@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
+     -Dversion=1.3.4 -DrepositoryId=apache.releases
++-----+
+
+    <<Note:>> Do not use Maven 2.0.9 because it has a bug when performing <<<mvn
stage:copy>>>
+
+ [[1]] Execute fix permissions scripts. Login to <<<people.apache.org>>>
+
++-----+
+/www/people.apache.org/repo/m2-snapshot-repository/fix-permissions.sh
++-----+
+
+ [[1]] Publish the docs with <<<mvn site-deploy>>> from the release tag
+
+ [[1]] Update the Continuum site at <<<https://svn.apache.org/repos/asf/continuum/site/>>>
with the versions and release notes
+ URL and run <<<mvn site-deploy>>>. Below is the list of pages that you
need to update:
+
+  * <<<src/site/xdoc/index.xml>>>
+
+  * <<<src/site/apt/known-issues.apt>>>
+
+  * <<<src/site/apt/versions.apt>>>
+
+  * <<<src/site/apt/download.apt>>>
+
+  * <<<src/site/apt/changelog.apt>>>
+
+  * <<<src/site/resources/.htaccess>>> - update
+  <<<Redirect Permanent /docs/current http://continuum.apache.org/docs/1.0.1/>>>
to the latest released GA version
+
+  []
+
+ [[1]] Remove old versions from <<</www/www.apache.org/dist/continuum>>>
+
+ [[1]] Publish the reference docs (<<<mvn site-deploy>>> from the release
tag.
+ You may have to exclude the <<<continuum-webapp>>> module to do this,
and will require <<<MAVEN_OPTS=-Xmx256m>>>
+
+ [[1]] Send out an announcement of the release
+
+Verifying a Release
+
+ Download the uploaded files via wget:
+
++-----+
+ wget http://people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin.tar.gz
++-----+
+
+ Verify the signatures:
+
++-----+
+ gpg -v apache-continuum-1.3.4-bin.zip.asc
++-----+
+
+ Verify the checksums:
+
++-----+
+ md5sum apache-continuum-1.3.4-src.zip
+ cat apache-continuum-1.3.4-src.zip.md5
+
+ sha1sum apache-continuum-1.3.4-src.zip
+ cat apache-continuum-1.3.4-src.zip.sha1
++-----+
+
+Publishing a release
+
+ Tally the vote and reply on the vote thread.  I prefer not to change the subject line as
it breaks threading in some clients.
+
+ Copy the distribution files over to www.a.o/dist/continuum
+
++-----+
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-src* /www/www.apache.org/dist/continuum/source/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-src* /www/www.apache.org/dist/continuum/source/
++-----+
+
+ Promote the staged repository contents
+
++-----+
+mvn stage:copy -Dsource="http://people.apache.org/builds/continuum/1.3.4/staging-repo" \
+-Dtarget="scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
\
+-Dversion=1.3.4 \
+-DtargetRepositoryId=apache.releases
++-----+
+
+ <<Note:>>  This copies <<everything>> in the staging repo, even
if you specify a version
+
+ Update the <<<index.xml>>> and <<<downloads.apt>>> pages
on the main site
+
+ Publish the versioned reference docs (<<<mvn site-deploy>>> from a checkout
of the tag)
+
+ Publish the top-level website
+
+ Announce the release on the dev and user lists
+
+ Optionally announce on the Apache announcements list (only for major versions?)
+
+ Remove old releases from www.a.o/dist (make sure to remove them from <<<downloads.apt>>>
or the links will be broken)
+
+ Open a bottle of champagne ! :-)
+
+Releasing the parent POM
+
+ Check out the source from <<<https://svn.apache.org/repos/asf/continuum/parent>>>
+
+ * <<<mvn release:prepare>>> (verify that it has been properly tagged)
+
+ * <<<mvn release:perform>>> (verify that it has been deployed correctly
in the staging repo)
+
+ * Update the parent POM version in Continuum at <<<https://svn.apache.org/repos/asf/continuum/trunk>>>
(or in the branch)
+
+ * Change the parent POM version to the <<<continuum-parent>>> version
that has just been released
+
+ * Commit the changes made

Propchange: continuum/site/src/site/apt/development/release.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: continuum/site/src/site/apt/events.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: continuum/site/src/site/cwiki/confluence-template.txt
URL: http://svn.apache.org/viewvc/continuum/site/src/site/cwiki/confluence-template.txt?rev=898083&r1=898082&r2=898083&view=diff
==============================================================================
--- continuum/site/src/site/cwiki/confluence-template.txt (original)
+++ continuum/site/src/site/cwiki/confluence-template.txt Mon Jan 11 21:51:20 2010
@@ -1,94 +1,94 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!--
-
-    Licensed to the Apache Software Foundation (ASF) under one or more
-    contributor license agreements.  See the NOTICE file distributed with
-    this work for additional information regarding copyright ownership.
-    The ASF licenses this file to You under the Apache License, Version 2.0
-    (the "License"); you may not use this file except in compliance with
-    the License.  You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
--->
-<html>
-  <head>
-    <title>$page.title</title>
-
-<!-- TODO: need some of these styles, not all
-    <link type="text/css" rel="stylesheet" href="$stylesheet" />
--->
-    <style type="text/css" media="all">
-      @import url("http://maven.apache.org/scm/css/maven-base.css");
-      @import url("http://maven.apache.org/scm/css/maven-theme.css");
-      @import url("http://maven.apache.org/scm/css/site.css");
-      #leftColumn {
-       display: none !important
-      }
-      #bodyColumn {
-        margin-left: 1.5em;
-      }
-    </style>
-    <link rel="stylesheet" href="http://maven.apache.org/scm/css/print.css" type="text/css"
media="print" />
-        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-  </head>
-  <body class="composite">
-    <div id="banner">
-    <!-- TODO: Add a Banner for Continuum site -->                 
-    </div>
-    <div id="breadcrumbs">        
-    
-    <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml
files -->           
-      <div class="xleft">
-        $autoexport.breadcrumbs($page)
-      </div>
-      <div class="xright">            
-        <a href="http://www.apache.org/" class="externalLink">Apache</a>
-            |
-        <a href="http://maven.apache.org/continuum" class="externalLink">Continuum</a>
-      </div>
-      <div class="clear">
-        <hr/>
-      </div>
-    </div>
-    <div id="leftColumn">
-      <div id="navcolumn">
-      <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml
files -->           
-      </div>
-    </div>
-    <div id="bodyColumn">
-      <div id="contentBox">
-
-        <div class="wiki-content">
-          $body
-        </div>
-
-      </div>
-    </div>
-    <div class="clear">
-      <hr/>
-    </div>
-    <div id="footer">
-      <div class="xleft">        
-        #editReport() 
-        (<a href="$confluenceUri/pages/editpage.action?pageId=$page.id">edit page</a>)
-      </div>
-
-      <!-- TODO: year -->
-      <div class="xright">&#169;  
-          2001-2008
-    
-          Apache Software Foundation          
-  
-    </div>
-    <div class="clear">
-        <hr/>
-      </div>
-    </div>
-  </body>
-</html>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<html>
+  <head>
+    <title>$page.title</title>
+
+<!-- TODO: need some of these styles, not all
+    <link type="text/css" rel="stylesheet" href="$stylesheet" />
+-->
+    <style type="text/css" media="all">
+      @import url("http://maven.apache.org/scm/css/maven-base.css");
+      @import url("http://maven.apache.org/scm/css/maven-theme.css");
+      @import url("http://maven.apache.org/scm/css/site.css");
+      #leftColumn {
+       display: none !important
+      }
+      #bodyColumn {
+        margin-left: 1.5em;
+      }
+    </style>
+    <link rel="stylesheet" href="http://maven.apache.org/scm/css/print.css" type="text/css"
media="print" />
+        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+  </head>
+  <body class="composite">
+    <div id="banner">
+    <!-- TODO: Add a Banner for Continuum site -->                 
+    </div>
+    <div id="breadcrumbs">        
+    
+    <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml
files -->           
+      <div class="xleft">
+        $autoexport.breadcrumbs($page)
+      </div>
+      <div class="xright">            
+        <a href="http://www.apache.org/" class="externalLink">Apache</a>
+            |
+        <a href="http://maven.apache.org/continuum" class="externalLink">Continuum</a>
+      </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+      <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml
files -->           
+      </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+
+        <div class="wiki-content">
+          $body
+        </div>
+
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xleft">        
+        #editReport() 
+        (<a href="$confluenceUri/pages/editpage.action?pageId=$page.id">edit page</a>)
+      </div>
+
+      <!-- TODO: year -->
+      <div class="xright">&#169;  
+          2001-2008
+    
+          Apache Software Foundation          
+  
+    </div>
+    <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Propchange: continuum/site/src/site/cwiki/confluence-template.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: continuum/site/src/site/resources/.htaccess
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message