cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ilgro...@apache.org
Subject svn commit: r1346801 - in /cocoon/subprojects/cocoon-maven-plugin/trunk: ./ src/site/ src/site/resources/ src/site/resources/images/ src/site/xdoc/
Date Wed, 06 Jun 2012 09:43:42 GMT
Author: ilgrosso
Date: Wed Jun  6 09:43:41 2012
New Revision: 1346801

URL: http://svn.apache.org/viewvc?rev=1346801&view=rev
Log:
Adding site generation

Added:
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png  
(with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml   (with props)
    cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml   (with props)
Modified:
    cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml

Modified: cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml?rev=1346801&r1=1346800&r2=1346801&view=diff
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml (original)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml Wed Jun  6 09:43:41 2012
@@ -209,6 +209,88 @@
           </execution>
         </executions>
       </plugin>
+      
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-site-plugin</artifactId>
+        <version>3.0</version>
+        <configuration>
+          <locales>en</locales>
+          <reportPlugins>
+            <plugin>
+              <groupId>org.apache.maven.plugins</groupId>
+              <artifactId>maven-project-info-reports-plugin</artifactId>
+              <version>2.4</version>
+              <configuration>
+                <dependencyDetailsEnabled>false</dependencyDetailsEnabled>
+                <dependencyLocationsEnabled>false</dependencyLocationsEnabled>
+              </configuration>
+              <reportSets>
+                <reportSet>
+                  <reports>
+                    <report>dependencies</report>
+                    <report>license</report>
+                    <report>summary</report>
+                    <report>project-team</report>
+                  </reports>
+                </reportSet>
+              </reportSets>
+            </plugin>
+            <plugin>
+              <groupId>org.apache.maven.plugins</groupId>
+              <artifactId>maven-changes-plugin</artifactId>
+              <version>2.7.1</version>
+              <reportSets>
+                <reportSet>
+                  <reports>
+                    <report>changes-report</report>
+                  </reports>
+                </reportSet>
+              </reportSets>
+            </plugin>
+            <plugin>
+              <groupId>org.apache.maven.plugins</groupId>
+              <artifactId>maven-javadoc-plugin</artifactId>
+              <version>2.8.1</version>
+              <reportSets>
+                <reportSet>
+                  <reports>
+                    <report>javadoc</report>
+                  </reports>
+                </reportSet>
+              </reportSets>
+            </plugin>
+            <plugin>
+              <groupId>org.apache.maven.plugins</groupId>
+              <artifactId>maven-plugin-plugin</artifactId>
+              <version>3.0</version>
+            </plugin>
+          </reportPlugins>
+        </configuration>
+        <executions>
+          <execution>
+            <id>attach-descriptor</id>
+            <goals>
+              <goal>attach-descriptor</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
+    
+    <resources>
+      <resource>
+        <directory>src/main/resources</directory>
+        <filtering>true</filtering>
+      </resource>
+      <resource>
+        <directory>.</directory>
+        <targetPath>META-INF</targetPath>
+        <includes>
+          <include>LICENSE.txt</include>
+          <include>NOTICE.txt</include>
+        </includes>
+      </resource>
+    </resources>
   </build>
 </project>

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png?rev=1346801&view=auto
==============================================================================
Binary file - no diff available.

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml Wed Jun  6 09:43:41 2012
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you 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$ -->
+<project xmlns="http://maven.apache.org/DECORATION/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/DECORATION/1.1.0 http://maven.apache.org/xsd/decoration-1.1.0.xsd"
+         name="Cocoon">
+
+  <skin>
+    <groupId>org.apache.cocoon</groupId>
+    <artifactId>cocoon-thien-maven-site-skin</artifactId>
+    <version>1.0.1</version>
+  </skin>
+    
+  <body>
+    <menu name="Cocoon Maven 2 Plugin">
+      <item name="Introduction" href="./index.html"/>
+      <item name="Block Prepare (goal)" href="./1359_1_1.html" collapse="true">
+        <item name="Purpose" href="./1359_1_1.html"/>
+        <item name="Using the Reloading Classloader" href="./1297_1_1.html"/>
+        <item name="rcl:properties" href="./1298_1_1.html"/>
+        <item name="XPatch" href="./1360_1_1.html"/>
+      </item>
+      <item name="Deployer (goal)" href="./1361_1_1.html" collapse="true">
+        <item name="Purpose" href="./1361_1_1.html"/>
+        <item name="Using the Cocoon Deployer" href="./1358_1_1.html"/>
+        <item name="Shielded Classloading" href="./1262_1_1.html"/>
+      </item>
+    </menu>
+
+    <menu ref="reports" inherit="bottom"/>
+  </body>
+</project>

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - Shielded Classloading</title><author email="cocoon-docs@apache.org">Apache
Cocoon Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Shielded
Classloading</h1><p>Shielded classloading is an optional feature of the Cocoon
deployer-plugin
+for Maven. It helps you in avoiding typical problems with respect to class
+loading. Usually the servlet container sets up a class loader for each web
+application. This class loader works "parent-first" which means that whenever a
+class is loaded it is first searched in the parent class loader of the web
+application class loader and only if its not available there, it is loaded from
+the classes in WEB-INF/classes or the jars in WEB-INF/lib. In general this is a
+useful mechanism which also allows you to share classes between web applications
+by putting them in the parent class loader (refer to the documentation of your
+application server/servlet engine for more information).</p><p>Unfortunately
there are some problems with this approach: for example if the
+servlet engine has configured a logging framework like commons logging and
+exposes this  in the parent class loader for the web applications, than all web
+applications have to use this configuration and are not able to use their own.
+Even more important is the used XSLT processor (and some other stuff contained
+in the endorsed directory). By default you always use the XSLT processor shipped
+with the JDK; you can override this by specifying one using the endorsed
+mechanism but in many cases you can't use this way. As the XSLT processor
+shipped with the JDK has some bugs it is advisable to use the latest version.
+</p><p>The only reliable way of avoiding all these class loading issues is to
use a
+mechanism we call shielded class loading: the web application uses its own class
+loader which works "parent-last". In this case classes are always tried to be
+loaded from the WEB-INF/classes or WEB-INF/lib directory first. Through this
+mechanism you can enforce the use of the XSLT processor you want for your
+application, of the logging configuration you need etc.</p><p>Some application
servers provide a configuration for this, but you can also
+use some of the functionality provided by Cocoon: if you are using the Cocoon
+deploy plugin with Maven 2, this plugin rewrites your web.xml to use the
+shielded class loader.</p></div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - Using the Reloading Classloader</title><author email="cocoon-docs@apache.org">Apache
Cocoon Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Using
the Reloading Classloader</h1><p>These instructions should work with any Cocoon
block. The sample
+configurations are based on the <a href="../../../../2.2/1159_1_1.html">Getting Started
guide</a>.
+</p><h1>Step 1: Enable the plugin in pom.xml</h1><p>In the pom.xml
you have to add the plugin:</p><pre>&lt;project&gt;
+  &lt;build&gt;
+    &lt;plugins&gt;
+      [...]
+      &lt;plugin&gt;
+        &lt;groupId&gt;org.apache.cocoon&lt;/groupId&gt;
+        &lt;artifactId&gt;cocoon-maven-plugin&lt;/artifactId&gt;
+        &lt;version&gt;1.0.0-M2&lt;/version&gt;
+      &lt;/plugin&gt;
+      [...]
+    &lt;/plugins&gt;
+  &lt;/build&gt;
+&lt;/project&gt;   
+</pre><h1>Step 2: Configure the plugin</h1><p>You can also provide
configuration properties. Use the
+<a href="prepare-mojo.html">goal documentation</a> generated from the Javadoc
+comments to find out more.</p><p>The central configuration file is rcl.properties
which has to be put into the
+root directory of the block that you want to run, e.g.</p><pre><strong>com.mycompany.myBlock1.block%classes-dir</strong>=./target/classes</pre><p>The
property names consist of the name of the block servlet which is the
+unique name of the Spring bean + <tt>%classes_dir</tt> . The value is the
+relative or absolute filesystem path.</p><h1>Step 3: Invoke the plugin</h1><p>The
Maven 2 plugin can be invoked by calling</p><pre>mvn cocoon:prepare</pre><p>This
creates a web application into<tt> ./target/rcl/webapp</tt> for your
+block.</p><p>If you want to avoid this additional step, you can invoke it automatically,
+e.g. by</p><p>If you want to invoke it automatically, add it to the execution
section of
+your plugin definition, e.g.</p><pre>&lt;plugin&gt;
+  &lt;groupId&gt;org.apache.cocoon&lt;/groupId&gt;
+  &lt;artifactId&gt;cocoon-maven-plugin&lt;/artifactId&gt;
+  &lt;version&gt;1.0.0-M2&lt;/version&gt;
+  &lt;executions&gt;
+    &lt;execution&gt;
+      &lt;phase&gt;compile&lt;/phase&gt;
+      &lt;goals&gt;
+        &lt;goal&gt;prepare&lt;/goal&gt;
+      &lt;/goals&gt;
+    &lt;/execution&gt;
+  &lt;/executions&gt;       
+&lt;/plugin&gt;
+</pre><h1>Step 4: Create Eclipse project files</h1><p>Move to <tt>getting-started-app/
</tt>and invoke</p><pre>mvn eclipse:eclipse</pre><p>and import
the new Eclipse project into your Eclipse workspace.</p><h1>Step 5: Start the
servlet container</h1><section name="Alternative A: The Maven Jetty plugin" style="background:none;padding:0;"/><p>Now
you can configure the Maven 2 Jetty plugin to use the web application
+that was created by the block in <tt>target/rcl/webapp</tt>:</p><pre>&lt;project&gt;
+  &lt;build&gt;
+    &lt;plugins&gt;
+      [...]
+      &lt;plugin&gt;
+        &lt;groupId&gt;org.mortbay.jetty&lt;/groupId&gt;
+        &lt;artifactId&gt;maven-jetty-plugin&lt;/artifactId&gt;
+        &lt;version&gt;6.1.7&lt;/version&gt;
+        &lt;configuration&gt;
+          &lt;connectors&gt;
+            &lt;connector implementation="org.mortbay.jetty.nio.SelectChannelConnector"&gt;
+              &lt;port&gt;8888&lt;/port&gt;
+              &lt;maxIdleTime&gt;30000&lt;/maxIdleTime&gt;
+            &lt;/connector&gt;
+          &lt;/connectors&gt;
+          &lt;webAppSourceDirectory&gt;${project.build.directory}/rcl/webapp&lt;/webAppSourceDirectory&gt;
+          &lt;contextPath&gt;/&lt;/contextPath&gt;
+          &lt;systemProperties&gt;
+            &lt;systemProperty&gt;
+              &lt;name&gt;org.apache.cocoon.mode&lt;/name&gt;
+              &lt;value&gt;dev&lt;/value&gt;
+            &lt;/systemProperty&gt;
+          &lt;/systemProperties&gt;
+        &lt;/configuration&gt;
+      &lt;/plugin&gt;
+      [...]
+    &lt;/plugins&gt;
+  &lt;/build&gt;
+&lt;/project&gt;   </pre><p>Call mvn <tt>jetty:run</tt>
and point your browser to
+<tt>http://localhost:8888/block1/</tt> in  your browser.</p><section
name="Alternative B: Use the Eclipse Jetty plugin" style="background:none;padding:0;"/><p>There
is a <a href="../../../../1301_1_1.html">tutorial</a> that describes how to debug
+Cocoon.</p><h1>Step 6: Change a class file</h1><p>Now it's time to
see the reloading classloader in action. Open
+<tt>getting-started-app/myBlock1/src/main/java/com/mycompany/???</tt> and change
+it. Refresh your browser and you should see the changed values there.</p></div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - rcl.properties</title><author email="cocoon-docs@apache.org">Apache
Cocoon Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">rcl.properties</h1><h1>Location</h1><p>The
default location of <tt>rcl.properties</tt> is at the root directory of
+your block, next to <tt>pom.xml.</tt></p><h1>What can be configured?</h1><section
name="Classes directories of blocks" style="background:none;padding:0;"/><h3>Syntax</h3><p><tt>[name-of-the-block]%classes-dir=[path-to-a-blocks-classes-dir]</tt></p><h3>Examples</h3><ul>
+<li><tt>com.mycompany.app.block%classes-dir=./target/classes</tt></li>
+<li><tt>com.mycompany.app.block2%classes-dir=C:/test/block2/target/classes</tt>
+</li>
+</ul><section name="Classes directories of libraries that are NOT blocks" style="background:none;padding:0;"/><h3>Syntax</h3><tt>%classes-dir=[path-to-a-library]<br/>
+%exclude-lib=[groupId]:[artifactId]</tt><h3>Example</h3><tt>%classes-dir=</tt><tt><tt>C:</tt></tt><tt>/test/mylib/target/classes</tt>
+<div class="note"><div><strong>Note: </strong>You can use the <tt>%classes-dir
</tt>and <tt>%exclude-lib</tt>
+properties as often as you need in your properties file</div></div><section
name="Cocoon properties and Spring bean configurator properties" style="background:none;padding:0;"/><p>All
other properties are either interpreted as <a href="../../../../subprojects/configuration/1.0/spring-configurator/2.0/1310_1_1.html">Cocoon
+properties</a> or <a href="../../../../subprojects/configuration/1.0/spring-configurator/2.0/1312_1_1.html">Spring
bean properties</a>. The
+differenciation is done whether the property contains a "/" character. If so, it
+is considered as Spring bean configurator property.</p><h1>Variables interpolation
and includes</h1><p>As this configuration file is managed by
+<a href="http://commons.apache.org/configuration/">Apache Commons
+Configuration</a> you can benefit from all the features it provides. The two
+most important ones are
+<a href="http://commons.apache.org/configuration/howto_properties.html#Variable_Interpolation">variables
+interpolation</a> and
+<a href="http://commons.apache.org/configuration/howto_properties.html#Includes">includes</a>.
+</p></div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - Using the Cocoon Deployer</title><author email="cocoon-docs@apache.org">Apache
Cocoon Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Using
the Cocoon Deployer</h1><h1>Step 1: Basics</h1><p>In order to use
the Cocoon Deployer, you need a Cocoon web application, e.g.
+one that is generated as described in the <a href="../../../../2.2/1159_1_1.html">Getting
Started
+Tutorial</a>. Expressed in terms of Maven 2, it mean that the <tt>packaging
+type</tt> in your pom.xml is <tt>war</tt>.</p><h1>Step 2: Enabling
the deployer</h1><p>Enable the Cocoon Maven plugin in your pom.xml:</p><pre>&lt;project&gt;
+  &lt;build&gt;
+    &lt;plugins&gt;
+      [...]
+      &lt;plugin&gt;
+        &lt;groupId&gt;org.apache.cocoon&lt;/groupId&gt;
+        &lt;artifactId&gt;cocoon-maven-plugin&lt;/artifactId&gt;
+        &lt;version&gt;1.0.0-M2&lt;/version&gt;
+        &lt;configuration&gt;
+          [...]
+        &lt;/configuraiton&gt;
+      &lt;/plugin&gt;
+      [...]
+    &lt;/plugins&gt;
+  &lt;/build&gt;
+&lt;/project&gt;   </pre><h1>Step 3: Configuration</h1><p>You
can also provide configuration properties. Use the
+<a href="deploy-mojo.html">goal documentation</a> generated from the Javadoc
+comments to find out more.</p><h1>Step 4: Invoke the deployer</h1><p>Finally
you have to invoke the plugin. If you want to do this manually, enter
+</p><pre><tt>mvn cocoon:deploy</tt></pre><p>or</p><pre><tt>mvn
cocoon:deploy-wa</tt>r</pre></div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - Purpose</title><author email="cocoon-docs@apache.org">Apache
Cocoon Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Purpose</h1><p>If
you develop your Cocoon applications based on blocks, you will come to the
+point that you want to run it while you are working on its resources. The
+reloading classloader goal creates a minimal web application that you can use in
+any servlet container.</p><p>This web application <strong>automatically
detects changes</strong> in</p><ul>
+<li><tt>src/main/java</tt></li>
+<li><tt>src/main/resources</tt></li>
+<li><tt>src/main/resources/COB-INF</tt></li>
+<li><tt>src/main/resources/META-INF</tt></li>
+</ul>This means that any changes in<ul>
+<li>Cocoon resources (sitemaps, templates, form definitions, flowscripts, etc.)
+</li>
+<li>Java classes and resources</li>
+<li>Components (Spring beans and Avalon concepts)</li>
+</ul>are detected and will take effect nearly immediatly. Because of the use of
+the Jakarta Commons JCI, you can also change the signatures of your classes and
+methods.The plugin also enables you to <strong>use other blocks</strong> in a
the
+reloading mode together with the block that you apply the reloading classloader
+plugin on.Finally, the plugin also supports the <strong>patching mechanism</strong>
+that comes with the deployer goal. By using it, your blocks can contain parts of
+the web.xml, e.g. a servlet configuration.</div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - XPatch</title><author email="cocoon-docs@apache.org">Apache Cocoon
Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">XPatch</h1><p>The
xpatch mechanism enables you to split up your web.xml and put the
+snippets into the block it belongs too. It takes all *.xweb files from
+<tt>src/main/resources/META-INF/cocoon/xpatch</tt> and applies them to the
+generated <tt>web.xml</tt> file that you will find in
+<tt>target/rcl/webapp/WEB-INF/web.xml</tt>.</p><p>Here is an example
of an xweb file:</p><pre>&lt;xweb <strong>xpath</strong>="/web-app"

+      <strong>unless</strong>="comment()[contains(., 'Xindice XML-RPC Server
servlet configuration')]" 
+      <strong>insert-after</strong>="servlet[last()]"&gt;
+
+  &lt;!-- XMLDB Block, Xindice XML-RPC Server servlet configuration --&gt;
+  &lt;servlet&gt;
+    &lt;servlet-name&gt;Xindice&lt;/servlet-name&gt;
+    &lt;display-name&gt;Xindice XML-RPC Server&lt;/display-name&gt;
+    &lt;servlet-class&gt;org.apache.xindice.server.XindiceServlet&lt;/servlet-class&gt;
+    &lt;init-param&gt;
+      &lt;param-name&gt;xindice.configuration&lt;/param-name&gt;
+      &lt;param-value&gt;WEB-INF/xindice.xml&lt;/param-value&gt;
+    &lt;/init-param&gt;
+    &lt;load-on-startup&gt;1&lt;/load-on-startup&gt;
+  &lt;/servlet&gt;
+  
+&lt;/xweb&gt;
+</pre><p>This xweb file adds the Xindice-RPC Server servlet to your web.xml.</p><h3>Syntax</h3><table
class="bodyTable">
+<tbody>
+<tr class="a">
+<th/>
+<th>
+<p>description</p>
+</th>
+</tr>
+<tr class="b">
+<th>
+<p>xweb</p>
+</th>
+<td>
+<p>That's the root element. Everything it contains will be applied.</p>
+</td>
+</tr>
+<tr class="a">
+<th>
+<p>@xpath</p>
+</th>
+<td>
+<p>The xpatch within web.xml where the xweb snippet should be applied to.</p>
+</td>
+</tr>
+<tr class="b">
+<th>
+<p>@unless</p>
+</th>
+<td>
+<p>A condition when the patch should NOT be applied.</p>
+</td>
+</tr>
+<tr class="a">
+<th>
+<p>@insert-after</p>
+</th>
+<td>
+<p>Define the exact position within result of the xpath.</p>
+</td>
+</tr>
+</tbody>
+</table></div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - Purpose</title><author email="cocoon-docs@apache.org">Apache
Cocoon Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Purpose</h1><p>The
Cocoon Deployer goal provides two features that rewrite a web application
+in order to add functionality that comes from</p><ul>
+<li><strong>reversing the classloader hierarchy</strong><br/>
+By reversing the classloader hierarchy you can make sure that the dependencies
+you define are found first before the classpath of the application server is
+searched.</li>
+<li><strong>patching your web.xml</strong><br/>
+If your blocks contain <tt>/META-INF/cocoon/xpatch/*.xweb</tt> files, they are
+applied to the <tt>/WEB-INF/web.xml</tt> of the resulting web archive.</li>
+</ul></div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml Wed Jun  6 09:43:41
2012
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+      Licensed to the Apache Software Foundation (ASF) under one
+      or more contributor license agreements.  See the NOTICE file
+      distributed with this work for additional information
+      regarding copyright ownership.  The ASF licenses this file
+      to you 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.
+    --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon
Maven 2 Plugin - Introduction</title><author email="cocoon-docs@apache.org">Apache
Cocoon Documentation Team</author></properties><body>
+         <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Introduction</h1><p>The
Cocoon Maven 2 plugin provides some goals that make the developer's life
+easier. Currently it contains</p><ul>
+<li><a href="1297_1_1.html">Cocoon Block preparation goal<br/>
+</a></li>
+<li><a href="1358_1_1.html">Cocoon Deployer goal</a></li>
+</ul><h1>Cocoon Block preparation goal</h1>The purpose of the <a href="1297_1_1.html">block
preparation goal</a> is making
+a block runnable as web application and enabling <strong>rapid application
+development</strong>. It uses the
+<a href="http://commons.apache.org/jci/">Apache Commons JCI</a>
+library which provides a reloading classloader. As the names already promises,
+it is able to watch resources (e.g. <tt>.class</tt> files) for changes. In such
+a case the classloader will use the latest version of the resources in the
+future.Some Java servlet containers already provide the automatic reload of loaded
+servlet contexts in the case of changes but this comes with the downside that
+you might lose  the application state and that you are not allowed to change the
+signatures of classes and methods.<h1>Cocoon Deployer goal</h1><p>The <a
href="1358_1_1.html">Cocoon Deployer goal </a>provides two features that
+rewrite a web application in order to add functionality that comes from</p><ul>
+<li>reversing the classloader hierarchy</li>
+<li>patching your web.xml</li>
+</ul></div></div>
+       </body></document>
\ No newline at end of file

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml



Mime
View raw message