continuum-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wsm...@apache.org
Subject 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/
Date Wed, 04 Mar 2009 22:04:03 GMT
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"/ -->



Mime
View raw message