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 2005/04/19 20:07:29 UTC
svn commit: r161939 - in incubator/beehive/trunk/docs: ./
forrest/src/documentation/content/xdocs/
forrest/src/documentation/content/xdocs/controls/
forrest/src/documentation/content/xdocs/pageflow/
forrest/src/documentation/content/xdocs/wsm/
Author: steveh
Date: Tue Apr 19 11:07:27 2005
New Revision: 161939
URL: http://svn.apache.org/viewcvs?view=rev&rev=161939
Log:
Latest content, QA pass on tutorials.
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/site.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/tutorial_wsm.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/wsm_overview.xml
incubator/beehive/trunk/docs/updating_livesite.txt
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&r1=161938&r2=161939
==============================================================================
--- 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 Tue Apr 19 11:07:27 2005
@@ -33,9 +33,6 @@
variables set in your shell:</p>
<ul>
<li>
- <code>BEEHIVE_HOME</code>
- </li>
- <li>
<code>ANT_HOME</code>
</li>
<li>
@@ -84,7 +81,7 @@
in a text editor.</p>
<p>Edit the <code>beehive.home</code> property so it points to the
top-level folder of your beehive installation.</p>
- <p>Edit the <code>contextPath</code> property so it has the value
+ <p>Edit the <code>context.path</code> property so it has the value
<strong><code>control_tutorial</code></strong> (as shown below).</p>
<p>For example, if your beehive installation
resides at <code>C:/apache/apache-beehive-1.0</code>, then your <code>build.properties</code> file
@@ -159,9 +156,9 @@
<section id="edit_controller.jpf">
<title>Edit the Controller.jpf File</title>
<p>To test the Hello control, you need to call the control from some other
- resource, such as a JAVA application, JSP page, or Page Flow web application.
+ resource, such as a JAVA application, JSP page, a web application, etc.
In the following two steps you will call the
- control from the Contoller.jpf file and display the results
+ control from the Contoller class in a web application and display the results
on a JSP page.
</p>
<p>Open the file <code>C:/beehive_projects/control_tutorial/Controller.jpf</code> in a text editor.</p>
@@ -255,7 +252,7 @@
</section>
<section id="compile_2">
<title>To Compile and Deploy the Control</title>
- <p>You are now ready to compile the test webapp
+ <p>You are now ready to compile the test web application
and the imbedded the control.</p>
<p>At the command prompt, enter the following Ant command.</p>
<p>At the command prompt, enter:</p>
@@ -268,7 +265,7 @@
<strong>Copy and Paste version:</strong>
ant -f C:\beehive_projects\control_tutorial\WEB-INF\src\build.xml clean build war</source>
-<p>To deploy the web app, copy the WAR file into Tomcat's <code>webapps</code> directory.</p>
+<p>To deploy the web application, copy the WAR file into Tomcat's <code>webapps</code> directory.</p>
<source>copy C:\beehive_projects\control_tutorial.war %CATALINA_HOME%\webapps /Y</source>
</section>
<section id="test_2">
@@ -373,8 +370,8 @@
</section>
<section id="compile_3">
<title>To Compile and Redeploy the Control</title>
- <p>Compile and deploy the web application using the same command line statements used in the
- the previous step.</p>
+ <p>Compile and deploy the web application using the same command line statements used in
+ <a href="#compile_2">step 2</a>.</p>
</section>
<section id="test_3">
<title>To Test the Control</title>
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&r1=161938&r2=161939
==============================================================================
--- 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 Tue Apr 19 11:07:27 2005
@@ -63,18 +63,30 @@
that sets the build-related properties for your web application.</p>
<p>Open the file <code>C:/beehive_projects/pageflow_tutorial/WEB-INF/src/build.properties</code>
in a text editor.</p>
- <p>Edit the <code>beehive.home</code> property points to the
+ <p>Edit the <code>beehive.home</code> property so it points to the
top-level folder of your beehive installation.</p>
- <p>Add the line <strong><code>contextPath=pageflow_tutorial</code></strong> (as shown below).</p>
+ <p>Edit the <code>context.path</code> so it has the value <code>pageflow_tutorial</code>.</p>
+ <note>The <code>context.path</code> property determines both (1) the name of the application
+ WAR file and (2) the application URL.
+ <br/><br/>
+ If <code>context.path=myWebApp</code>, then the following
+ WAR file will be produced:
+ <br/><br/>
+ <strong><code>myWebApp</code></strong><code>.war</code>
+ <br/><br/>
+ and the following URL will invoke the web application
+ <br/><br/>
+ <code>http://somedomain/</code><strong><code>myWebApp</code></strong>
+ </note>
<p>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>
<source>beehive.home=<strong>C:/apache/apache-beehive-1.0</strong>
-<strong>contextPath=pageflow_tutorial</strong>
servlet-api.jar=${os.CATALINA_HOME}/common/lib/servlet-api.jar
jsp-api.jar=${os.CATALINA_HOME}/common/lib/jsp-api.jar
-</source>
+
+context.path=<strong>pageflow_tutorial</strong></source>
</section>
<section id="start_tomcat">
<title>To Start the Tomcat Server</title>
@@ -113,33 +125,24 @@
step, you will create a more complex Action method.
</p>
</section>
-<!-- <section id="copy_JARs">
- <title>To Copy Runtime JARs to the Project Folder</title>
- <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 C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml
- deploy-beehive
-
-<strong>Copy and Paste version:</strong>
-ant -f C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml deploy-beehive</source>
- <p>Before proceeding, confirm that the following directory structure exists:</p>
-<source>C:
- beehive_projects
- pageflow_tutorial
- WEB-INF
- lib
- [many JAR files]</source>
- </section>-->
<section id="examine">
<title>To Examine the <code>Controller.jpf</code> and <code>index.jsp</code> Files</title>
<p>There are no edits to make in this step. The point of this step is
to learn about the code you are about to run.</p>
<p>Open the file <code>C:/beehive_projects/pageflow_tutorial/Controller.jpf</code>.
- [todo: explain]</p>
+ </p>
+ <p>The Controller file is an ordinary Java class with methods and annotations.</p>
+ <p>Notice that a Page Flow controller class must extend
+ <code>org.apache.beehive.netui.pageflow.PageFlowController</code> and be decorated by the
+ annotation <code>@Jpf.Controller</code>.</p>
+ <p>The <code>onCreate()</code> method is executed whenever the Controller class is first
+ instantiated. The <code>onDestroy()</code> method is executed when the Controller
+ class is destroyed.</p>
+ <p>The Controller class is instantiated when a user calls it via the URL:</p>
+ <source>http://localhost:7001/tutorial_pageflow/Controller.jpf</source>
+ <p>When a Controller class is instantiated, first the <code>onCreate()</code> method is run,
+ and then the action <code>begin</code> is run. In this case, the <code>begin</code>
+ action forwards the user to the <code>index.jsp</code> page.</p>
<p><strong><code>Controller.jpf</code></strong></p>
<source>import javax.servlet.http.HttpSession;
@@ -176,7 +179,7 @@
}
}</source>
<p>Open the file <code>C:/beehive_projects/pageflow_tutorial/index.jsp</code>.
- [todo: explain]</p>
+ </p>
<p><strong><code>index.jsp</code></strong></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"%>
@@ -215,7 +218,7 @@
<section id="test_2">
<title>To Test the Page Flow Web Application</title>
<p>Visit the following address:</p>
- <p><a class="fork" href="http://localhost:8080/pageflow_tutorial">http://localhost:8080/pageflow_tutorial</a></p>
+ <p><a class="fork" href="http://localhost:8080/pageflow_tutorial/Controller.jpf">http://localhost:8080/pageflow_tutorial/Controller.jpf</a></p>
<p>You will be directed to the <code>index.jsp</code> page.</p>
</section>
</section>
@@ -296,19 +299,8 @@
<p>Save <code>Controller.jpf</code>.</p>
</section>
<section id="compile_3">
- <title>To Compile and Deploy the Page Flow</title>
- <p>You are now ready to compile the Page Flow and deploy it to Tomcat.</p>
- <p>At the command prompt, enter:</p>
-<source>ant
- -f C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml
- clean
- build
- war
-
-<strong>Copy and Paste version:</strong>
-ant -f C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml clean build war</source>
-<p>To deploy the application, copy the WAR file into Tomcat's <code>webapps</code> directory.</p>
-<source>copy C:\beehive_projects\pageflow_tutorial.war %CATALINA_HOME%\webapps</source>
+ <title>To Recompile and Redeploy the Page Flow</title>
+ <p>Compile and deploy the Page Flow using the same Ant commands used in <a href="#compile_2">step 2</a>.</p>
<p>If you are asked to overwrite the old WAR file, enter 'Yes'.</p>
<p>Wait a few seconds for Tomcat to redeploy the WAR file, then move on to the next step.</p>
</section>
@@ -317,7 +309,7 @@
<p>Visit the following link:
</p>
- <p><a class="fork" href="http://localhost:8080/pageflow_tutorial">http://localhost:8080/pageflow_tutorial</a></p>
+ <p><a class="fork" href="http://localhost:8080/pageflow_tutorial/Controller.jpf">http://localhost:8080/pageflow_tutorial/Controller.jpf</a></p>
<p>You will be directed to the index.jsp page.</p>
<p>Click the link.</p>
<p>You will be directed to page2.jsp.</p>
@@ -447,19 +439,8 @@
<p>Save <code>Controller.jpf</code>.</p>
</section>
<section id="compile_redeploy">
- <title>To Compile and Redeploy the Page Flow</title>
- <p>You are now ready to compile the Page Flow and deploy it to Tomcat.</p>
- <p>At the command prompt, enter:</p>
-<source>ant
- -f C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml
- clean
- build
- war
-
-<strong>Copy and Paste version:</strong>
-ant -f C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml clean build war</source>
-<p>To deploy the application, copy the WAR file into Tomcat's <code>webapps</code> directory.</p>
-<source>copy C:\beehive_projects\pageflow_tutorial.war %CATALINA_HOME%\webapps</source>
+ <title>To Recompile and Redeploy the Page Flow</title>
+ <p>Compile and deploy the Page Flow using the same Ant commands used in <a href="#compile_2">step 2</a>.</p>
<p>If you are asked to overwrite the old WAR file, enter 'Yes'.</p>
<p>Wait a few seconds for Tomcat to redeploy the WAR file, then move on to the next step.</p>
</section>
@@ -467,7 +448,7 @@
<title>To Test the Page Flow Web Application</title>
<p>Visit the following link:
</p>
- <p><a class="fork" href="http://localhost:8080/pageflow_tutorial">http://localhost:8080/pageflow_tutorial</a></p>
+ <p><a class="fork" href="http://localhost:8080/pageflow_tutorial/Controller.jpf">http://localhost:8080/pageflow_tutorial/Controller.jpf</a></p>
<p>You will be directed to the index.jsp page.</p>
<p>Click the link.</p>
<p>You will be directed to page2.jsp.</p>
@@ -528,19 +509,9 @@
<p>Save <code>Controller.jpf</code>.</p>
</section>
<section id="compile_5">
- <title>To Compile and Redeploy the Page Flow</title>
- <p>You are now ready to compile the Page Flow and deploy it to Tomcat.</p>
- <p>At the command prompt, enter:</p>
-<source>ant
- -f C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml
- clean
- build
- war
-<strong>Copy and Paste version:</strong>
-ant -f C:\beehive_projects\pageflow_tutorial\WEB-INF\src\build.xml clean build war</source>
-<p>To deploy the application, copy the WAR file into Tomcat's <code>webapps</code> directory.</p>
-<source>copy C:\beehive_projects\pageflow_tutorial.war %CATALINA_HOME%\webapps</source>
+ <title>To Recompile and Redeploy the Page Flow</title>
+ <p>Compile and deploy the Page Flow using the same Ant commands used in <a href="#compile_2">step 2</a>.</p>
<p>If you are asked to overwrite the old WAR file, enter 'Yes'.</p>
<p>Wait a few seconds for Tomcat to redeploy the WAR file, then move on to the next step.</p>
</section>
@@ -548,7 +519,7 @@
<title>To Test the Page Flow Web Application</title>
<p>Visit the following link:
</p>
- <p><a class="fork" href="http://localhost:8080/pageflow_tutorial">http://localhost:8080/pageflow_tutorial</a></p>
+ <p><a class="fork" href="http://localhost:8080/pageflow_tutorial/Controller.jpf">http://localhost:8080/pageflow_tutorial/Controller.jpf</a></p>
<p>You will be directed to the index.jsp page.</p>
<p>Click the link.</p>
<p>You will be directed to page2.jsp.</p>
Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml?view=diff&r1=161938&r2=161939
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml (original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml Tue Apr 19 11:07:27 2005
@@ -16,7 +16,7 @@
<tutorial_pageflow label="Page Flows" href="pageflow/tutorial_pageflow.html"/>
<tutorial_control label="Controls" href="controls/tutorial_controls.html"/>
<tutorial_wsm label="Web Services" href="wsm/tutorial_wsm.html"/>
- <tut_dbwebapp label="DB-Driven Web App" href="tutorial/tut_dbdrivenwebapp.html" />
+ <!--<tut_dbwebapp label="DB-Driven Web App" href="tutorial/tut_dbdrivenwebapp.html" />-->
</tutorials>
<pageflow label="Page Flows">
<pageflow_overview label="Overview" href="pageflow/pageflow_overview.html"/>
Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/tutorial_wsm.xml
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/tutorial_wsm.xml?view=diff&r1=161938&r2=161939
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/tutorial_wsm.xml (original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/tutorial_wsm.xml Tue Apr 19 11:07:27 2005
@@ -28,7 +28,6 @@
throughout this tutorial.</p>
<p>Before proceding, confirm that you have the following variables set in your shell:</p>
<ul>
- <li><code>BEEHIVE_HOME</code></li>
<li><code>ANT_HOME</code></li>
<li><code>JAVA_HOME</code></li>
<li><code>CATALINA_HOME</code></li>
@@ -77,10 +76,6 @@
</section>
<section id="step_2">
<title>Step 2: Run the Web Service Template</title>
- <!--<section>
- <title>Introduction</title>
- <p>[todo]</p>
- </section>-->
<section id="examine_JWS">
<title>To Examine the Blank.jws Web Service</title>
<p>You are now ready to compile and run the template web service already included
@@ -189,28 +184,18 @@
<p>The <code>@WebParam</code> you just added lets you pass a String parameter to the method over the web.</p>
</section>
<section id="compile_3">
- <title>To Compile and Redeploy the Web Service</title>
-
- <p>At the command prompt, enter:</p>
-<source>ant
- -f C:\beehive_projects\ws_tutorial\WEB-INF\build.xml
- -Dto.dir=%CATALINA_HOME%\webapps
- clean
- build
- deploy
-
-<strong>Copy and Paste version:</strong>
-ant -f C:\beehive_projects\ws_tutorial\WEB-INF\build.xml -Dto.dir=%CATALINA_HOME%\webapps clean build deploy</source>
+ <title>To Recompile and Redeploy the Web Service</title>
+<p>Recompile and redeploy the web service using the same Ant command from <a href="#compile_2">step 2</a>.</p>
</section>
<section id="test_3">
<title>To Test the Parameterized Method</title>
<p>Enter the following URL in the address bar of your browser. </p>
- <p><a class="fork" href="http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=Moon">http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=Moon</a></p>
+ <p><a class="fork" href="http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=World">http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=World</a></p>
<p>The following SOAP response appears in the browser:</p>
<source><![CDATA[<soapenv:Envelope>
<soapenv:Body>
<sayHelloWorldInParamResponse>
- <ns1:result>Hello, Moon!</ns1:result>
+ <ns1:result>Hello, World!</ns1:result>
</sayHelloWorldInParamResponse>
</soapenv:Body>
</soapenv:Envelope>
@@ -253,17 +238,8 @@
<p>Note that the method added, sayNothingOverTheWeb(), does not have the annotation @WebMethod, indicating that it cannot be invoked by SOAP messages over the web.</p>
</section>
<section id="compile_4">
- <title>To Compile and Redeploy the Web Service</title>
- <p>At the command prompt, enter:</p>
-<source>ant
- -f C:\beehive_projects\ws_tutorial\WEB-INF\build.xml
- -Dto.dir=%CATALINA_HOME%\webapps
- clean
- build
- deploy
-
-<strong>Copy and Paste version:</strong>
-ant -f C:\beehive_projects\ws_tutorial\WEB-INF\build.xml -Dto.dir=%CATALINA_HOME%\webapps clean build deploy</source>
+ <title>To Recompile and Redeploy the Web Service</title>
+<p>Recompile and redeploy the web service using the same Ant command from <a href="#compile_2">step 2</a>.</p>
</section>
<section id="test_4">
<title>To Test the Non-Web Invokable Method</title>
@@ -321,27 +297,18 @@
}</source>
</section>
<section id="compile_5">
- <title>To Compile and Redeploy the Web Service</title>
- <p>At the command prompt, enter:</p>
-<source>ant
- -f C:\beehive_projects\ws_tutorial\WEB-INF\build.xml
- -Dto.dir=%CATALINA_HOME%\webapps
- clean
- build
- deploy
-
-<strong>Copy and Paste version:</strong>
-ant -f C:\beehive_projects\ws_tutorial\WEB-INF\build.xml -Dto.dir=%CATALINA_HOME%\webapps clean build deploy</source>
+ <title>To Recompile and Redeploy the Web Service</title>
+<p>Recompile and redeploy the web service using the same Ant command from <a href="#compile_2">step 2</a>.</p>
</section>
<section id="test_5">
<title>To Test the SOAP-encoded Style</title>
<p>Enter the following URL in the address bar of your browser. </p>
- <p><a class="fork" href="http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=Moon">http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=Moon</a></p>
+ <p><a class="fork" href="http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=World">http://localhost:8080/tutorialWS/web/Blank.jws?method=sayHelloWorldInParam&greetee=World</a></p>
<p>The following SOAP response appears in the browser. Compare the RPC style below with the DOC style above.</p>
<source><![CDATA[<soapenv:Envelope>
<soapenv:Body>
<sayHelloWorldInParamResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
- <ns1:result xsi:type="xsd:string">Hello, Moon!</ns1:result>
+ <ns1:result xsi:type="xsd:string">Hello, World!</ns1:result>
</sayHelloWorldInParamResponse>
</soapenv:Body>
</soapenv:Envelope>]]></source>
Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/wsm_overview.xml
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/wsm_overview.xml?view=diff&r1=161938&r2=161939
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/wsm_overview.xml (original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/wsm_overview.xml Tue Apr 19 11:07:27 2005
@@ -31,10 +31,10 @@
as an implementation resource). The result is a web service implementation that is much
easier to learn and understand. Instead of keeping multiple Java clases and XML configuration
files in sync, the developer needs to edit only one file: the annotated Java class.</p>
- <p><strong>Containers</strong></p>
- <p>[todo]</p>
+ <!--<p><strong>Containers</strong></p>
+ <p>[todo]</p> -->
</section>
- <section>
+ <!--<section>
<title>Web Service Basics</title>
<p><strong>What Do Web Services Do?</strong></p>
<p>At the most basic level, web services are servlets that take requests (in the form
@@ -47,7 +47,7 @@
<p></p>
<p><strong></strong></p>
<p></p>
- </section>
+ </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/>
Modified: incubator/beehive/trunk/docs/updating_livesite.txt
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/updating_livesite.txt?view=diff&r1=161938&r2=161939
==============================================================================
--- incubator/beehive/trunk/docs/updating_livesite.txt (original)
+++ incubator/beehive/trunk/docs/updating_livesite.txt Tue Apr 19 11:07:27 2005
@@ -38,11 +38,11 @@
the SCP client with a SFTP (Secure File Transfer Protocol) client.
Before proceding, it is important that your umask (on
-cvs.apache.org) is set to "0002" so that group write is set on the uploaded
+people.apache.org) is set to "0002" so that group write is set on the uploaded
ZIP file. This insures that there are no permissions problems,
if someone else performs the next site update.
-Note, however, a umask setting of 0002 will not affect the files extracted from the ZIP file!
+Note, however, a umask setting of 0002 will *not* affect the files extracted from the ZIP file!
This is because files extracted via UNZIP do not have group-write permission by default!
You must change the permissions on this extracted files manually! See step (4) for details.