You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by st...@apache.org on 2004/12/16 00:25:52 UTC

svn commit: r112052 - /incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml

Author: steveh
Date: Wed Dec 15 15:25:49 2004
New Revision: 112052

URL: http://svn.apache.org/viewcvs?view=rev&rev=112052
Log:
Fix for BEEHIVE-91: build.xml's "build.dist.tgz" produces corrupt archive
 
Modified:
   incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml

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=112052&p1=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml&r1=112051&p2=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml&r2=112052
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml	(original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml	Wed Dec 15 15:25:49 2004
@@ -5,7 +5,7 @@
         <title>Beehive Installation and Setup</title>
     </header>
     <body>
-        <p>This topic explains how to install and set up the Beehive development environment on your machine.</p>
+        <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 (<fork href="http://cvs.apache.org/dist/incubator/beehive/v1.0-alpha/bin/">http://cvs.apache.org/dist/incubator/beehive/v1.0-alpha/bin/</fork>) 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>
@@ -93,6 +93,22 @@
             <li><link href="controls/sample_controls-blank.html">Control Project Template</link></li>
             <li><link href="wsm/sample_wsm-blank.html">Web Service Project Template</link></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>&lt;tar></code> task 
+            (<fork href="http://ant.apache.org/manual/CoreTasks/tar.html">http://ant.apache.org/manual/CoreTasks/tar.html</fork>).  
+            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 (<fork href="http://www.gnu.org/software/tar/manual/html_mono/tar.html">http://www.gnu.org/software/tar/manual/html_mono/tar.html</fork>)</li>
+                <li>WinZip 8.0</li>
+                <li>Ant's <code>&lt;untar></code> task (<fork href="http://ant.apache.org/manual/CoreTasks/unzip.html">http://ant.apache.org/manual/CoreTasks/unzip.html</fork>)</li>
+            </ul>
         </section>
     </body>
     <footer>