Author: steveh Date: Fri Jan 21 14:35:26 2005 New Revision: 125976 URL: http://svn.apache.org/viewcvs?view=rev&rev=125976 Log: Taking BEEHIVE_HOME out of the setup page and the controls tutorial.
DRT: docs Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/tutorial_controls.xml incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/tutorial_controls.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/tutorial_controls.xml?view=diff&rev=125976&p1=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/tutorial_controls.xml&r1=125975&p2=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/tutorial_controls.xml&r2=125976 ============================================================================== --- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/tutorial_controls.xml (original) +++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/tutorial_controls.xml Fri Jan 21 14:35:26 2005 @@ -28,29 +28,27 @@ <title>Step 1: Begin the Page Flow Tutorial</title> <section> <title>To Set up the Development Environment</title> - <p>Follow the setup directions at <a class="fork" href="../setup.html">Beehive Installation and Setup</a></p> - <p>After completing the instructions, leave the command shell open to use throughout this tutorial.</p> - </section> - - <section> - <title>Add a Manager Role to Tomcat</title> - <p>Adding the manager role to Tomcat server allows you to run deploy related targets in the Ant file <code>runTomcat.xml</code>. This file is provided as a convenience for managing the Tomcat server.</p> - <p>Edit the file <code>CATALINA_HOME/conf/tomcat-users.xml</code> so it appears as follows. Code to add appears in bold type.</p> - <source><?xml version='1.0' encoding='utf-8'?> -<tomcat-users> - <role rolename="tomcat"/> - <role rolename="role1"/> - <strong><role rolename="manager"/></strong> - <user username="tomcat" password="tomcat" roles="tomcat"/> - <user username="role1" password="tomcat" roles="role1"/> - <user username="both" password="tomcat" roles="tomcat,role1"/> - <strong><user username="manager" password="manager" roles="manager"/></strong> -</tomcat-users></source> + <p>Complete all of the necessary and optional steps in the following topic: + <a class="fork" href="../setup.html">Beehive Installation and Setup</a></p> + + <p>After completing the instructions, leave the command shell open to use + throughout this tutorial.</p> + <p>Before proceding, confirm that you have the following variables set in your shell:</p> + <ul> + <li><code>ANT_HOME</code></li> + <li><code>JAVA_HOME</code></li> + <li><code>TOMCAT_HOME</code></li> + </ul> + <p>Also ensure that the following elements are on your <code>PATH</code>:</p> + <ul> + <li><code>ANT_HOME/bin</code></li> + <li><code>JAVA_HOME/bin</code></li> + </ul> </section> <section> <title>To Start the Tomcat Server</title> <p>At the command prompt, enter:</p> - <source>%CATALINA_HOME%\bin\startup.bat</source> + <source>%TOMCAT_HOME%\bin\startup.bat</source> </section> </section> <section id="step_2"> @@ -69,9 +67,12 @@ makes it much easier to test your control as you go. The web application will form the testing ground for your control.</p> <p>On your C: drive, create a directory called <code>beehive_projects</code>.</p> - <p>Copy the folder <code>BEEHIVE_HOME/samples/netui-blank</code> into <code>C:/beehive_projects</code>.</p> - <p>Rename the folder C:/beehive_projects/<strong>netui-blank</strong> to the name - C:/beehive_projects/<strong>control_tutorial</strong></p> + <p>Copy the folder <code><BeehiveRoot>/samples/netui-blank</code> into + <code>C:/beehive_projects</code>. (<code><BeehiveRoot></code> refers to the + top level folder of your Beehive installation.)</p> + <p>Rename the folder + <code>C:/beehive_projects/</code><strong><code>netui-blank</code></strong> to the name + <code>C:/beehive_projects/</code><strong><code>control_tutorial</code></strong></p> <p>Before proceeding, confirm that the following directory structure exists:</p> <source>C: beehive_projects @@ -83,12 +84,12 @@ <p>In this step you will assemble the runtime resources for your Control. Most of these files are included in the WEB-INF directory. It includes JAR files with the JSP tag handler classes, the Controls runtime JAR, etc.</p> - <p>Using the command shell opened in the previous step, at the command prompt, enter: </p> - <source> ant - -f %BEEHIVE_HOME%\ant\buildWebapp.xml - -Dwebapp.dir=C:\beehive_projects\control_tutorial - deploy.beehive.webapp.runtime - </source> + <p>At the command prompt, enter the following ant command. In place of <code><BeehiveRoot> + substitute the path to the top-level directory of your Beehive installation</code>.</p> + <source>ant + -f <BeehiveRoot>\ant\webappRuntimeCore.xml + -Dwebapp.dir=C:\beehive_projects\control_tutorial + deploy.beehive.webapp.runtime</source> </section> <section> <title>To Create the Control's Implementation File</title> @@ -117,7 +118,7 @@ return "Hello, World!"; } }]]></source> - <p>Save and close <code>HelloImpl.jcs</code>.</p> + <p>Save <code>HelloImpl.jcs</code>.</p> </section> <section> <title>To Create the Control's Interface File</title> @@ -134,15 +135,17 @@ { public String hello(); }]]></source> + <p>Save <code>Hello.java</code>.</p> </section> <section> - <title>To Create a JSP Page to Test the Control</title> - <p>To test your Beehive Control, you need to call the control from some other resource, such as a JAVA application, JSP page, or Page Flow web application. In this step you will call the + <title>To Edit the <code>index.jsp</code> Page</title> + <p>To test your Beehive Control, you need to call the control from some other + resource, such as a JAVA application, JSP page, or Page Flow web application. + In this step you will call the control from a JSP page. </p> - <p>In the directory <code>C:/beehive_projects/control_tutorial</code>, create a file named <code>hello.jsp</code>. - </p> - <p>Edit hello.jsp so it appears as follows. Code to edit appears in bold.</p> + <p>Edit the file <code>C:/beehive_projects/control_tutorial/index.jsp</code> + so it appears as follows. Code to edit appears in bold.</p> <source> <%@ page language="java" contentType="text/html;charset=UTF-8"%> <%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0"; prefix="netui-data"%> @@ -162,25 +165,27 @@ </netui:body> </netui:html> </source> + <p>Save <code>index.jsp</code>.</p> </section> <section> <title>To Compile and Deploy the Control</title> <p>You are now ready to compile the control.</p> - <p>At the command prompt, enter:</p> - <source> ant - -f %BEEHIVE_HOME%\ant\buildWebapp.xml - -Dwebapp.dir=C:\beehive_projects\control_tutorial - -Dcontext.path=control_tutorial - build.webapp - deploy</source> - <p>If the application is already deployed on Tomcat (which may happen if this is your second time executing the tutorial), use the command below:</p> - <source> ant - -f %BEEHIVE_HOME%\ant\buildWebapp.xml - -Dwebapp.dir=C:\beehive_projects\control_tutorial - -Dcontext.path=control_tutorial - undeploy - build.webapp - deploy</source> + <p>At the command prompt, enter the following Ant command. In place of <code><BeehiveRoot> + substitute the path to the top-level directory of your Beehive installation</code>.</p> + <source>ant + -f <BeehiveRoot>\ant\buildWebapp.xml + -Dwebapp.dir=C:\beehive_projects\control_tutorial + build</source> + <p>To deploy the web application (with the control imbedded in it), click the following link.</p> + <source> + <a + class="fork" + href="http://localhost:8080/manager/deploy?path=/control_tutorial&war=file:C:/beehive_projects/control_tutorial&update=true";>http://localhost:8080/manager/deploy?path=/control_tutorial&war=file:C:/beehive_projects/control_tutorial&update=true</a> + </source> + <p>If you are prompted for a username/password, enter: manager/manager</p> + <p>(For an explanation of this method of deploying an application to Tomcat, + see the Tomcat 5 documentation: + <a class="fork" href="http://jakarta.apache.org/tomcat/tomcat-5.0-doc/manager-howto.html#Deploy%20A%20New%20Application%20from%20a%20Local%20Path";>Deploy A New Application from a Local Path</a>)</p> </section> <section> <title>To Test the Control</title> @@ -252,15 +257,14 @@ </section> <section> <title>To Compile and Redeploy the Control</title> -<p>Compile and redeploy the control with the following Ant command:</p> - - <source> ant - -f %BEEHIVE_HOME%\ant\buildWebapp.xml - -Dwebapp.dir=C:\beehive_projects\control_tutorial - -Dcontext.path=control_tutorial - undeploy - build.webapp - deploy</source> +<p>Compile the control with the following Ant command:</p> + <source>ant -f <BeehiveRoot>\ant\buildWebapp.xml -Dwebapp.dir=C:\beehive_projects\control_tutorial build</source> + <p>To redeploy the application, click the following link:</p> + <source> + <a + class="fork" + href="http://localhost:8080/manager/deploy?path=/control_tutorial&war=file:C:/beehive_projects/control_tutorial&update=true";>http://localhost:8080/manager/deploy?path=/control_tutorial&war=file:C:/beehive_projects/control_tutorial&update=true</a> + </source> </section> <section> Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml?view=diff&rev=125976&p1=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml&r1=125975&p2=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml&r2=125976 ============================================================================== --- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml (original) +++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml Fri Jan 21 14:35:26 2005 @@ -108,7 +108,7 @@ <p>In this step you will assemble the runtime resources for your Page Flow application. The runtime JARs include the Page Flow runtime, the <netui> tag library, etc. These resources are loaded into your project's <code>WEB-INF/lib</code> folder using the Ant command below.</p> <p>At the command prompt, enter the following Ant command:</p> <source> ant - -f %BEEHIVE_HOME%\ant\buildWebapp.xml + -f %BEEHIVE_HOME%\ant\webappRuntimeCore.xml -Dwebapp.dir=C:\beehive_projects\pageflow_tutorial deploy.beehive.webapp.runtime</source> <p>Before proceeding, confirm that the following directory structure exists:</p> @@ -171,7 +171,7 @@ -f %BEEHIVE_HOME%\ant\buildWebapp.xml -Dwebapp.dir=C:\beehive_projects\pageflow_tutorial -Dcontext.path=pageflow_tutorial - build.webapp + build deploy</source> <p>Note: if you get an error stating that the <code>/pageflow_tutorial</code> context path already exists, then use the following Ant command to @@ -181,8 +181,8 @@ -f %BEEHIVE_HOME%\ant\buildWebapp.xml -Dwebapp.dir=C:\beehive_projects\pageflow_tutorial -Dcontext.path=pageflow_tutorial + build undeploy - build.webapp deploy</source> </section> <section> @@ -275,8 +275,8 @@ -f %BEEHIVE_HOME%\ant\buildWebapp.xml -Dwebapp.dir=C:\beehive_projects\pageflow_tutorial -Dcontext.path=pageflow_tutorial + build undeploy - build.webapp deploy</source> </section> <section> @@ -407,8 +407,8 @@ -f %BEEHIVE_HOME%\ant\buildWebapp.xml -Dwebapp.dir=C:\beehive_projects\pageflow_tutorial -Dcontext.path=pageflow_tutorial + build undeploy - build.webapp deploy</source> </section> <section> @@ -464,8 +464,8 @@ -f %BEEHIVE_HOME%\ant\buildWebapp.xml -Dwebapp.dir=C:\beehive_projects\pageflow_tutorial -Dcontext.path=pageflow_tutorial + build undeploy - build.webapp deploy</source> </section> <section> Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml?view=diff&rev=125976&p1=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml&r1=125975&p2=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml&r2=125976 ============================================================================== --- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml (original) +++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml Fri Jan 21 14:35:26 2005 @@ -1,59 +1,54 @@ <?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd";> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" + "http://forrest.apache.org/dtd/document-v20.dtd";> <document> - <header> - <title>Beehive Installation and Setup</title> - </header> - <body> - <p>This topic explains how to install a Beehive binary distribution on your machine. Once you have completed these installation instructions, you can begin developing Beehive applications.</p> - <section> - <title>To Download and Install a Beehive Binary Distribution</title> - <p>Visit (<a class="fork" href="http://cvs.apache.org/dist/incubator/beehive/v1.0-alpha/bin/";>http://cvs.apache.org/dist/incubator/beehive/v1.0-alpha/bin/</a>) and download the latest binary distribution of Beehive. Note that the current release of Beehive is an alpha: it is <em>not</em> for building production-level applcations.</p> - <p>Unzip the Beehive distribution file on your machine.</p> - </section> - <section> - <title>To Download and Install J2SE5</title> - <p>If you do not have J2SE5 installed, visit <a class="fork" href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</a>. - </p> - <p>Download and install the latest version of J2SE5.</p> - </section> - <section> - <title>To Install ANT 1.6.2</title> - <p>If you do not have Ant 1.6.2 installed, visit <a class="fork" href="http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/ant/apache-ant-1.6.2-bin.zip";>http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/ant/apache-ant-1.6.2-bin.zip</a>. - </p> - <p>Download the ZIP file and unzip it on your machine.</p> - </section> - <section> - <title>To Download and Install Tomcat 5</title> - <p>If you do not have Tomcat 5 installed, visit <a class="fork" href="http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/tomcat/jakarta-tomcat-5.0.25.zip";>http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/tomcat/jakarta-tomcat-5.0.25.zip</a> - </p> - <p>Download the ZIP file and unzip it on your machine.</p> - </section> - <section> - <title>To Set up the Development Environment</title> - <p>Open the top level directory of the Beehive distribution (for example, <code>C:/apache-beehive-incubating-1.0-alpha-snapshot</code>). Open the file <code>beehiveUser.cmd</code> in a text editor and edit it to fit your local environment. The following environmental variables must be set to the appropriate paths on your machine: <code>BEEHIVE_HOME</code>, <code>JAVA_HOME</code>, <code>ANT_HOME</code>, and <code>CATALINA_HOME</code>. The following example shows how to edit <code>beehiveUser.cmd</code> for a typical environment.</p> - <source>REM the root of Beehive distribution -set BEEHIVE_HOME=C:\apache-beehive-incubating-1.0-alpha-snapshot - -REM location of a JDK -set JAVA_HOME=C:\jdk1.5.0 - -REM location of Ant -set ANT_HOME=C:\apache-ant-1.6.2 - -REM location of Tomcat -set CATALINA_HOME=C:\jakarta-tomcat-5.0.25</source> - <p>When you finished editing <code>beehiveUser.cmd</code>, save and close the file.</p> - <p>Open a command shell.</p> - <p>cd to the directory where <code>beehiveUser.cmd</code> resides (= the top level directory of the Beehive distribution).</p> - <p>At the command prompt, enter: <code>beehiveUser.cmd</code> - </p> - </section> - <section> - <title>Add a Manager Role to Tomcat (Optional)</title> - <p>Adding the manager role to Tomcat server allows you to run deployment-related targets in the Ant file <code>BEEEHIVE_HOME/ant/runTomcat.xml</code>. This file is provided as a convenience for managing the Tomcat server.</p> - <p>Edit the file <code>CATALINA_HOME/conf/tomcat-users.xml</code> so it appears as follows. Elements to add are shown in bold type.</p> - <source><?xml version='1.0' encoding='utf-8'?> + <header> + <title>Beehive Installation and Setup</title> + </header> + <body> + <p>This topic explains how to install a Beehive distribution on your + machine. The instructions below are divided into (1) basic stetup steps + and tutorial-specific steps.</p> + <p> + Once you have completed the basic setup steps, + you can begin developing Beehive applications. You only need to + complete the tutorial-specific steps if you intend to run the Beehive + tutorials and samples.</p> + <section id="basic"> + <title>Basic Installation</title> + <p>(1) The following software is required for developing Beehive applications:</p> + <ul> + <li>Beehive Binary Distribution (download: <a class="fork" href="http://cvs.apache.org/dist/incubator/beehive/v1.0-alpha/bin/";>http://cvs.apache.org/dist/incubator/beehive/v1.0-alpha/bin/</a>)</li> + <li>J2SE5 (download: <a class="fork" href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</a>)</li> + <li>Ant 1.6.2 (download: <a class="fork" href="http://ant.apache.org/bindownload.cgi";>http://ant.apache.org/bindownload.cgi</a>)</li> + </ul> + <p>(2) Make sure that the following environmental variables are set in your shell.</p> + <ul> + <li><code>JAVA_HOME</code></li> + <li><code>ANT_HOME</code></li> + </ul> + <p> (Note: there is no <code>BEEHIVE_HOME</code> environmental variable to set.)</p> + <p>(3) Finally, ensure that <code>JAVA_HOME/bin</code> and <code>ANT_HOME/bin</code> are on your <code>PATH</code>.</p> + <p>That's it! That's all you need to begin developing Beehive + applications. The remaining steps are only necessary if you + intend to run the Beehive tutorials and samples.</p> + </section> + <section id="optional"> + <title>Optional Installation Steps</title> + <p>The following steps are only necessary if you intend to run the Beehive tutorials + (<a href="controls/tutorial_controls.html">Control Tutorial</a>, + <a href="pageflow/tutorial_pageflow.html">Page Flow Tutorial</a>, + and <a href="wsm/tutorial_wsm.html">Web Service Tutorial</a>).</p> + <p>(1) Install the latest Tomcat 5.0.xx distribution file. + Download: <a class="fork" + href="http://jakarta.apache.org/site/binindex.cgi#tomcat";>http://jakarta.apache.org/site/binindex.cgi#tomcat</a> + </p> + <p>(2) Ensure that the <code>TOMCAT_HOME</code> environmental variable is set in your shell.</p> + <p>(3) Edit the file + <code>TOMCAT_HOME/conf/tomcat-users.xml</code> so it + appears as follows. Elements to add are shown in bold + type.</p> + <source><?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="tomcat"/> <role rolename="role1"/> @@ -63,57 +58,84 @@ <user username="both" password="tomcat" roles="tomcat,role1"/> <strong><user username="manager" password="manager" roles="manager"/></strong> </tomcat-users></source> - </section> - <section> - <title>Start Tomcat (Optional)</title> - <p>Before running the samples and tutorials ensure that Tomcat is turned on. Run the following Ant command to startup Tomcat:</p> - <source>%CATALINA_HOME%\bin\startup.bat</source> - <p>Or use the Ant command provided in the distribution: </p> - <source>ant -f %BEEHIVE_HOME%\ant\buildWebapp.xml start</source> - <p>If you use the provided Ant command, you will have to press <code>Ctrl+C</code> to continue issuing commands in that command shell.</p> - </section> - <section> - <title>What Now?</title> - <p>You are now ready to begin developing Beehive applications. The following tutorials introduce the basic development cycle:</p> - <ul> - <li><a href="controls/tutorial_controls.html">Beehive Controls Tutorial</a></li> - <li><a href="pageflow/tutorial_pageflow.html">Beehive Page Flow Tutorial</a></li> - <li><a href="wsm/tutorial_wsm.html">Beehive Web Service Tutorial</a></li> - </ul> - <p>You can also begin running the following samples:</p> - <ul> - <li><a href="jpetstore.html">Beehive Sample: Petstore</a></li> - <li><a href="wsm/sample_Dashboard.html">Beehive Web Service Sample: Petstore Dashboard</a></li> - <li><a href="wsm/sample_AddressBook.html">Beehive AddressBookWS and EmployeeWS Samples</a></li> - <li><a href="controls/sample_controls-db.html">Database Control Sample</a></li> - </ul> - <p>The following application templates will help you get a project started:</p> - <ul> - <li><a href="pageflow/sample_netui-blank.html">Page Flow Project Template</a></li> - <li><a href="controls/sample_controls-blank.html">Control Project Template</a></li> - <li><a href="wsm/sample_wsm-blank.html">Web Service Project Template</a></li> - </ul> - </section> - - <section> - <title>Troubleshooting</title> - <p><strong>I Can't Decompress the <code>.tar.gz</code> File</strong></p> - <p>Note: The <code>.tar.gz</code> distribution files are created using Ant's <code><tar></code> task - (<a class="fork" href="http://ant.apache.org/manual/CoreTasks/tar.html";>http://ant.apache.org/manual/CoreTasks/tar.html</a>). - This generates - <code>.tar</code> files that can only be decompressed using a compatible <code>tar</code> utility.</p> - <p>Known compatible utilities include: - </p> - <ul> - <li>GNU tar 1.14 (<a class="fork" href="http://www.gnu.org/software/tar/manual/html_mono/tar.html";>http://www.gnu.org/software/tar/manual/html_mono/tar.html</a>)</li> - <li>WinZip 8.0</li> - <li>Ant's <code><untar></code> task (<a class="fork" href="http://ant.apache.org/manual/CoreTasks/unzip.html";>http://ant.apache.org/manual/CoreTasks/unzip.html</a>)</li> - </ul> - </section> - </body> - <footer> - <legal>Java, J2EE, and JCP are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.<br/> - © 2004, Apache Software Foundation - </legal> - </footer> -</document> + </section> + <section> + <title>What Now?</title> + <p>You are now ready to begin developing Beehive applications. The + following tutorials introduce the basic development cycle:</p> + <ul> + <li> + <a href="controls/tutorial_controls.html">Beehive Controls + Tutorial</a> + </li> + <li> + <a href="pageflow/tutorial_pageflow.html">Beehive Page Flow + Tutorial</a> + </li> + <li> + <a href="wsm/tutorial_wsm.html">Beehive Web Service + Tutorial</a> + </li> + </ul> + <p>You can also begin running the following samples:</p> + <ul> + <li> + <a href="jpetstore.html">Beehive Sample: Petstore</a> + </li> + <li> + <a href="wsm/sample_Dashboard.html">Beehive Web Service + Sample: Petstore Dashboard</a> + </li> + <li> + <a href="wsm/sample_AddressBook.html">Beehive AddressBookWS + and EmployeeWS Samples</a> + </li> + <li> + <a href="controls/sample_controls-db.html">Database Control + Sample</a> + </li> + </ul> + <p>The following application templates will help you get a project + started:</p> + <ul> + <li> + <a href="pageflow/sample_netui-blank.html">Page Flow + Project Template</a> + </li> + <li> + <a href="controls/sample_controls-blank.html">Control + Project Template</a> + </li> + <li> + <a href="wsm/sample_wsm-blank.html">Web Service Project + Template</a> + </li> + </ul> + </section> + <section> + <title>Troubleshooting</title> + <p> + <strong>I Can't Decompress the <code>.tar.gz</code> + File</strong> + </p> + <p>Note: The <code>.tar.gz</code> distribution files are created + using Ant's <code><tar></code> task (<a class="fork" + href="http://ant.apache.org/manual/CoreTasks/tar.html";>http://ant.apache.org/manual/CoreTasks/tar.html</a>). + This generates <code>.tar</code> files that can only be + decompressed using a compatible <code>tar</code> utility.</p> + <p>Known compatible utilities include: </p> + <ul> + <li>GNU tar 1.14 (<a class="fork" + href="http://www.gnu.org/software/tar/manual/html_mono/tar.html";>http://www.gnu.org/software/tar/manual/html_mono/tar.html</a>)</li> + <li>WinZip 8.0</li> + <li>Ant's <code><untar></code> task (<a class="fork" + href="http://ant.apache.org/manual/CoreTasks/unzip.html";>http://ant.apache.org/manual/CoreTasks/unzip.html</a>)</li> + </ul> + </section> + </body> + <footer> + <legal>Java, J2EE, and JCP are trademarks or registered trademarks of + Sun Microsystems, Inc. in the United States and other + countries.<br/> © 2004, Apache Software Foundation </legal> + </footer> +</document> \ No newline at end of file
