forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r209545 - /forrest/trunk/site-author/content/xdocs/tools/forrestbot.xml
Date Wed, 06 Jul 2005 23:50:39 GMT
Author: crossley
Date: Wed Jul  6 16:50:38 2005
New Revision: 209545

URL: http://svn.apache.org/viewcvs?rev=209545&view=rev
Log:
Whitespace changes only. Tabs to spaces. Wrap long lines.

Modified:
    forrest/trunk/site-author/content/xdocs/tools/forrestbot.xml

Modified: forrest/trunk/site-author/content/xdocs/tools/forrestbot.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/tools/forrestbot.xml?rev=209545&r1=209544&r2=209545&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/tools/forrestbot.xml (original)
+++ forrest/trunk/site-author/content/xdocs/tools/forrestbot.xml Wed Jul  6 16:50:38 2005
@@ -26,14 +26,23 @@
     <section>
       <title>Overview</title>
 
-      <p>Forrestbot lets you automate building and deploying websites. The whole process
gets the source docs, builds it, then deploys the site where you want it to go.  It can also
notify you afterwards, and it keeps a log of the build process.  To accomplish these tasks
Forrestbot uses four "workstages" (getsrc, build, deploy, notify) that are comprised of "implementations"
and have various properties that may be set, depending upon the implementations chosen.</p>
-	  <fixme author="AB">Need a better term than comprised of?  Trying give a sense of
the building blocks used and how they relate to each other.</fixme>
+      <p>Forrestbot lets you automate building and deploying websites. The 
+        whole process gets the source docs, builds it, then deploys the site
+        where you want it to go. It can also notify you afterwards, and it
+        keeps a log of the build process. To accomplish these tasks Forrestbot 
+        uses four "workstages" (getsrc, build, deploy, notify) that are
+        comprised of "implementations" and 
+        have various properties that may be set, depending upon the 
+        implementations chosen.</p>
+    <fixme author="AB">Need a better term than comprised of?  Trying give a 
+sense of the building blocks used and how they relate to each other.</fixme>
     </section>
 
     <section>
       <title>Using Forrestbot</title>
 
-      <p>You need to create a customized buildfile directing Forrestbot's work and
then simply execute:</p>
+      <p>You need to create a customized buildfile directing Forrestbot's work 
+        and then simply execute:</p>
 
       <source>forrest -f mybuildfile.xml</source>
 
@@ -43,24 +52,35 @@
     <section>
       <title>Creating a buildfile</title>
 
-			  
-	  
-      <p>Within the new buildfile you need to first set properties needed by the workstages
you are going to use and then specify what implementations will be used by each workstage.</p>
-	  <fixme author="AB">This seems backwards since the properties are dependent on the
implementations - no?</fixme>
 
-      <p>This sample buildfile can be used as a base from which to customize your own
buildfile.  The file starts with the project name and default workstage target, then sets
the specific properties we will need to get the source, set up notification and indicate the
deploy location.  It then specifies which implementations we will use and finishes up with
importing the forrestbot.xml file.</p>
-	  <fixme author="AB">Is "default workstage target" the correct term for default="main"?</fixme>
+
+      <p>Within the new buildfile you need to first set properties needed by 
+        the workstages you are going to use and then specify what 
+        implementations will be used by each workstage.</p>
+    <fixme author="AB">This seems backwards since the properties are dependent 
+on the implementations - no?</fixme>
+
+      <p>This sample buildfile can be used as a base from which to customize 
+        your own buildfile.  The file starts with the project name and default 
+        workstage target, then sets the specific properties we will need to get 
+        the source, set up notification and indicate the deploy location.  It then 
+        specifies which implementations we will use and finishes up with 
+        importing the forrestbot.xml file.</p>
+    <fixme author="AB">Is "default workstage target" the correct term for 
+default="main"?</fixme>
 
       <source>&lt;project name="mysampleproject" default="main"&gt;
 	&lt;property name="notify.email.host" value="smtp.myhost.com"/&gt;
 	&lt;property name="notify.email.to" value="me@domain.com"/&gt;
-	&lt;property name="notify.administrator" value="Your Name &amp;lt;me@domain.com&gt;"/&gt;
+	&lt;property name="notify.administrator" value="Your Name 
+&amp;lt;me@domain.com&gt;"/&gt;
 	&lt;property name="getsrc.cvs.user" value="anoncvs"/&gt;
 	&lt;property name="getsrc.cvs.password" value="anoncvs"/&gt;
 	&lt;property name="getsrc.cvs.root" value="/home/cvspublic"/&gt;
 	&lt;property name="getsrc.cvs.host" value="cvs.myhost.com"/&gt;
 	&lt;property name="getsrc.cvs.module" value="myproject"/&gt;
-	&lt;property name="deploy.scp.dest" value="username@myhost.com:/var/www/mydomain/htdocs"/&gt;
+	&lt;property name="deploy.scp.dest" 
+value="username@myhost.com:/var/www/mydomain/htdocs"/&gt;
 
 	&lt;!-- here we specify to use two notification implementations --&gt;
 	&lt;target name="notify" depends="notify.local, notify.email"/&gt;
@@ -68,18 +88,24 @@
 	&lt;!-- here we specify to deploy with the scp implementation --&gt;
 	&lt;target name="deploy" depends="deploy.scp"/&gt;
 
-	&lt;!-- the default implementation for getsrc is getsrc.cvs, which is what we want --&gt;
+	&lt;!-- the default implementation for getsrc is getsrc.cvs, which is 
+what we want --&gt;
 
-	&lt;!-- assumes FORREST_HOME has been set as an environment variable --&gt;
+	&lt;!-- assumes FORREST_HOME has been set as an environment variable 
+--&gt;
 	&lt;property environment="env"/&gt;
-	&lt;import file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/&gt;
+	&lt;import 
+file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/&gt;
 &lt;/project&gt;
 
 </source>
 
-	<section>
-		<title>Workstages</title>
-	<p>It is only necessary to include the specific target implementations in the buildfile
if we want to override the default implementations.  The following tables show the various
workstages and which implementations may be used for each and which is the default.</p>
+  <section>
+    <title>Workstages</title>
+    <p>It is only necessary to include the specific target implementations in 
+      the buildfile if we want to override the default implementations.  The 
+      following tables show the various workstages and which implementations
+      may be used for each and which is the default.</p>
       <table>
         <tr>
           <th>Workstage</th>
@@ -137,21 +163,24 @@
       name="main" depends="getsrc, build, deploy, notify"/&gt;</code>, create
       your own implementation of a workstage, or use any other ant tasks to do
       additional work.</p>
-	  <fixme author="AB">How do you create your own implementation?  Can you create a
different default target than main - how do you override the default?</fixme> 
+    <fixme author="AB">How do you create your own implementation?  Can you 
+create a different default target than main - how do you override the 
+default?</fixme>
       <p></p>
-	  </section>
+    </section>
       <section>
         <title>Workstage Properties</title>
 
         <p>Each workstage implementation is configurable with properties. The
         following tables describe each property and whether or not you are
         required to set it in your buildfile.</p>
-		
-	  <p>Many workstage properties use usernames and passwords. You may want to keep them
-      out of your project's xml buildfile (especially if you store that file in CVS
+
+    <p>Many workstage properties use usernames and passwords. You may want to 
+      keep them out of your project's xml buildfile (especially if you store
+      that file in CVS
       or SVN). A nice way to do this is make a simple buildfile (e.g.
       my-settings.xml) that just sets those properties (don't include it in
-      CVS/SVN!). Then in your project buildfile, have <code>&lt;import
+      CVS/SVN). Then in your project buildfile, have <code>&lt;import
       file="my-settings.xml"/&gt;</code>.</p>
 
         <section>
@@ -207,7 +236,8 @@
               <td>getsrc.local.root-dir</td>
 
               <td>Absolute path to the project's root directory on the local
-              computer.  Use <strong>location=</strong> instead of <strong>value=</strong>
for this &lt;property&gt;</td>
+              computer.  Use <strong>location=</strong> instead of 
+              <strong>value=</strong> for this &lt;property&gt;</td>
 
               <td></td>
 
@@ -383,7 +413,8 @@
             <tr>
               <td>deploy.local.dir</td>
 
-              <td>Path to deploy site to - the dir that would be the equivalant of
build/site dir.  Relative paths will be relative to
+              <td>Path to deploy site to - the dir that would be the equivalant 
+              of build/site dir.  Relative paths will be relative to
               ${bot.home}</td>
 
               <td>sites/${ant.project.name}</td>
@@ -720,7 +751,7 @@
               </ul></li>
           </ul></li>
       </ul>
-	  
+
       <p>The workstage buildfiles set up the properties and files so that the
       main forrest buildfile (forrest.build.xml) will run. After it is run,
       other workstage buildfiles can implement reporting, deployment, or other
@@ -728,7 +759,9 @@
 
       <p>Your buildfile can specify which workstages you want to use, set
       properties for them, and do any additional pre- and post-processing.</p>
-	  <fixme author="AB">Which of these (Your buildfile/workstage buildfile) is the "project
buildfile" referred to elsewhere on this page, if any?  If it is "Your buildfile" can I also
create workstage buildfiles?  If so, how?</fixme>
+    <fixme author="AB">Which of these (Your buildfile/workstage buildfile) is 
+the "project buildfile" referred to elsewhere on this page, if any?  If it is 
+"Your buildfile" can I also create workstage buildfiles?  If so, how?</fixme>
     </section>
   </body>
 </document>



Mime
View raw message