svn commit: r387726 - /xml/site/src/documentation/content/xdocs/guidelines.xml

[cr...@apache.org]

Author: crossley
Date: Tue Mar 21 21:07:48 2006
New Revision: 387726

URL: http://svn.apache.org/viewcvs?rev=387726&view=rev
Log:
The forrestbot command is 'forrest -f publish.xml' and not 'ant -f publish.xml'.
Fine-tune some other instructions.

Modified:
    xml/site/src/documentation/content/xdocs/guidelines.xml

Modified: xml/site/src/documentation/content/xdocs/guidelines.xml
URL: http://svn.apache.org/viewcvs/xml/site/src/documentation/content/xdocs/guidelines.xml?rev=387726&r1=387725&r2=387726&view=diff
==============================================================================
--- xml/site/src/documentation/content/xdocs/guidelines.xml (original)
+++ xml/site/src/documentation/content/xdocs/guidelines.xml Tue Mar 21 21:07:48 2006
@@ -76,21 +76,22 @@
       <section id="web-forrestbot-publish">
         <title>ForrestBot "publish" Step-by-Step</title>
         <p>
-          We're using ForrestBot for build and deploy the XML website. ForrestBot comes with Apache Forrest 0.7. 
+          We're using ForrestBot for build and deploy the XML website. ForrestBot comes with Apache Forrest 0.7
+          (install forrest and set FORREST_HOME and PATH as described
+          <link href="web-local-forrest">below</link>).
           The root directory of your XML site checkout contains the file "publish.xml" which is an Ant build file
           that manages the build and the deployment of the XML website. Please look into this file for
-          further instructions to set up ForrestBot on your machine. Basically, we're simply running ForrestBot 
-          manually by typing "ant -f publish.xml" once we're happy with our changes to the site. Be sure to set
+          further instructions to set up ForrestBot on your machine. Basically, we're simply using ForrestBot 
+          manually by typing "forrest -f publish.xml" after we're happy with our changes to the site. Be sure to set
           up the "deploy.settings" file as described in the "publish.xml" file. Step-by-step instructions for 
           the deployment process again:
         </p>
         <ul>
-          <li>Modify the sources of the website and check locally with Forrest 0.7 (run "forrest run" or just "forrest").</li>
+          <li>Modify the sources of the website and check locally with Forrest 0.7 (e.g. do "forrest run").</li>
           <li>
-            Once you're satisfied, run "ant -f publish.xml" to do a clean build of the website. If the build 
-            runs without problems, the website will be uploaded as a whole using SCP to cvs.apache.org.
+            Once you're satisfied, do "forrest -f publish.xml" to do a clean build of the website. If the build 
+            completes without problems, the website will be uploaded as a whole using SCP to cvs.apache.org and group file permissions will be set.
           </li>
-          <li>Wait for the next rsync cycle and check your changes in the live site. (Sorry, no manual rsync available ATM)</li>
         </ul>
         <p/>
         <warning>
@@ -112,7 +113,8 @@
           <li>set environment variable PATH=$PATH:$FORREST_HOME/bin</li>
           <li>cd to your local XML site checkout</li>
           <li>update your local XML site checkout (svn update)</li>
-          <li>run forrest(.bat), which will build the web-site documents in build/site.</li>
+          <li>do 'forrest run' and view localhost:8888, or do 'forrest'
+            which will build the web-site documents in build/site for local viewing.</li>
         </ul>
         <note>
           You can use "forrest run" to start a local web server. That improves development speed as you 



---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org