svn commit: r178200 - /incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/sample_controls-blank.xml

[st...@apache.org]

Author: steveh
Date: Tue May 24 09:22:25 2005
New Revision: 178200

URL: http://svn.apache.org/viewcvs?rev=178200&view=rev
Log:
Fix for BEEHIVE-761.

Modified:
    incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/sample_controls-blank.xml

Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/sample_controls-blank.xml
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/sample_controls-blank.xml?rev=178200&r1=178199&r2=178200&view=diff
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/sample_controls-blank.xml (original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/sample_controls-blank.xml Tue May 24 09:22:25 2005
@@ -24,21 +24,35 @@
         <title>Using the Control Project Template</title>
         <p>The following instruction assume that you have completed the basic Beehive set up procedure 
 			at <a class="fork" href="../setup.html">Set Up the Dev Environment</a>.</p>
-  <p>To use the template, copy the contents of <code>&lt;BeehiveRoot>/samples/controls-blank</code> into your 
+  <p>To use the template:</p> 
+  <p>(1) Copy the contents of <code>&lt;BeehiveRoot>/samples/controls-blank</code> into your 
 	project folder (referred to as <code>&lt;Project-Folder></code> below). (Or copy <code>controls-blank</code>
-	to another location and rename it as <code>&lt;Project-Folder></code>.)  
-	An Ant build file is included 
+	to another location and rename it as <code>&lt;Project-Folder></code>.)</p>
+	<p>(2) In the file <code>controls-blank/build.properties</code>, 
+		edit the <code>beehive.home</code> property so it points to 
+		<code>&lt;BeehiveRoot></code> (the top-level folder of your 
+		beehive installation).  For example, if your beehive installation
+					resides at <code>C:/apache/apache-beehive-1.0</code>, then your <code>build.properties</code> file
+					would appear as follows.</p>
+				
+    <p><strong>build.properties</strong></p>
+		<source>beehive.home=<strong>C:/apache/apache-beehive-1.0</strong></source>  
+	<p>An Ant build file is included 
 	in the template, which will compile your control project into a distributable JAR 
 	file.  After you have copied the contents of 
 	<code>controls-blank</code> into your project folder, the following directory structure should exist:</p>
 <source>&lt;Project-Folder>
   src
+  build.properties
   build.xml</source> 
   <p>The following Ant command will compile the control template.</p>
 <source>ant -f <strong>&lt;Path-to-Project-Folder></strong>\build.xml build</source>
     <p>This will produce a distributable JAR file at: <code>&lt;Project-Folder>/build/mycontrols.jar</code>.</p>
     <p>To use the JAR in your other projects (like a web app project or a web service project), copy 
 		<code>mycontrols.jar</code> into the project's <code>WEB-INF/lib</code> directory.</p>
+	<p>(To change the name of the generated JAR file, edit the following line in
+		<code>build.xml</code>.)</p>
+	<source><code>&lt;property name="build.jar" value="mycontrols.jar"/></code></source>
     </section>
     </body>
     <footer>