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.