You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@continuum.apache.org by ws...@apache.org on 2009/03/04 23:04:03 UTC
svn commit: r750184 - in /continuum/trunk/continuum-docs/src/site: ./
apt/administrator_guides/ apt/user_guides/building_project/
apt/user_guides/managing_builddef/ apt/user_guides/notification/
apt/user_guides/release/ resources/images/
Author: wsmoak
Date: Wed Mar 4 22:04:02 2009
New Revision: 750184
URL: http://svn.apache.org/viewvc?rev=750184&view=rev
Log:
[CONTINUUM-2093] Documentation improvements
- still missing some images
Submitted by: Jevica Arianne B Zurbano
Added:
continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/build_results.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/forced_build.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/schedule_build.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/release/release_results.apt
continuum/trunk/continuum-docs/src/site/resources/images/notifier-irc-add.png (with props)
continuum/trunk/continuum-docs/src/site/resources/images/notifier-jabber-add.png (with props)
continuum/trunk/continuum-docs/src/site/resources/images/notifier-msn-add.png (with props)
continuum/trunk/continuum-docs/src/site/resources/images/notifier-wagon-add.png (with props)
Modified:
continuum/trunk/continuum-docs/src/site/apt/administrator_guides/schedules.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/index.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefGroup.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefProject.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/irc.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/jabber.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/mail.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/msn.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/wagon.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/release/index.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/release/perform.apt
continuum/trunk/continuum-docs/src/site/apt/user_guides/release/prepare.apt
continuum/trunk/continuum-docs/src/site/resources/images/notifier-mail-add.png
continuum/trunk/continuum-docs/src/site/site.xml
Modified: continuum/trunk/continuum-docs/src/site/apt/administrator_guides/schedules.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/administrator_guides/schedules.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/administrator_guides/schedules.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/administrator_guides/schedules.apt Wed Mar 4 22:04:02 2009
@@ -8,4 +8,52 @@
Managing Schedules
- Coming Soon
\ No newline at end of file
+ Schedules initiates the building of projects continuously. In this section,
+ adding, modifying, and deleting of schedules are discussed.
+
+ Clicking the <<Schedules>> link from the menu on the left will display the following page:
+
+[../images/schedules.png] List of schedules page
+
+* Adding Schedules
+
+ To add a schedule, follow these steps:
+
+ [[1]] Click the <<Add>> button below the list of schedules.
+
+ [[2]] Fill in the needed information in the <<Edit Schedules>> page shown below.
+
+[../images/add_schedule.png] Adding a build schedule
+
+ * <<Name>> The unique identifier of the schedule. This is a required field.
+
+ * <<Description>> Brief description of the configured schedule. This is a required field.
+
+ * <<Cron Expression>> Determines the exact time interval that the build schedule executes.
+
+ * <<Maximum job execution time (seconds)>> This sets the maximum time for a job to be executed.
+ This is a required field.
+
+ * <<Quiet Period (seconds)>> This a setting that delays the build if there has been a commit
+ in the defined number of seconds prior. This is useful when using CVS, since commits are
+ not atomic and a developer might be committing midway through an update. It is not typically
+ needed if using Subversion.
+
+ * <<Enabled>> When selected, scheduled build will be executed.
+ []
+
+ [[3]] Click <<Save>>.
+
+* Editing Schedules
+
+ To edit a schedule, follow these steps:
+
+ [[1]] Click the edit icon which can be found to the right of the schedule.
+
+ [[2]] Modify the fields in the <<Edit Schedules>> page.
+
+ [[3]] Click <<Save>>.
+
+* Deleting Schedules
+
+ To delete a schedule, click the delete icon, the rightmost icon inline with the schedule to be deleted.
\ No newline at end of file
Added: continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/build_results.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/build_results.apt?rev=750184&view=auto
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/build_results.apt (added)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/build_results.apt Wed Mar 4 22:04:02 2009
@@ -0,0 +1,41 @@
+ ------
+ Build Results Management
+ ------
+ ------
+ Feb 23 2009
+ ------
+
+Build Results Management
+
+[../../images/build_result-2.png] Builds tab
+
+ To view the result of the build:
+
+ [[1]] Click the link for the project group of the project you want to view - the link will be
+ under the <<Name>> column.
+
+ [[2]] Click the build number link under the <<Build>> column of the project you want to view.
+ Or you can click the project link again and click the <<Builds>> link at the top of the page, then click
+ the <<Result>> link, next to the State column.
+
+ []
+
+ When builds are executed frequently, deleting unnecessary and failed build results is needed.
+ To delete build results, follow these steps:
+
+ [[1]] Click the name of the project group.
+
+ [[2]] Click on the build number under the <<Build>> column. You will be directed to the build result
+ page as shown below.
+
+[../../images/build_result-1.png] Build Results page
+
+ Or you can click on the name of the project that you want to delete build results from.
+
+ * Click the <<Builds>> tab. Build results list will be displayed.
+
+ * Check the box of the build results that you want to delete.
+
+ []
+
+ [[3]] Click the <<Delete>> button.
\ No newline at end of file
Added: continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/forced_build.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/forced_build.apt?rev=750184&view=auto
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/forced_build.apt (added)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/forced_build.apt Wed Mar 4 22:04:02 2009
@@ -0,0 +1,39 @@
+ ------
+ Force Project Build
+ ------
+ ------
+ Feb 23 2009
+ ------
+
+Force Project Build
+
+ Occasionally you may want to force a build outside of the regular schedule.
+ The following procedure explains how to do this.
+
+ To manually build a project perform the following steps:
+
+ [[1]] Click <<Show Project Groups>>.
+
+ [[2]] Click the project group link of the project you want to build.
+ This will put you on the <<Summary>> page of the project group.
+
+ [[3]] You can click <<Build all projects>> button under <<Group Actions>> to build all
+ the projects in the project group.
+
+[../../images/force_build.png] Project Group Actions
+
+ [[4]] To build an individual project, you can click on the build icon that is found
+ along the row of the project you want to build. It is the first icon on the right of
+ the project name. This will execute the default build goal you have defined for that project.
+
+ To build selected projects, check the box beside the name of the project,
+ then click the <<Build Project(s)>> button.
+
+ If you want to build the project according to a specific build goal other than the
+ default build goal, click on the project name to go to the <<Project's Information>> page.
+ All build goal definitions for the project are listed under the <<Build Definitions>> section.
+ Click on the build icon to the right of the specific build goal you want to execute.
+
+ []
+
+ To view the results of the build, refer to {{{build_results.html}Build Results Management}}.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/index.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/index.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/index.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/index.apt Wed Mar 4 22:04:02 2009
@@ -22,5 +22,12 @@
* continuum.project.name
- * continuum.project.version
-
\ No newline at end of file
+ * continuum.project.version
+
+ []
+
+ Projects can be built in two ways:
+
+ [[1]] {{{schedule_build.html} Scheduled Builds}}
+
+ [[2]] {{{forced_build.html} Forced Builds}}
\ No newline at end of file
Added: continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/schedule_build.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/schedule_build.apt?rev=750184&view=auto
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/schedule_build.apt (added)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/building_project/schedule_build.apt Wed Mar 4 22:04:02 2009
@@ -0,0 +1,24 @@
+ ------
+ Scheduling Project Build
+ ------
+ ------
+ Feb 23 2009
+ ------
+
+Scheduling Project Build
+
+ Schedules determine the project's time interval to build. In this section,
+ how to configure a project to build on a schedule is discussed.
+
+ To configure a scheduled build:
+
+ [[1]] Create a schedule. You can refer to {{{../../administrator_guides/schedules.html} Managing Schedules}} section.
+
+ [[2]] Add a build definition to a project using the schedule created in step 1 for the <<Schedule>> field.
+ You can refer to the section {{{../managing_builddef/index.html} Managing Build Definitions}}.
+
+[../../images/schedule_build.png] Scheduling build
+
+ []
+
+ To view the results of the build, refer to {{{build_results.html}Build Results Management}}.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefGroup.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefGroup.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefGroup.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefGroup.apt Wed Mar 4 22:04:02 2009
@@ -8,4 +8,39 @@
Project Group Build Definition
- To write
\ No newline at end of file
+ The project group level build definition is executed on all of the projects in the group.
+
+[../../images/buildDefGroup.png] Project Group Build Definitions
+
+ To add build defintion to your project group:
+
+ [[1]] Under the <<Build Definitions>> tab in the <<Project Information>> screen, click <<Add>>.
+
+ [[2]] Supply the values for the necessary fields.
+
+ * Enter your <<POM filename>>, which is very likely the same as previous builds, <<<pom.xml>>>.
+
+ * In the <<Goals>> text box, enter your new goals. For example, <<<clean site deploy>>> or <<<release:branch>>>.
+
+ * You may have arguments for Maven, such as <<<--batch-mode --non-recursive>>>.
+ Add your arguments in the Arguments text box or leave it empty.
+
+ * Check <<Build Fresh>> to do a fresh checkout from CVS before the build process.
+ Check <<Always Build>> if you want to execute the goal every time you build the project.
+ If you want this build definition to be your default for building your project,
+ check the <<Is it default?>> check box.
+
+ * Select your build schedule from the pull-down menu. There will only be the <<<DEFAULT_SCHEDULE>>>
+ if you have not defined any others.
+
+ * Select from the pull-down menu the <<Build Environment>> for the build goal.
+
+ * Select the <<Type>> from the pull-down menu.
+
+ * You can supply a short description of the build definition (<<Definition>>).
+
+ []
+
+[../../images/add_goal.png]
+
+ [[3]] Click <<Save>>.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefProject.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefProject.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefProject.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/managing_builddef/builddefProject.apt Wed Mar 4 22:04:02 2009
@@ -8,4 +8,41 @@
Project Build Definition
- To write
\ No newline at end of file
+ The project level build definition is executed to a specific project where the build definition is defined.
+
+[../../images/buildDefProject.png] Project Build Definitions
+
+ To add build defintion to your project:
+
+ [[1]] Select a project within the group.
+
+ [[2]] Under the <<Build Definitions>> section in the <<Project Information>> screen, click <<Add>>.
+
+ [[3]] Supply the values for the necessary fields.
+
+ * Enter your <<POM filename>>, which is very likely the same as previous builds, <<<pom.xml>>>.
+
+ * In the <<Goals>> text box, enter your new goals. For example, <<<clean site deploy>>> or <<<release:branch>>>.
+
+ * You may have arguments for Maven, such as <<<--batch-mode --non-recursive>>>.
+ Add your arguments in the Arguments text box or leave it empty.
+
+ * Check <<Build Fresh>> to do a fresh checkout from CVS before the build process.
+ Check <<Always Build>> if you want to execute the goal every time you build the project.
+ If you want this build definition to be your default for building your project,
+ check the <<Is it default?>> check box.
+
+ * Select your build schedule from the pull-down menu. There will only be the <<<DEFAULT_SCHEDULE>>>
+ if you have not defined any others.
+
+ * Select from the pull-down menu the <<Build Environment>> for the build goal.
+
+ * Select the <<Type>> from the pull-down menu.
+
+ * You can supply a short description of the build definition (<<Definition>>).
+
+ []
+
+[../../images/add_goal.png]
+
+ [[4]] Click <<Save>>.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/irc.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/irc.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/irc.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/irc.apt Wed Mar 4 22:04:02 2009
@@ -6,6 +6,35 @@
Oct 23 2007
------
-Notification
+IRC Notification
- To Write
+ [[1]] Under Notifiers from the Project Information page, click Add.
+
+ [[2]] On the Add Notifier form select IRC from the pull-down menu and click Submit.
+
+ [[3]] On the next page, fill out the form with the following information:
+
+ * IRC Host
+
+ * IRC Port
+
+ * IRC Channel
+
+ * Nick Name
+
+ * Alternate Nick Name
+
+ * User Name
+
+ * Full Name
+
+ * Password which can be left blank if you did not specify one in your IRC account
+
+ []
+
+[../../images/notifier-irc-add.png] Add IRC Notifier
+
+ [[4]] Select the Send on ... options you want.
+
+ [[5]] Click Save. The IRC notifier you just added will be listed under Notifiers on the Project
+ Information page along with the other notifiers you may have set up prior to this.
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/jabber.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/jabber.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/jabber.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/jabber.apt Wed Mar 4 22:04:02 2009
@@ -6,6 +6,34 @@
Nov 19 2007
------
-Notification
+Jabber Notification
- To Write
\ No newline at end of file
+ [[1]] Under Notifiers from the Project Information page, click Add.
+
+ [[2]] Select Jabber from the pull-down menu and click Submit.
+
+ [[3]] On the Add/Edit Jabber Notifier page, fill out the form with the following:
+
+ * Jabber Host
+
+ * Jabber Port is typically 5222
+
+ * Jabber Login
+
+ * Jabber Password
+
+ * Jabber Domain Name is the fully qualified domain name of your Jabber login
+
+ * Jabber Recipient Address
+
+ []
+
+[../../images/notifier-jabber-add.png] Add Jabber Notifier
+
+ The Jabber login and Jabber recipient address must be different. The Jabber
+ recipient must also be added in the contact list of the sender (at least for Google talk).
+
+ [[4]] Select the Send on ... options you want.
+
+ [[5]] Click Save. The Jabber notifier you just added will be listed under Notifiers on the Project
+ Information page along with the other notifiers you may have set up prior to this.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/mail.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/mail.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/mail.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/mail.apt Wed Mar 4 22:04:02 2009
@@ -25,6 +25,12 @@
+-------------------------------+
- Or can you can add manually mail notifier to you project group and/or project
+ Or can you can add manually mail notifier to you project group and/or project.
+
+ On the <<Add Notifier>> form select <<Mail>> from the pull-down menu and click Submit.
[../../images/notifier-mail-add.png] Add Email Notifier
+
+ Fill in the recipient's fully qualified email address and select the send on options you want.
+
+ Then, click <<Save>>.
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/msn.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/msn.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/msn.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/msn.apt Wed Mar 4 22:04:02 2009
@@ -6,6 +6,25 @@
Nov 19 2007
------
-Notification
+MSN Notification
- To Write
\ No newline at end of file
+ [[1]] Under Notifiers from the Project Information page, click Add.
+
+ [[2]] On the Add Notifier form select, MSN from the pull-down menu and click Submit.
+
+ [[3]] On the next page, fill out the form with the following:
+
+ * MSN Login
+
+ * MSN Password
+
+ * MSN Recipient Address
+
+ []
+
+[../../images/notifier-msn-add.png] Add MSN Notifier
+
+ [[4]] Select the Send on ... options you want.
+
+ [[5]] Click Save. The MSN notifier you just added will be listed under Notifiers on the Project
+ Information page along with the other notifiers you may have set up prior to this.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/wagon.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/wagon.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/wagon.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/notification/wagon.apt Wed Mar 4 22:04:02 2009
@@ -6,6 +6,47 @@
Nov 19 2007
------
-Notification
+Wagon Notification
- To Write
\ No newline at end of file
+ [[1]] Under Notifiers from the Project Information page, click Add.
+
+ [[2]] On the Add Notifier form select Wagon from the pull-down menu and click Submit.
+
+ [[3]] On the next page, enter the Project Site URL.
+
+ It must be a Wagon URL like the URL used in <<<distributionManagement>>>. For the Webdav protocol,
+ you can use <<<dav:[http_url]>>> or <<<file:///path_to_the_directory>>> if you want to copy it locally
+ with the file protocol.
+
+ [[4]] Enter the ServerId. This should match the value of the <<<\<id\>>>> in the server configuration found in
+ <<<settings.xml>>>. Sample configuration follows:
+
++------+
+ <server>
+ <username>admin</username>
+ <password>admin123</password>
+ <id>continuum.site</id>
+ </server>
++------+
+
+ Using the server configuration in <<<[user_home]/.m2/settings.xml>>> is a workaround
+ for user authentication using the wagon notifier.
+
+ The <<<\<username\>>>> and <<<\<password\>>>> should be set to the user account that has the <<Site
+ Producer>> and <<Site Observer>> roles.
+
+[../../images/notifier-wagon-add.png] Add Wagon Notifier
+
+ [[5]] Select the Send on ... options you want.
+
+ [[6]] Click Save. The Wagon notifier you just added will be listed under Notifiers on the Project
+ Information page along with the other notifiers you may have set up prior to this.
+
+ []
+
+ The file protocol will create <<<buildresult.txt>>> file locally in the location specified in the
+ Wagon Notifier configuration. If you used the Webdav protocol, a <<<buildresult.txt>>> file will
+ be copied to your disk, relative to where you told it to be placed when you set up the Wagon
+ notifier.
+
+ You can also view the <<<buildresult.txt>>> file from a browser at the Project Site URL you specified.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/release/index.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/release/index.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/release/index.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/release/index.apt Wed Mar 4 22:04:02 2009
@@ -4,5 +4,61 @@
Releasing Projects
- The release process has two steps, {{{prepare.html}Prepare}} and {{{perform.html}Perform}}.
+ The release process has two steps, {{{prepare.html}Prepare}} and {{{perform.html}Perform}}.
+ [[1]] First, it prepares your project for release by doing the following:
+
+ * Checks that your project is in a "releasable" state.
+
+ * Updates the POMs for the new development version.
+
+ * Runs a test build.
+
+ * Generates a tag for the release.
+
+ * Generates the artifact to be deployed, such as a jar file.
+
+ * Generates the site and deploys it.
+
+ * Commits the new POMs to the new development version. It will do the commit to the SCM
+ connection URL you specify (explained later).
+
+ []
+
+ [[2]] Then the release management system performs the release by checking out a clean copy
+ of the tagged release and deploying the artifacts and site.
+
+ []
+
+* Modifying POM for Release
+
+ The source code control system you use must be specified in your POM file in an <<<scm>>> entry
+ similar to the one shown here:
+
++----------------------------------------------------------------------------------+
+ <scm>
+ <connection>
+ scm:svn:http://svn.apache.org/repos/asf/maven/components/trunk
+ </connection>
+ <developerConnection>
+ scm:svn:https://svn.apache.org/repos/asf/maven/components/trunk
+ </developerConnection>
+ <url>http://svn.apache.org/viewcvs.cgi/maven/components/trunk</url>
+ </scm>
++---------------------------------------------------------------------------------+
+
+ To determine what to enter for your connection URL (the "<<< \<connection\> >>>" tag) go to the link
+ {{http://maven.apache.org/scm/scms-overview.html}} for a list of supported SCMs and click on your
+ source code control system to see the appropriate syntax for your particular software.
+
+ In general the format for an SCM URL is:
+ <<< scm:<scm_provider><delimiter><provider_specific_part> >>>
+
+ In the example above, the <<<scm_provider>>> is "<<<svn>>>" (Subversion). The <<<delimiter>>> is a colon.
+ And the rest of the line is the "<<<provider_specific_part>>>".
+
+ It is important to prepare the release just before performing the release. The reason these
+ processes have been separated into two steps is to allow the user to confirm that everything has been
+ set correctly before the actual release. If between the prepare and performing of the release there is
+ a change to the SCM tree, an error will occur causing the prepare process to restart.
+
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/release/perform.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/release/perform.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/release/perform.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/release/perform.apt Wed Mar 4 22:04:02 2009
@@ -15,3 +15,5 @@
Wait for the process to complete, then click Done.
[../../images/release-perform-executing.png]
+
+ To view the release perform results, refer to {{{release_results.html}Release Results Management}}.
\ No newline at end of file
Modified: continuum/trunk/continuum-docs/src/site/apt/user_guides/release/prepare.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/release/prepare.apt?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/release/prepare.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/release/prepare.apt Wed Mar 4 22:04:02 2009
@@ -23,3 +23,5 @@
You will be returned to this page to make another selection
[../../images/release-choose-perform-goal.png]
+
+ To view the release prepare results, refer to {{{release_results.html}Release Results Management}}.
Added: continuum/trunk/continuum-docs/src/site/apt/user_guides/release/release_results.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/user_guides/release/release_results.apt?rev=750184&view=auto
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/user_guides/release/release_results.apt (added)
+++ continuum/trunk/continuum-docs/src/site/apt/user_guides/release/release_results.apt Wed Mar 4 22:04:02 2009
@@ -0,0 +1,19 @@
+ ------
+ Release Results Management
+ ------
+ ------
+ Feb 23 2009
+ ------
+
+Release Results Management
+
+ <<Release Results>> tab from the <<Project Information>> page displays all the release results of a
+ project when executing release goals prepare and perform.
+
+[../../images/release_result-1.png] Release Results page
+
+ To view the release result, click the <<View Result>> link in-line with the release goal being executed.
+
+[../../images/release_result-2.png] Release Summary
+
+ To delete release results, select the boxes beside the project name then click <<Delete>>.
\ No newline at end of file
Added: continuum/trunk/continuum-docs/src/site/resources/images/notifier-irc-add.png
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/resources/images/notifier-irc-add.png?rev=750184&view=auto
==============================================================================
Binary file - no diff available.
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-irc-add.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-irc-add.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: continuum/trunk/continuum-docs/src/site/resources/images/notifier-jabber-add.png
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/resources/images/notifier-jabber-add.png?rev=750184&view=auto
==============================================================================
Binary file - no diff available.
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-jabber-add.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-jabber-add.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: continuum/trunk/continuum-docs/src/site/resources/images/notifier-mail-add.png
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/resources/images/notifier-mail-add.png?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
Binary files - no diff available.
Added: continuum/trunk/continuum-docs/src/site/resources/images/notifier-msn-add.png
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/resources/images/notifier-msn-add.png?rev=750184&view=auto
==============================================================================
Binary file - no diff available.
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-msn-add.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-msn-add.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: continuum/trunk/continuum-docs/src/site/resources/images/notifier-wagon-add.png
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/resources/images/notifier-wagon-add.png?rev=750184&view=auto
==============================================================================
Binary file - no diff available.
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-wagon-add.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: continuum/trunk/continuum-docs/src/site/resources/images/notifier-wagon-add.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: continuum/trunk/continuum-docs/src/site/site.xml
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/site.xml?rev=750184&r1=750183&r2=750184&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/site.xml (original)
+++ continuum/trunk/continuum-docs/src/site/site.xml Wed Mar 4 22:04:02 2009
@@ -61,10 +61,15 @@
<item name="Wagon Notification" href="user_guides/notification/wagon.html"/>
</item>
<item name="Building a project" href="user_guides/building_project/index.html" collapse="true">
- <item name="Scheduled Build" href="user_guides/building_project/index.html#Scheduled Build"/>
- <item name="Forced Build" href="user_guides/building_project/index.html#Forced Build"/>
+ <item name="Scheduled Build" href="user_guides/building_project/schedule_build.html"/>
+ <item name="Forced Build" href="user_guides/building_project/forced_build.html"/>
+ <item name="Build Results Management" href="user_guides/building_project/build_results.html"/>
+ </item>
+ <item name="Release Management" href="user_guides/release/index.html" collapse="true">
+ <item name="Prepare Project Release" href="user_guides/release/prepare.html"/>
+ <item name="Perform Project Release" href="user_guides/release/perform.html"/>
+ <item name="Release Results Management" href="user_guides/release/release_results.html"/>
</item>
- <item name="Release Management" href="user_guides/release/index.html"/>
</item>
<item name="Administrator's Guides" href="administrator_guides/index.html" collapse="true">
<item name="Managing Users and Security" href="administrator_guides/security/index.html" collapse="true">
@@ -80,11 +85,13 @@
<item name="Managing Local Repositories" href="administrator_guides/localRepository.html"/>
<item name="Managing Purge Configuration" href="administrator_guides/purgeConfiguration.html"/>
<item name="Managing Parallel Builds" href="administrator_guides/parallelBuilds.html"/>
+ <item name="Managing Build Agents" href="administrator_guides/build-agents.html"/>
<item name="External databases" href="administrator_guides/external-db.html"/>
<item name="Monitoring Continuum" href="administrator_guides/monitoring.html"/>
<item name="Appearance Configuration" href="administrator_guides/appearance.html"/>
<item name="Build Definition Template" href="administrator_guides/builddefTemplate.html"/>
<item name="Shutdown Continuum" href="administrator_guides/shutdown.html"/>
+ <item name="Understanding Distributed Builds" href="administrator_guides/distributed-builds.html"/>
</item>
<item name="Developer's Guides" href="developer_guides/index.html" collapse="true">
<!-- item name="SVN repository structure" href="developer_guides/svn.html"/ -->