You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lenya.apache.org by an...@apache.org on 2007/11/02 12:00:40 UTC

svn commit: r591298 [4/37] - in /lenya/sandbox/pubs/docu/content/authoring: 0033e320-8731-11dc-ae46-9e7b5d14892d/ 003a4bc0-8731-11dc-ae46-9e7b5d14892d/ 018a9980-8731-11dc-ae46-9e7b5d14892d/ 02f9e0f0-8731-11dc-ae46-9e7b5d14892d/ 043dd2a0-8731-11dc-ae46-...

Added: lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.1193910792700.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.1193910792700.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.1193910792700.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.1193910792700.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,249 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: unittests.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Writing Unit Tests</title>
+  </header>
+  <body>
+    <section>
+      <title>Introduction</title>
+      <p>Recommended resources</p>
+      <ul>
+        <li>
+<a href="http://www.junit.org">JUnit homepage</a>
+</li>
+        <li>
+<a href="http://junit.sourceforge.net/doc/cookbook/cookbook.htm">JUnit Cookbook</a> (Eric Gamma, Kent Beck)</li>
+        <li>
+<a href="http://junit.sourceforge.net/doc/cookstour/cookstour.htm">JUnit: A Cook's Tour</a> (Eric Gamma, Kent Beck)</li>
+        <li>
+<a href="http://junit.sourceforge.net/doc/testinfected/testing.htm">JUnitTest Infected: Programmers Love Writing Tests</a>
+</li>
+      </ul>
+    </section>
+
+<section>
+<title>Organization</title>
+<ul>
+<li>
+<p>  Put your test classes in <em>src/test</em>. </p>
+</li>
+<li>
+<p>  Add the ant task that executes your test to <em>src/targets/test-build.xml</em>. </p>
+
+</li>
+</ul>
+
+</section>
+<section>
+<title id="head-655f58cfc0972b961e3661ac08aac2ff99ca1b48">The Test Publication</title>
+
+<p>Most tests will need a publication in the install (servlet container) directory. To provide a predictable test publication, the clean <em>default</em> publication from the build directory is copied to the <em>test</em> publication in the installation directory. </p>
+<p>In the test buildfile, the test publication is setup by the <em>test.pub.prepare</em> target. The directory {{${install.dir}/lenya/pubs/test}} is deleted (so that the files created by former tests are removed), and the default publication is copied to this directory. Add this target to the <em>depends</em> attribute of your test target if you need the test publication. </p>
+
+</section>
+<section>
+<title id="head-65a89586ffaf2c23e63e3cf91ac1e6e40cd84cc6">The PublicationHelper</title>
+
+<p>To simplify the acces to a publication you can use the class <em>org.apache.lenya.cms.PublicationHelper</em>. It provides the following methods: </p>
+
+<source xml:space="preserve">
+    /**
+     * Initializes the object with the first parameters from the command
+     * line arguments &lt;code&gt;args&lt;/code&gt;. The remainder of the array is returned.
+     * @param args The command line arguments of the test.
+     * @return The remainder of the arguments after the publication
+     * parameters are extracted.
+     */
+    public static String[] extractPublicationArguments(String args[]);
+
+    /**
+     * Returns the publication.
+     * @return A publication object.
+     */
+    public static Publication getPublication();
+</source>
+
+<p>The <em>extractPublicationArguments(String[])</em> method extracts the first two strings from the <em>args</em> parameter. The first one is the servlet context path, the second is the publication ID. </p>
+<p>To make use of the PublicationHelper, you have to call the <em>extractPublicationArguments(String[])</em> method in the <em>main(String())</em> method of your <em>TestCase</em> class. This initializes the PublicationHelper: </p>
+
+<source xml:space="preserve">
+    public static void main(String[] args) {
+
+        // extract the arguments needed for setting up the publication
+        // only the remaining arguments are returned
+        args = PublicationHelper.extractPublicationArguments(args);
+
+        ...
+    }
+</source>
+
+</section>
+<section>
+<title id="head-8878fcb8bad4bee373aa2a9f486fa1b5ac58586c">A TestCase Skeleton</title>
+
+
+<source xml:space="preserve">
+public class MyTest extends TestCase {
+
+    // static fields to store test parameters
+    private File configFile;
+    ...
+    
+    /** Constructor. */
+    public MyTest(String test) {
+        super(test);
+    }
+
+    /**
+     * The main program.
+     * The parameters are set from the command line arguments.
+     *
+     * @param args The command line arguments.
+     */
+    public static void main(String[] args) {
+        args = PublicationHelper.extractPublicationArguments(args);
+        setConfigFile(args[0]);
+        TestRunner.run(getSuite());
+    }
+
+    /** Returns the test suite. */
+    public static Test getSuite() {
+        return new TestSuite(MyTest.class);
+    }
+
+    /** Tests whatever you want. */
+    public void testSomething() {
+        ...
+    }
+
+    /** Sets a parameter value. */
+    protected static void setConfigFile(String fileName) {
+        assertNotNull(string);
+        File publicationDirectory
+            = PublicationHelper.getPublication().getDirectory();
+        configFile = new File(publicationDirectory, fileName);
+        assertTrue(configFile.exists());
+    }
+
+    /** Returns a parameter value. */
+    protected static File getConfigFile() {
+        return configFile;
+    }
+}
+</source>
+
+</section>
+<section>
+<title id="head-d0a01800d3a5e8cc04a8fca0bdb4fd67dec4db20">Debugging a Test</title>
+
+<p>For debugging, it might be desired to run the test from an API. In this case, the <em>main(String[])</em> method is never executed. </p>
+<p>To provide the parameters, you can hardcode them as fallback in the TestCase.setup() method that is called before the test is invoked: </p>
+
+<source xml:space="preserve">
+    /** @see junit.framework.TestCase#setUp() */
+    protected void setUp() throws Exception {
+        if (getConfigFile() == null) {
+            String args[] = {
+                "D:\\Development\\build\\tomcat-4.1.24\\webapps\\lenya",
+                "test"
+            };
+            PublicationHelper.extractPublicationArguments(args);
+            setConfigFile("config/something.xconf");
+        }
+    }
+</source>
+
+</section>
+<section>
+<title id="head-d8c100285806e70cf61740be84709676e34fd9c4">The Test Buildfile</title>
+
+<p>The test buildfile is located at <em>src/targets/test-build.xml</em>. It contains the following common targets: </p>
+<ul>
+<li>
+<p>  <strong>test</strong> - Runs all tests. </p>
+</li>
+<li>
+<p>  <strong>tests.junit</strong> - Runs the JUnit tests. </p>
+
+</li>
+<li>
+<p>  <strong>tests.anteater</strong> - Runs the Anteater tests. </p>
+</li>
+<li>
+<p>  <strong>tests.prepare</strong> - Prepares the tests, e.g. compiles test classes. </p>
+</li>
+<li>
+<p>  <strong>test.pub.prepare</strong> - Prepares the test publication.  </p>
+
+</li>
+</ul>
+
+</section>
+<section>
+<title id="head-73e85ec07ad251e822d4a03aaf2f9a03b6473ec8">Adding the Test to the Buildfile</title>
+
+<p>To add your test to the buildfile, you create a target called <em>test.&lt;name&gt;</em>. </p>
+<p>If you use assertions (Java assertions, not the JUnit ones) in your test, it is important to enable them using the <em>-ea</em> or <em>-enableassertions</em> argument. </p>
+
+<source xml:space="preserve">
+  &lt;target name="test.my" depends="test.pub.prepare"&gt;
+    &lt;!-- My Test --&gt;
+    &lt;java fork="yes" classname="org.apache.lenya.cms.mypackage.MyTest"&gt;
+      &lt;jvmarg value="-enableassertions"/&gt;
+
+      &lt;arg value="${install.dir}"/&gt;           // PublicationHelper
+      &lt;arg value="test"/&gt;                     // PublicationHelper
+      &lt;arg value="config/something.xconf"/&gt;   // MyTest
+
+      &lt;classpath refid="classpath"/&gt;
+
+      &lt;classpath&gt;
+        &lt;pathelement location="${build.test}" /&gt;
+        &lt;pathelement path="${build.root}/lenya/webapp/WEB-INF/classes" /&gt;
+        &lt;fileset dir="${build.root}/lenya/webapp/WEB-INF/lib"&gt;
+          &lt;include name="ant**.jar"/&gt;
+        &lt;/fileset&gt;
+
+      &lt;/classpath&gt;
+    &lt;/java&gt;
+  &lt;/target&gt;
+</source>
+<p>Finally, you have to add the test to the <em>tests.junit</em> target: </p>
+
+<source xml:space="preserve">
+
+&lt;target name="tests.junit" depends="init, tests.prepare, ..., test.my"&gt;
+</source>
+<p>Now you can run the tests: </p>
+
+<source xml:space="preserve">
+$LENYA_HOME &gt; build test
+</source>
+<p>If you want to call your test independently, you have to call the preparation targets before: </p>
+
+<source xml:space="preserve">
+$LENYA_HOME &gt; build init
+$LENYA_HOME &gt; build tests.prepare
+$LENYA_HOME &gt; build test.my
+
+</source>
+</section>    
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Unit Tests</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910792700.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910792700.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910792700.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910792700.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Unit Tests</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/1092ddc0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910792700" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910765840"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781621846" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781610667"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.1193910791324.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.1193910791324.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.1193910791324.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.1193910791324.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  
+  http://www.apache.org/licenses/LICENSE-2.0
+  
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: index.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Apache Lenya Documentation</title>
+  </header>
+  <body>
+    <p>
+      This is a Forrest Document 2.0 sample.
+    </p>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Components</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791324.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791324.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791324.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791324.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Components</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/109a09b0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910791324" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910764735"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781623864" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781613127"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.1193910801054.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.1193910801054.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.1193910801054.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.1193910801054.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  
+  http://www.apache.org/licenses/LICENSE-2.0
+  
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: index.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Apache Lenya Documentation</title>
+  </header>
+  <body>
+    <p>
+      This is a Forrest Document 2.0 sample.
+    </p>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Access Control</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801054.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801054.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801054.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801054.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Access Control</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/10b0ed10-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910801054" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771226"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781633568" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781612062"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.1193910793145.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.1193910793145.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.1193910793145.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.1193910793145.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,137 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: terms.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>Basic Terms</title>
+		
+		
+		
+	</header>
+
+  <body>
+	
+<section>
+	<title>Role</title>
+	<p>
+<em>Role</em>s are the connection between access control and CMS functionality. On
+		the access control side, you assign <em>Role</em>s to users, IP address ranges and
+		groups at certain URL spaces. On the CMS side, you define which <em>Role</em>s are
+		needed to execute certain usecases and workflow transitions. If the client has a certain
+		<em>Role</em>, this means he is allowed to do something.</p>
+	<p>Each <em>Role</em> has a unique name. Role names can be arbitrary strings. Examples are</p>
+	<ul>
+		<li>author</li>
+		<li>reviewer</li>
+		<li>admin</li>
+	</ul>
+	<p>Another common approach and useful is to use verbs as role names:</p>
+	<ul>
+		<li>edit</li>
+		<li>review</li>
+		<li>administrate</li>
+	</ul>
+</section>
+
+
+<section>
+	<title>Identifiable</title>
+	<p>An <em>Identifiable</em> is a characteristic of the client that can be identified.
+		Every <em>Identifiable</em> is <em>Accreditable</em>. Lenya currently supports the following
+		<em>Identifiable</em>s:</p>
+	<ul>
+		<li>users</li>
+		<li>machines</li>
+		<li>the world (this idenitifiable is assigned to every client that tries to
+			access the system)</li>
+	</ul>
+</section>
+
+
+<section>
+<title>Identity</title>
+	<p>An <em>Identity</em> is the collection of all <em>Identifiable</em>s
+	  that have access to the
+		system in the current session. The <em>Identity</em> always contains the world and
+		the machine that produced the request. If you logged in, the user is also
+		contained in the <em>Identity</em>.</p>
+	<p>For instance, if you log in from the machine 192.168.0.16 as the user john,
+		the <em>Identity</em> of the client contains</p>
+  <ul>
+    <li>the machine 192.168.0.16,</li>
+    <li>the user john, and</li>
+    <li>the world.</li>
+  </ul>
+</section>
+
+
+<section>
+<title>Accreditable</title>
+  <p>An <em>Accreditable</em> can be accredited with <em>Role</em>s in <em>Policies</em>.
+	Lenya currently supports the following <em>Accreditable</em>s:</p>
+	<ul>
+		<li>users</li>
+		<li>machines (accredition not implemented, use IP ranges instead)</li>
+		<li>IP address ranges</li>
+		<li>the world</li>
+		<li>groups</li>
+	</ul>
+</section>
+
+
+<section>
+	<title>Credential</title>
+	<p>A <em>Credential</em> assigns a set of <em>Role</em>s to an <em>Accreditable</em>, e.g.:</p>
+	<ul>
+		<li>
+<code>news_editors: editor, reviewer</code>
+<br/> means "The group 
+			<code>news_editors</code> has the <em>Role</em>s <code>editor</code> and <code>
+			reviewer</code>."</li>
+	</ul>
+</section>
+
+
+<section>
+	<title>Policy</title>
+	<p>A <em>Policy</em> defines a set of <em>Credential</em>s for a certain URL. It has the
+		responsibility to return all <em>Role</em>s of an <em>Accreditable</em> at a certain URL.</p>
+	<p>If for instance the <em>Policy</em> for the URL /tv/news contains the <em>Credential</em>s</p>
+	<ul>
+		<li>
+			<code>news_editors: editor, reviewer</code>
+		</li>
+		<li>
+			<code>john: admin</code>
+		</li>
+		<li>
+			<code>192.168.0.72: visitor</code>
+		</li>
+	</ul>
+	<p>and user <code>john</code> belongs to the group <code>news_editors</code> 
+		and has logged in from the machine <code>192.168.0.72</code>, the <em>Policy</em>
+		returns the <em>Role</em>s <code>editor, reviewer, admin, visitor</code> for the
+		<em>Accreditable</em> <code>john</code>.</p>
+	<p>A <em>Policy</em> may not contain invalid <em>Accreditable</em>s.
+	  E.g., if a user is deleted
+		and another user with the same ID is created, he may not get the same
+		privileges as the former one.</p>
+</section>
+
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Basic Terms</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793145.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793145.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793145.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793145.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Basic Terms</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/11e3a0b0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910793145" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766205"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781629901" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781609562"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.1193910781233.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.1193910781233.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.1193910781233.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.1193910781233.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: accesscontrollers.xml 43161 2004-07-30 22:50:28Z thorsten $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>Access Controllers</title>
+		
+		
+	</header>
+
+  <body>
+	
+<section>
+	<title>Introduction</title>
+	<p>An <em>AccessController</em> has the responsibility to authenticate
+	  clients and to authorize requests.</p>
+</section>
+<section>
+	<title>Defining the Role in lenya.roles</title>
+	<source xml:space="preserve"><![CDATA[<role name="org.apache.lenya.ac.AccessController"
+    shorthand="access-controller"
+    default-class="org.apache.lenya.ac.impl.BypassableAccessController"/>]]></source>
+</section>
+
+<section>
+	<title>Declaring an AccessController in cocoon.xconf</title>
+	
+	<p>
+		Each <em>AccessController</em> component needs a type that is attached to the
+		<code>role</code> attribute, separated with a slash (/). This allows you to choose an
+		<em>AccessController</em> in your publication in combination with the
+		Publication<a href="accesscontrollerresolvers.html">AccessControllerResolver</a>.
+		The following example shows the declaration of an <em>AccessController</em> with
+		the type <em>bypassable</em>:
+	</p>
+	
+	<source xml:space="preserve"><![CDATA[<component logger="lenya.ac.accesscontroller.bypassable"
+    class="org.apache.lenya.ac.impl.BypassableAccessController"
+    role="org.apache.lenya.ac.AccessController/bypassable">
+    ...
+</component>]]></source>
+
+</section>
+
+	<section>
+		<title>Default Access Controller</title>
+		<p>The <em>DefaultAccessController</em> combines an
+			<a href="authenticators.html">Authenticator</a>, a set of
+			<a href="authorizers.html">Authorizers</a>, an
+			<a href="accreditablemanagers.html">AccreditableManager</a> and a
+			<a href="policymanagers.html">PolicyManager</a> to perform these tasks.</p>
+			<source xml:space="preserve"><![CDATA[<component logger="lenya.ac.accesscontroller.default"
+    class="org.apache.lenya.ac.impl.DefaultAccessController"
+    role="org.apache.lenya.ac.AccessController/default"/>]]></source>
+	</section>
+
+<section>
+	<title>Bypassable Access Controller</title>
+	<p>The <em>BypassableAccessController</em> is a <em>DefaultAccessController</em> that can be
+		bypassed for certain URL patterns. For URLs that match those patterns
+		(regular expressions), access is granted for free.</p>
+		
+			<p>
+				The <em>BypassableAccessController</em>
+				allows the definition of a regular expression for the public URL
+				patterns:
+			</p>
+			<source xml:space="preserve"><![CDATA[<component logger="lenya.ac.accesscontroller.bypassable"
+    class="org.apache.lenya.ac.impl.BypassableAccessController"
+    role="org.apache.lenya.ac.AccessController/bypassable">
+  <public>.*[.]css|.*[.]jpg|.*[.]gif</public>
+</component>]]></source>
+</section>
+
+<section>
+	<title>Customizing Access Control</title>
+	<p>
+		<strong>How can I store my users in a database?</strong>
+	</p>
+	<p>You have to implement a <em>UserManager</em> wich accesses the database 
+		to obtain the user information. Additionally, you have to implement an 
+		<em>AccreditableManager</em> which uses this <em>UserManager</em>. This 
+		<em>AccreditableManager</em> has to be declared in 
+		<code>cocoon.xconf</code> and assigned to your 
+		<em>AccessController</em> in 
+		<code>lenya/pubs/mypub/config/ac/ac.xconf</code>. </p>
+</section>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Access Controllers</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910781233.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910781233.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910781233.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910781233.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Access Controllers</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/13084a90-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910781233" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766738"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781628374" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781608070"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.1193910801388.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.1193910801388.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.1193910801388.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.1193910801388.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,152 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: accesscontrollerresolvers.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>Access Controller Resolvers</title>
+		
+		
+		
+	</header>
+
+  <body>
+	
+<section>
+	<title>Introduction</title>
+	<p>
+	In Lenya, the <em>AccessController</em> is chosen dynamically,
+	depending on the requested URL.
+	An <em>AccessControllerResolver</em> resolves the appropriate
+	<em>AccessController</em> for a URL.</p>
+</section>
+
+<section>
+	<title>Defining the Roles in lenya.roles</title>
+	
+	<p>To obtain an <em>AccessControllerResolver</em>, the <em>AccessControllerResolverSelector</em> is
+		used. A component which wants to obtain an <em>AccessController</em> asks the
+		selector for the <em>ComposableAccessControllerResolver</em>.
+		The <em>ComposableAccessControllerResolver</em> itself uses the
+		selector to obtain its child <em>AccessControllerResolver</em>s.
+		</p>
+	
+	<source xml:space="preserve"><![CDATA[<role name="org.apache.lenya.ac.AccessControllerResolverSelector"
+    shorthand="access-controller-resolvers"
+    default-class="org.apache.avalon.excalibur.component.ExcaliburComponentSelector">
+  <hint shorthand="configurable"
+      class="org.apache.lenya.ac.impl.ConfigurableAccessControllerResolver"/>
+  <hint shorthand="publication"
+      class="org.apache.lenya.cms.ac.PublicationAccessControllerResolver"/>
+  <hint shorthand="composable"
+      class="org.apache.lenya.ac.impl.ComposableAccessControllerResolver"/>
+</role>]]></source>
+	
+</section>
+
+<section>
+	<title>Declaring the Access Controller Resolvers in cocoon.xconf</title>
+	
+	<source xml:space="preserve"><![CDATA[<access-controller-resolvers>
+  <component-instance logger="lenya.ac.accesscontrollerresolver.publication"
+    class="org.apache.lenya.cms.ac.PublicationAccessControllerResolver"
+    name="publication">
+  </component-instance>
+  <component-instance logger="lenya.ac.accesscontrollerresolver.global"
+    class="org.apache.lenya.ac.impl.ConfigurableAccessControllerResolver"
+    name="global">
+    <access-controller type="global"/>
+  </component-instance>
+  <component-instance logger="lenya.ac.accesscontrollerresolver.composable"
+    class="org.apache.lenya.ac.impl.ComposableAccessControllerResolver"
+    name="composable">
+    <resolver type="publication"/>
+    <resolver type="global"/>
+  </component-instance>
+</access-controller-resolvers>]]></source>
+	
+</section>
+
+<section>
+	<title>Publication Access Controller Resolver</title>
+	<p>The <em>PublicationAccessControllerResolver</em> looks for a <code>config/ac.xconf</code>
+    file inside the publication. If you want to use multiple <em>AccessController</em>s
+    within your Lenya installation, just declare them in the <code>
+    cocoon-xconf.xsl</code> file and choose the type in the <code>config/ac.xconf</code> file.
+    The <code>type</code> attribute selects an <em>AccessController</em>
+    from the definitions in <code>cocoon.xconf</code>.
+  </p>
+  <p>
+		You have to configure the complete <em>AccessController</em> in this file. For instance,
+		if you want to use a <em>BypassableAccessController</em> together with
+		a certain set of components, you declare it as follows:</p>
+	<source xml:space="preserve"><![CDATA[<?xml version="1.0"?>
+<access-controller type="bypassable">
+  
+  <accreditable-manager type="file">
+    <parameter name="directory"
+        value="context:///lenya/pubs/mypub/config/ac/passwd"/>
+  </accreditable-manager>
+  
+  <policy-manager type="document">
+    <policy-manager type="file">
+      <parameter name="directory"
+          value="context:///lenya/pubs/mypub/config/ac/policies"/>
+    </policy-manager>
+  </policy-manager>
+  
+  <authorizer type="policy"/>
+  
+  <authorizer type="usecase">
+    <parameter name="configuration"
+        value="context:///lenya/pubs/default/config/ac/usecase-policies.xml"/>
+  </authorizer>
+  
+  <authorizer type="workflow"/>
+  
+</access-controller>
+]]></source>
+</section>
+
+<section>
+	<title>Configurable Access Controller Resolver</title>
+	<p>The <em>ConfigurableAccessControllerResolver</em> can be configured with an
+		<em>AccessController</em> directly inside <code>cocoon.xconf</code>:</p>
+	<source xml:space="preserve"><![CDATA[<component-instance logger="lenya.ac.accesscontrollerresolver"
+    class="org.apache.lenya.ac.impl.ConfigurableAccessControllerResolver"
+    name="global">
+  <access-controller type="global"/>
+</component-instance>]]> </source>
+</section>
+
+<section>
+	<title>Composable Access Controller Resolver</title>
+	<p>The <em>ComposableAccessControllerResolver</em> is configured with a list of
+		<em>AccessControllerResolver</em>s. Each one of these resolvers is invoked until one
+		is successful. If no resolver finds an <em>AccessController</em>, the
+		<em>ComposableAccessControllerResolver</em> returns <code>null</code>.</p>
+		
+	<source xml:space="preserve"><![CDATA[<component-instance logger="lenya.ac.accesscontrollerresolver"
+    class="org.apache.lenya.ac.impl.ComposableAccessControllerResolver"
+    name="composable">
+  <resolver type="publication"/>
+  <resolver type="global"/>
+</component-instance>]]></source>
+</section>
+
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Access Controller Resolvers</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801388.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801388.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801388.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801388.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Access Controller Resolvers</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/143cabe0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910801388" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771400"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781626864" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781606000"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.1193910787811.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.1193910787811.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.1193910787811.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.1193910787811.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: authenticators.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>Authenticators</title>
+	</header>
+
+  <body>
+	
+<section>
+	<title>Introduction</title>
+	<p>
+	An authenticator is used to identify a client.
+	It is supposed to setup the <em>Identity</em> object which is attached
+	to the session.
+	</p>
+</section>
+
+<section>
+	<title>Declaring the Roles in lenya.roles</title>
+	<source xml:space="preserve"><![CDATA[<role name="org.apache.lenya.ac.Authenticator"
+    shorthand="authenticator"
+    default-class="org.apache.lenya.ac.impl.UserAuthenticator"/>]]></source>
+</section>
+
+	<section>
+		<title>The user authenticator</title>
+		<p>The <em>UserAuthenticator</em> uses the request parameters</p>
+		<ul>
+			<li>
+<code>username</code> and</li>
+			<li>
+<code>password</code>
+</li>
+		</ul>
+		<p>to authenticate or reject a user. It is configured in <code>cocoon.xconf</code>
+		as follows:</p>
+		
+	<source xml:space="preserve"><![CDATA[<component logger="lenya.ac.authenticator"
+    class="org.apache.lenya.ac.impl.UserAuthenticator"
+    role="org.apache.lenya.ac.Authenticator"/>]]></source>
+    
+    <p>
+      When a valid username/password combination is entered, the previous
+      user is removed from the session <em>Identity</em> object
+      and the current user is added.
+    </p>
+		
+	</section>
+
+	<section>
+		<title>The anonymous authenticator</title>
+		<p>The <em>AnonymousAuthenticator</em> authenticates the request against the credentials of the user called 'anonymous' 
+     (which you have to create, and assign the desired permissions). This is useful in conjunction with client certificates.  It is configured in <code>cocoon.xconf</code>
+		as follows (commented out by default):</p>
+		
+	<source xml:space="preserve"><![CDATA[<component logger="lenya.ac.authenticator"
+    class="org.apache.lenya.ac.impl.AnonymousAuthenticator"
+    role="org.apache.lenya.ac.Authenticator"/>]]></source>
+	</section>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Authenticators</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787811.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787811.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787811.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787811.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Authenticators</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/15601d40-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910787811" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771607"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781616704" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781603894"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.1193910799325.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.1193910799325.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.1193910799325.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.1193910799325.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: authorizers.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>Authorizers</title>
+		
+		
+		
+	</header>
+
+  <body>
+	
+<section>
+	<title>Introduction</title>
+	<p>An <em>Authorizer</em> checks if an <em>Identity</em> is authorized
+	to invoke a certain request.
+	</p>
+	
+	<p>
+	The <em>DelegatingAuthorizerAction</em> tries to
+	resolve an <em>AccessController</em> for the URL. If an <em>AccessController</em>
+	could be resolved, its <code>authorize(Request)</code> method is used to authorize the request.
+	If no <code>AccessController</code> could be found, the access to the request
+	is granted for free.</p>
+	
+	<p>
+	  The <em>DefaultAccessController</em> delegates the authorization to its
+	  <em>Authorizer</em>s. Only when all <em>Authorizer</em>s return <code>true</code>,
+	  the request is authorized.
+	</p>
+</section>
+	
+	<section>
+		<title>PolicyAuthorizer</title>
+		<p>A <em>PolicyAuthorizer</em> uses <em>Policies</em> for authorizing. It returns <code>true</code>,
+		when the current <em>Identity</em> has at least one <em>Role</em> for the requested URL.</p>
+	</section>
+	
+	<section>
+		<title>UsecaseAuthorizer</title>
+		<p>This <em>Authorizer</em> looks for the <code>lenya.usecase</code> request
+			parameter and checks the usecase policy file for the <em>Role</em>s that are
+			allowed to execute this usecase. The location of this file is defined
+			using the <code>configuration</code> parameter which points to a URL:</p>
+		<source xml:space="preserve"><![CDATA[<authorizer type="usecase">
+  <parameter name="configuration"
+      value="context:///lenya/pubs/mypub/config/ac/usecase-policies.xml"/>
+</authorizer>]]></source>
+
+		<p>The usecase policy file might look as follows:</p>
+		
+		<source xml:space="preserve"><![CDATA[<?xml version="1.0"?>
+<usecases xmlns="http://apache.org/cocoon/lenya/ac/1.0">
+  <usecase id="create">
+    <role id="editor"/>
+  </usecase>
+  <usecase id="rename">
+    <role id="editor"/>
+  </usecase>
+</usecases>]]></source>
+	</section>
+	
+	<section>
+		<title>WorkflowAuthorizer</title>
+		<p>The <em>WorkflowAuthorizer</em> is responsible for protecting workflow
+			transitions. Therefore it</p>
+		<ul>
+			<li>looks for the <code>lenya.event</code> request parameter,</li>
+			<li>determines the current state of the workflow instance, and</li>
+			<li>checks if the event may be invoked by one of the current <em>Role</em>s in this
+				state.</li>
+		</ul>
+		
+		<p>The <em>WorkflowAuthorizer</em> has no configuration options:</p>
+		
+		<source xml:space="preserve"><![CDATA[<authorizer type="workflow"/>]]></source>
+	</section>
+	
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Authorizers</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799325.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799325.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799325.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799325.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Authorizers</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/168f4e70-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910799325" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910770158"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781633906" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781612635"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.1193910794920.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.1193910794920.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.1193910794920.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.1193910794920.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,181 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: policymanagers.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>Policies and Policy Managers</title>
+		
+		
+		
+	</header>
+
+  <body>
+    
+<section>
+<title>Policies</title>
+<p>
+  A <code>Policy</code> assigns <code>Role</code>s to <code>Accreditable</code>s.
+</p>
+<p>
+  There is a common policy definition XML schema which is handled by the
+  <code>PolicyBuilder</code>. It can be used together with the
+  <code>FilePolicyManager</code> and the <code>SitemapPolicyManager</code>.
+</p>
+<p>Here is an example of a policy definition:</p>
+<source xml:space="preserve"><![CDATA[
+<policy xmlns="http://apache.org/cocoon/lenya/ac/1.0">
+
+  <user id="lenya">
+    <role id="editor"/>
+    <role id="reviewer"/>
+  </group>
+
+  <group id="reviewer">
+    <role id="reviewer"/>
+  </group>
+  
+  <ip-range id="localhost">
+    <role id="editor"/>
+  </ip-range>
+  
+  <world>
+    <role id="visitor"/>
+  </world>
+
+</policy> 
+]]></source>
+</section>
+	
+<section>
+	<title>Policy Managers</title>
+	<p>A <em>PolicyManager</em> is used to resolve the policy for a certain URL.
+	Lenya ships with the following <em>PolicyManager</em>s:</p>
+</section>
+	
+	<section>
+		<title>Inheriting Policy Manager</title>
+		<p>This is an abstract base class. It merges the policies
+		  of all steps in the URL. For each
+			URL, a <em>url policy</em> and a <em>subtree policy</em> can be defined.
+			The <em>InheritingPolicyManager</em> adds the credentials of</p>
+		<ul>
+			<li>the subtree policies for all parent directories of the requested page,</li>
+			<li>the subtree policy of the requested page, and</li>
+			<li>the url policy of the requested page.</li>
+		</ul>
+		<p>For instance, if the URL is <code>/lenya/news/index.html</code>, the
+			following policies are merged:</p>
+		<ul>
+			<li>subtree policy of <code>/</code>
+</li>
+			<li>subtree policy of <code>/lenya</code>
+</li>
+			<li>subtree policy of <code>/lenya/news</code>
+</li>
+			<li>subtree policy of <code>/lenya/news/index.html</code>
+</li>
+			<li>url policy of <code>/lenya/news/index.html</code>
+</li>
+		</ul>
+	</section>
+	
+	<section>
+		<title>File Policy Manager</title>
+		<p>The <em>FilePolicyManager</em> is an <em>InheritingPolicyManager</em>.
+		The policies are defined by policy files that are arranged as a
+		directory tree that reflects the URI space, e.g.:
+			</p>
+<source xml:space="preserve">/subtree-policy.acml
+/lenya/subtree-policy.acml
+/lenya/news/index.html/subtree-policy.acml
+/lenya/news/index.html/url-policy.acml</source>
+			<p>If a certain policy file does not exist (like /lenya/news in the above example), an empty policy is used instead.</p>
+			
+			<p>The <em>FilePolicyManager</em> needs a <code>directory</code> parameter
+			which contains a URL pointing to the policies directory:</p>
+
+<source xml:space="preserve"><![CDATA[<policy-manager type="file">
+  <parameter name="directory"
+      value="context:///lenya/pubs/mypub/config/ac/policies"/>
+</policy-manager>]]></source>
+
+	</section>
+	
+	<section>
+		<title>Document Policy Manager Wrapper</title>
+		<p>This <em>InheritingPolicyManager</em> subclass is used together with another
+  		<em>InheritingPolicyManager.</em>
+		  It is able to apply a single policy to all versions of a document
+		  (languages, print version, ...). E. g., if you define
+		</p>
+		<ul>
+<li>
+<code>/foo/bar/subtree-policy.xml</code>
+</li>
+</ul>
+		<p>
+		  and you use the <em>DefaultDocumentBuilder</em>,
+		  this policy is applied to the URLs
+		</p>
+		<ul>
+		  <li>
+<code>/foo/bar.html</code>
+</li>
+		  <li>
+<code>/foo/bar_de.html</code>
+</li>
+		  <li>
+<code>/foo/bar_en.print.html</code>
+</li>
+		  <li>...</li>
+		</ul>
+		
+		<p>To configure the <em>DefaultDocumentBuilder</em>, just put the
+		declaration of the wrapped <em>PolicyManager</em> inside the
+		<em>DefaultDocumentBuilder</em> declaration:</p>
+		
+<source xml:space="preserve"><![CDATA[<policy-manager type="document">
+  <policy-manager type="file">
+    <parameter name="directory"
+        value="context:///lenya/pubs/mypub/config/ac/policies"/>
+  </policy-manager>
+</policy-manager>]]></source>
+	</section>
+	
+	<section>
+		<title>Sitemap Policy Manager</title>
+		<p>The <em>SitemapPolicyManager</em> uses the policy sitemap to resolve the policy
+			for a certain URL. For this purpose it sends a request of the form
+    </p>
+	  <source xml:space="preserve">cocoon://{publication-id}/policies{url}.acml
+
+Example:
+cocoon://mypub/policies/authoring/foo/bar_de.html.acml
+</source>
+	  <p>
+			which is processed by <code>global-sitemap.xmap</code> and forwarded
+			to <code>lenya/pubs/{publication-id}/policies-sitemap.xmap</code>.
+			The request is supposed to return a valid policy XML document.
+	</p>
+	<p>The configuration of the <em>SitemapPolicyManager</em> is very simple:</p>
+	
+<source xml:space="preserve"><![CDATA[<policy-manager type="sitemap"/>]]></source>
+	</section>
+		
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Policies and Policy Managers</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794920.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794920.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794920.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794920.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Policies and Policy Managers</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/17bf9110-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910794920" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766914"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781620438" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781608712"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.1193910793821.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.1193910793821.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.1193910793821.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.1193910793821.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: accreditablemanagers.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>Accreditable Managers</title>
+		
+		
+		
+	</header>
+
+  <body>
+	
+		<section>
+			<title>Introduction</title>
+			<p>
+			An <em>AccreditableManager</em> combines a <em>UserManager</em>,
+			a <em>GroupManager</em>, an <em>IPRangeManager</em> and a <em>RoleManager</em>.</p>
+		</section>
+		<section>
+			<title>UserManager</title>
+			<p>A UserManager manages users.</p>
+		</section>
+		<section>
+			<title>GroupManager</title>
+			<p>A GroupManager manages groups.</p>
+		</section>
+		<section>
+			<title>IPRangeManager</title>
+			<p>A IPRangeManager manages IP address rangess.</p>
+		</section>
+		<section>
+			<title>RoleManager</title>
+			<p>A RoleManager manages <em>Role</em>s.</p>
+		</section>
+	
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Accreditable Managers</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793821.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793821.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793821.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793821.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Accreditable Managers</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/18e60fb0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910793821" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766308"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781633236" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781611468"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.1193910780262.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.1193910780262.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.1193910780262.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.1193910780262.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: ssl.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+	<header>
+		<title>SSL Encryption</title>
+		
+		
+		
+	</header>
+
+  <body>
+	
+<section>
+	<title>Introduction</title>
+	<p>Pages or subtrees within Lenya can be protected by <em>SSL Encryption</em>. This allows you to protect 
+	    these parts of your site that need it. Note that <em>SSL Encryption</em> is independent of 
+	    <em>Authorization</em>. This means that you may have SSL-encrypted pages with or without access control.
+	</p>
+	
+	<p>In a typical setup, you would have Apache HTTPd handle the SSL encryption and forward requests to Tomcat
+	    as appropriate. This allows considerable flexibility with your setup, as you can make your SSL-encrypted
+	    pages appear at a different location than the rest of your content. The setup here will explain you
+	    how to achieve this.
+	</p>
+</section>
+	
+	<section>
+		<title>Enabling SSL Encryption</title>
+		<p>To enable <em>SSL Encryption</em> for a subtree or a page, go to the <em>AC Live</em> 
+		    or <em>AC Authoring</em> tabs in the Site area, and check the box that says <em>SSL Encryption</em>.</p>
+	</section>
+	
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>SSL Encryption</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780262.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780262.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780262.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780262.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>SSL Encryption</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/1a145680-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910780262" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910765789"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781621762" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781610572"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/1a1ae630-8731-11dc-ae46-9e7b5d14892d/en.1193910779351.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/1a1ae630-8731-11dc-ae46-9e7b5d14892d/en.1193910779351.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/1a1ae630-8731-11dc-ae46-9e7b5d14892d/en.1193910779351.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/1a1ae630-8731-11dc-ae46-9e7b5d14892d/en.1193910779351.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  
+  http://www.apache.org/licenses/LICENSE-2.0
+  
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: index.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Apache Lenya Documentation</title>
+  </header>
+  <body>
+    <p>
+      This is a Forrest Document 2.0 sample.
+    </p>
+  </body>
+</document>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@lenya.apache.org
For additional commands, e-mail: commits-help@lenya.apache.org