cziegeler 2002/07/05 02:08:27
Modified: src/documentation/xdocs/developing/webapps Tag:
cocoon_2_0_3_branch authentication.xml
src/documentation/xdocs/installing Tag: cocoon_2_0_3_branch
index.xml
Log:
Synced docs
Revision Changes Path
No revision
No revision
1.1.2.3 +6 -4
xml-cocoon2/src/documentation/xdocs/developing/webapps/authentication.xml
Index: authentication.xml
===================================================================
RCS file:
/home/cvs/xml-cocoon2/src/documentation/xdocs/developing/webapps/authentication.xml,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -r1.1.2.2 -r1.1.2.3
--- authentication.xml 2 Jul 2002 09:07:56 -0000 1.1.2.2
+++ authentication.xml 5 Jul 2002 09:08:27 -0000 1.1.2.3
@@ -134,20 +134,22 @@
<p>The <em>auth-login</em> action uses the handler parameter to call the
authentication resource of this handler. This authentication resource
needs to
know the information provided by the user. For each piece of information
an own
- parameter is created which name starting with "parameter_". So in the
example
+ parameter is created which name starts with "parameter_". So in the
example
above, the authentication resource gets two parameters: userid and
password. As
the values for these parameters were send by a form they need to be
passed on
to the authentication resource. If you use "{request:...}" for the value
of a
parameter, the <em>auth-login</em> action will pass the actual value of
that request
parameter to the authentication resource (by using the input modules
concept
of Cocoon).</p>
- <p>If the user is not authenticated with this handler, the framework calls
+ <p>If the user is not already authenticated with this handler, the
framework calls
the authentication resource and passes it the parameters. If this
- authentication is successful, the action returns an empty map and the
sitemap
+ authentication is successful, the action returns a map and the sitemap
commands inside the map:act are executed. If the authentication fails,
these
are skipped.</p>
<p>If the authentication is successful, a session object is created on
- the server (if not already done). </p>
+ the server (if not already done). If the authentication fails, the error
+ information delivered by the authentication resource is stored into the
+ <em>temporary</em> context (which is named simply 'temp').</p>
</s2>
<s2 title="The authentication resource">
<p>The last chapters described the authentication process but left out
No revision
No revision
1.18.2.8 +39 -5 xml-cocoon2/src/documentation/xdocs/installing/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/installing/index.xml,v
retrieving revision 1.18.2.7
retrieving revision 1.18.2.8
diff -u -r1.18.2.7 -r1.18.2.8
--- index.xml 26 Jun 2002 02:14:56 -0000 1.18.2.7
+++ index.xml 5 Jul 2002 09:08:27 -0000 1.18.2.8
@@ -229,7 +229,7 @@
</s1>
<s1 title="Building Cocoon">
- <p>If you downloaded binary distriution of the Cocoon, you can
+ <p>If you downloaded the binary distribution of Cocoon, you can
skip this chapter and proceed to the "Installing Cocoon".
</p>
@@ -274,7 +274,7 @@
</p>
<p>
A library/package is available to the build process when it is located
- in the <code>./lib/optional</code> directory.
+ in the <code>./lib/optional</code> or the <code>./lib/local</code> directory.
</p>
<p>
The following table contains a list of the optional components,
@@ -313,11 +313,22 @@
<td>No</td>
</tr>
</table>
- <p><strong>Note:</strong> If you added a library/package, you
+ <p>If you want to add additional libraries, put them in the
<code>./lib/local</code>
+ directory as this directory is not touched by CVS.
+ <strong>Note:</strong> If you added a library/package, you
need to rebuild Cocoon as described in 'Create the Cocoon WAR package'.
</p>
</s2>
-
+ <s2 title="Building a minimal Cocoon">
+ <p>If you want to build a minimal Cocoon, simply remove all optional libraries
+ from the <code>./lib/local</code> and the <code>./lib/optional</code>
directory.
+ Make a <code>build clean</code> and then a build with the target you want.
+ However, if you want to build a web application make sure you leave the
+ <code>servlet.jar</code> in the <code>./lib/optional</code> directory.
+ </p>
+ <p><strong>Note:</strong>This feature is only available in the latest
developer
+ version of Cocoon which you can find in the CVS. </p>
+ </s2>
<s2 title="Running the build">
<p>Cocoon uses <link href="http://jakarta.apache.org/ant/";>Jakarta Ant</link>
for the build and installation, and comes with a build script
@@ -367,6 +378,8 @@
<p>Cocoon targets place work files and results in a build directory
under the cocoon root. The only exception are the distribution targets
that build in a directory called dist.</p>
+ <p>The target you will most use is propably the <strong>webapp</strong>
+ target which builds a Cocoon web application. For more information see
below.</p>
<s4 title="build all">
<p>Builds all main Cocoon targets to create the
<strong>cocoon.jar</strong>
@@ -502,7 +515,9 @@
</s4>
<s4 title="build dist">
- <p>Creates source and binary distributions of Cocoon.
+ <p>Creates source and binary distributions of Cocoon. This target
+ is not intented for the usual Cocoon user; it's primary used
+ by the Cocoon developers to create a new distribution.
</p>
<ul>
@@ -534,6 +549,25 @@
<p>this will create the <code>cocoon.war</code> file in the
<code>./build/cocoon</code> directory. Follow instructions in the next
chapter to deploy this webapp in your container.</p>
+ <p>If you want a "clean" web application, you can specify these optional
+ properties:</p>
+ <ul>
+ <li>exclude.webapp.samples : to exclude the samples</li>
+ <li>exclude.webapp.documentation : to exclude the documentation</li>
+ <li>exclude.webapp.javadocs : to exclude the java docs</li>
+ </ul>
+ <p>So, if you first remove all libraries from the <code>./lib/local</code>
+ and the <code>./lib/optional</code> directory except the
<code>servlet.jar</code>
+ and then type:</p>
+<source>
+[unix] ./build.sh -Dinclude.webapp.libs=yes -Dexclude.webapp.samples=yes
+ -Dexclude.webapp.documenation=yes -Dexclude.webapp.javadocs=yes
webapp
+[win32] .\build.bat -Dinclude.webapp.libs=yes -Dexclude.webapp.samples=yes
+ -Dexclude.webapp.documenation=yes -Dexclude.webapp.javadocs=yes
webapp</source>
+ <p>you get a minimal Cocoon web application without any samples or
documentation.
+ But remember to make a <code>build clean</code> beforehand.</p>
+ <p><strong>Note:</strong>This feature is only available in the latest
developer
+ version of Cocoon which you can find in the CVS. </p>
</s4>
<s4 title="[BETA] build scratchpad">
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
