You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tiles.apache.org by ap...@apache.org on 2007/04/12 12:19:58 UTC

svn commit: r527870 [1/2] - in /tiles/framework/trunk: tiles-api/src/main/java/org/apache/tiles/ tiles-api/src/main/java/org/apache/tiles/access/ tiles-api/src/main/java/org/apache/tiles/mgmt/ tiles-api/src/main/java/org/apache/tiles/web/ tiles-core/sr...

Author: apetrelli
Date: Thu Apr 12 03:19:41 2007
New Revision: 527870

URL: http://svn.apache.org/viewvc?view=rev&rev=527870
Log:
TILES-151
Second run of Checkstyle fixes.

Added:
    tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/access/package.html   (with props)
    tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/package.html   (with props)
    tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/package.html   (with props)
    tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/web/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/enhanced/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/portlet/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/servlet/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/digester/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/util/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/factory/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/filter/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/mgmt/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/listener/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/impl/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/package.html   (with props)
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/servlet/package.html   (with props)
    tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/context/package.html   (with props)
    tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/package.html   (with props)
    tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/package.html   (with props)
    tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/package.html   (with props)
    tiles/framework/trunk/tiles-test/src/main/java/org/apache/tiles/test/preparer/package.html   (with props)
    tiles/framework/trunk/tiles-test/src/main/java/org/apache/tiles/test/servlet/package.html   (with props)
Modified:
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/Constants.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/Definitions.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsFactory.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsReader.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ReloadableDefinitionsFactory.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/KeyedDefinitionsFactoryTilesContainer.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/LocaleResolver.java
    tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java
    tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/KeyedDefinitionsFactoryTilesContainerFactoryTest.java
    tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/TilesContainerFactoryTest.java

Added: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/access/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/access/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/access/package.html (added)
+++ tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/access/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles access package</title>
+</head>
+<body>
+Utility classes to access Tiles funcionality from an application.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/access/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/access/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/package.html (added)
+++ tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,31 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles mutability package</title>
+</head>
+<body>
+Classes and interfaces to be used when it is needed to create Tiles definitions
+during the execution of the application.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/package.html (added)
+++ tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,390 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html lang="en">
+<head>
+    <title>Tiles Package</title>
+</head>
+<body>
+<div class="mainContent">
+The Tiles taglib and framework allows building web pages by assembling reusable
+pieces of pages, called Tiles. A Tiles is usually a simple JSP page.
+
+<div class="section">
+    <h2>Introduction</h2>
+
+    <p>The Tiles framework allows building pages by assembling reusable Tiles.
+        As an example, the page in the next figure can be build by assembling a
+        header, a footer, a menu and a body.</p>
+
+    <p><img src="doc-files/image001.gif" height="169" width="145" alt="doc-files/image001"></p>
+
+    <p>Each Tiles (header, menu, body, ...) is a JSP page and can itself be build
+        by assembling other Tiles.</p>
+
+    <p>Using Tiles can be compared as using Java methods: You need to define the Tiles (the method body), and then you
+        can &quot;call&quot; this body anywhere you want, passing it some parameters. In Tiles, parameters are called
+        &quot;attributes&quot; in order to avoid confusion with the request parameters.</p>
+
+    <p>The Tiles body can be a simple JSP page, a Struts action or any URI pointing
+        to a resource inside the current web site.</p>
+
+    <p>Inserting the body, or calling it, is done with the tag &lt;tiles:insert
+        ...&gt; anywhere in a JSP page. Insertion can also be done by specifying
+        a <em>definition name </em>as the path of a Struts forward or as input,
+        forward or include attributes of a Struts action.</p>
+
+    <p>Tiles bodies are used to create layouts, reusable parts, ... Tiles insertions
+        are used to insert Tiles. The same Tiles can be reused several times in
+        the same site, or even in the same page.</p>
+
+    <p>Insertion of a Tiles body can be associated to a logical name in what Tiles calls a &quot;definition&quot;. A
+        definition contains a logical name, a page used as body and some attribute values. The definition declaration
+        doesn't insert the associated Tiles body. It just associates it with the name. A definition name can be used
+        anywhere insertion of a Tiles body can occur. The associated Tiles body is then inserted with associated
+        attributes.</p>
+
+    <p>The definition declarations can be done in JSP pages or in one or more
+        centralized files. A definition can extend another one, overload some attributes,
+        add new attributes ... This allows the declaration of a &quot;master&quot; definition
+        declaring the common layout, header, menu and footer. All other definitions
+        extend this master layout thereby making it possible to change the entire
+        site look &amp; feel simply by changing the master definition. </p>
+</div>
+<div class="section">
+    <h2>Simple Examples</h2>
+
+    <div class="subsection1">
+        <h3>Insert a JSP page</h3>
+      <pre>&lt;tiles:insert <strong>page</strong>=&quot;/layouts/commonLayout.jsp&quot; flush=&quot;true&quot; /&gt;
+</pre>
+        <p>This example inserts the specified page in place of the tag. The page attribute is any valid URL pointing to
+            a resource inside the current site.</p>
+    </div>
+    <div class="subsection1">
+        <a name="doc.InsertPageWithAttributes"></a>
+
+        <h3>Insert a Tiles passing some attributes</h3>
+<pre>
+&lt;tiles:insert page=&quot;/layouts/classicLayout.jsp&quot; flush=&amp;quot;true&quot;&gt;
+  &lt;tiles:put name=&quot;title&quot;  value=&quot;Page Title&quot; /&gt;
+  &lt;tiles:put name=&quot;header&quot; value=&quot;/common/header.jsp&quot; /&gt;
+  &lt;tiles:put name=&quot;footer&quot; value=&quot;/common/footer.jsp&quot; /&gt;
+  &lt;tiles:put name=&quot;menu&quot;   value=&quot;/common/menu.jsp&quot; /&gt;
+  &lt;tiles:put name=&quot;body&quot;   value=&quot;/tiles/mainBody.jsp&quot; /&gt;
+&lt;/tiles:insert&gt;
+</pre>
+        <p>This example inserts the specified page, passing it the attributes. Attributes
+            are stored in a Tiles context which is passed to the inserted pag and
+            can then be accesssed by their names.</p>
+    </div>
+    <div class="subsection1">
+        <h3>Retrieve an attribute value as String</h3>
+<pre>
+&lt;tiles:getAsString name=&quot;title&quot; /&gt;
+</pre>
+        <p>This example retrieves the value of the attribute &quot;title&quot; and prints it as a String in the current
+            output stream. The method toString() is applied on the attribute value, allowing to pass any kind of object
+            as value.</p>
+    </div>
+    <div class="subsection1">
+        <h3>Insert Tiles referenced by an attribute</h3>
+<pre>
+&lt;tiles:insert attribute='menu' /&gt;
+</pre>
+        <p>This inserts the Tiles referenced by the attribute &quot;menu&quot; value. The
+            specified attribute value is first retrieved from current Tiles's context,
+            and then the value is used as a page target to insert.</p>
+    </div>
+    <div class="subsection1">
+        <h3>Classic Layout </h3>
+
+        <p>This example is a layout assembling a page in the classic header-footer-menu-body
+            fashion.</p>
+      <pre>
+&lt;%@ taglib uri=&quot;http://tiles.apache.org/tags-tiles&quot; prefix=&quot;tiles&quot; %&gt;
+&lt;HTML&gt;
+  &lt;HEAD&gt;
+    &lt;link rel=&quot;stylesheet&quot; href=&quot;&lt;%=request.getContextPath()%&gt;/layouts/stylesheet.css&quot; 
+                  type=&quot;text/css&quot;/&gt;
+    &lt;title&gt;&lt;tiles:getAsString name=&quot;title&quot;/&gt;&lt;/title&gt;
+  &lt;/HEAD&gt;
+&lt;body&gt;
+&lt;table border=&quot;0&quot; width=&quot;100%&quot; cellspacing=&quot;5&quot;&gt;
+&lt;tr&gt;
+  &lt;td colspan=&quot;2&quot;&gt;&lt;tiles:insert attribute=&quot;header&quot; /&gt;&lt;/td&gt;
+&lt;/tr&gt;
+&lt;tr&gt;
+  &lt;td width=&quot;140&quot; valign=&quot;top&quot;&gt;
+    &lt;tiles:insert attribute='menu' /&gt;
+  &lt;/td&gt;
+  &lt;td valign=&quot;top&quot;  align=&quot;left&quot;&gt;
+    &lt;tiles:insert attribute='body' /&gt;
+  &lt;/td&gt;
+&lt;/tr&gt;
+&lt;tr&gt;
+  &lt;td colspan=&quot;2&quot;&gt;
+    &lt;tiles:insert attribute=&quot;footer&quot; /&gt;
+  &lt;/td&gt;
+&lt;/tr&gt;
+&lt;/table&gt;
+&lt;/body&gt;
+&lt;/html&gt;
+</pre>
+        <p>The layout is declared in a JSP page (ex: /layouts/classicLayout.jsp).
+            It can be used in conjunction with the tag described in &quot;<a href="#doc.InsertPageWithAttributes">Insert
+            a page passing some attributes</a>&quot;. </p>
+    </div>
+</div>
+<div class="section">
+<h2>Definitions</h2>
+
+<p>A definition associates a logical name with the URL of a Tiles to be inserted
+    and some attribute values. A definition doesn't insert the Tiles. This is
+    done later using the definition name. A definition name can be inserted
+    as often as you want in your site, making it easy to reuse a Tiles. </p>
+
+<p>A definition can extend another definition and overload some attributes
+    or add new ones. This makes easy factorization of definitions differing
+    by some attributes. For example, you can define a master definition declaring
+    the main header, menu, footer, and a default title. Then let each of your
+    page definitions extend this master definition and overload the title and
+    the body.</p>
+
+<p>Definitions can be declared in a JSP page, or in one or more centralized
+    files. To enable the definitions from centralized files, you need to initialize
+    the &quot;definitions factory&amp;&amp;quot; which will parse the definitions from the files
+    and provide them to the Tiles framework.</p>
+
+<div class="subsection1">
+<h3>Enabling Definition Factory</h3>
+
+<p>To enable Tiles definitions described in one or more files, you need to write these files and to initialize the
+    definition factory. </p>
+
+<p>Initialization is different depending on the Struts version you use,
+    or if you do not use Struts at all.</p>
+
+<div class="subsection2">
+    <h4>Struts1.1</h4>
+
+    <p>Use the Tiles plug-in to enable Tiles definitions. This plug-in creates
+        the definition factory and passese it a configuration object populated
+        with parameters. Parameters can be specified in the web.xml file or
+        as plug-in parameters. The plug-in first reads parameters from web.xml,
+        and then overloads them with the ones found in the plug-in. All parameters
+        are optional and can be omitted. The plug-in should be declared in each
+        struts-config file:</p>
+<pre>
+  &lt;plug-in className=&amp;&amp;quot;org.apache.struts.tiles.TilesPlugin&amp;&amp;quot; &gt;
+    &lt;set-property property=&amp;&amp;quot;definitions-config&amp;&amp;quot; 
+	                 value=&amp;&amp;quot;/WEB-INF/tiles-defs.xml,
+                            /WEB-INF/tiles-tests-defs.xml,/WEB-INF/tiles-tutorial-defs.xml,
+                            /WEB-INF/tiles-examples-defs.xml&amp;&amp;quot; /&gt;
+    &lt;set-property property=&amp;&amp;quot;moduleAware&amp;&amp;quot; value=&amp;&amp;quot;true&amp;&amp;quot; /&gt;
+    &lt;set-property property=&amp;&amp;quot;definitions-parser-validate&amp;&amp;quot; value=&amp;&amp;quot;true&amp;&amp;quot; /&gt;
+  &lt;/plug-in&gt;
+</pre>
+    <ul>
+        <li>definitions-config: (optional)
+            <ul>
+                <li>Specify configuration file names. There can be several comma separated file names (default: ?? )
+                </li>
+            </ul>
+        </li>
+        <li>definitions-parser-validate: (optional)
+            <ul>
+                <li>Specify if XML parser should validate the Tiles configuration
+                    file
+                    <ul>
+                        <li>true : validate. DTD should be specified in file header (default)</li>
+                        <li>false : no validation</li>
+
+                    </ul>
+                </li>
+            </ul>
+        </li>
+
+        <li>moduleAware: (optional)
+            <ul>
+                <li>Specify if the Tiles definition factory is module aware. If true (default),
+                    there will be one factory for each Struts module.
+                    If false, there will be one common factory for all module. In this later case,
+                    it is still needed to declare one plugin per module. The factory will be
+                    initialized with parameters found in the first initialized plugin (generally the
+                    one associated with the default module).
+                    <ul>
+                        <li>true : Tiles framework is module aware</li>
+                        <li>false :Tiles framework has one single factoy shared among modules (default)</li>
+                    </ul>
+                </li>
+            </ul>
+        </li>
+
+        <li>tilesUtilImplClassname: (optional - for advanced user)
+            <ul>
+                <li>Specify The classname of the TilesUtil implementation to use. The specified class should
+                    be a subclass of TilesUtilStrutsImpl. This option disable the moduleAware option.
+                    <br>Specifying &amp;&amp;quot;TilesUtilStrutsImpl&amp;&amp;quot; is equivalent to moduleAware =
+                        false.</br>
+                    <br>Specifying &amp;&amp;quot;TilesUtilStrutsModuleImpl&amp;&amp;quot; is equivalent to moduleAware
+                        = true.</br>
+                    This option is taken into account only once, when it is first encountered. To avoid problems,
+                    it is advice to specify the same values in all TilesPlugin declaration.
+                </li>
+            </ul>
+        </li>
+
+    </ul>
+    <p>The TilesPlugin class creates one definition factory for each struts module.
+    </p>
+
+    <p>
+        If the flag moduleAware is false, only one shared factory is created for all modules.
+        In this later case, the factory is initialized with parameters found in the first plugin.
+        The plugins should be declared in all modules, and the moduleAware flag should be
+        the same for the entire application.</p>
+
+    <p>
+        Paths found in Tiles definitions are relative to the main context.</p>
+
+    <p>You don't need to specify a TilesRequestProcessor, this is automatically
+        done by the plug-in. If, however, you want to specify your own RequestProcessor,
+        it should extend the TilesRequestProcessor. The plug-in checks this
+        constraint.</p>
+</div>
+<div class="subsection2">
+    <h4>Struts1.0.x</h4>
+
+    <p>You need to use a special servlet extending the Struts servlet. This is specified in the web.xml file of your
+        application:</p>
+        <pre>
+  &lt;servlet&gt;
+    &lt;servlet-name&gt;action&lt;/servlet-name&gt;
+	&lt;servlet-class&gt;org.apache.tiles.servlet.TilesServlet&lt;/servlet-class&gt;   
+        &lt;!-- Tiles Servlet parameter 
+		  Specify configuration file names. There can be several comma 
+		  separated file names
+		--&gt; 	
+	&lt;init-param&gt;
+      &lt;param-name&gt;definitions-config&lt;/param-name&gt;
+      &lt;param-value&gt;/WEB-INF/tiles-defs.xml&lt;/param-value&gt;
+    &lt;/init-param&gt;
+        &lt;!-- Tiles Servlet parameter 
+		Specify if XML parser should validate the Tiles configuration file(s).
+		true : validate. DTD should be specified in file header.
+		false : no validation
+		--&gt; 	
+    &lt;init-param&gt;
+      &lt;param-name&gt;definitions-parser-validate&lt;/param-name&gt;
+      &lt;param-value&gt;true&lt;/param-value&gt;
+    &lt;/init-param&gt;
+     ...
+  &lt;/servlet&gt;
+</pre>
+</div>
+<div class="subsection2">
+    <h4>Without Struts</h4>
+
+    <p>Tiles can be used without Struts. To initialize the definition factory, you can use the provided servlet. Declare
+        it in the web.xml file of your application:</p>
+<pre>
+  &lt;servlet&gt;
+    &lt;servlet-name&gt;action&lt;/servlet-name&gt;
+    &lt;servlet-class&gt;org.apache.struts.tiles.TilesServlet&lt;/servlet-class&gt;
+
+
+	&lt;init-param&gt;
+      &lt;param-name&gt;definitions-config&lt;/param-name&gt;
+      &lt;param-value&gt;/WEB-INF/tiles-defs.xml&lt;/param-value&gt;
+    &lt;/init-param&gt;
+    &lt;init-param&gt;
+      &lt;param-name&gt;definitions-parser-validate&lt;/param-name&gt;
+      &lt;param-value&gt;true&lt;/param-value&gt;
+    &lt;/init-param&gt;
+   ...
+</pre>
+    <p>The parameters are the same as for Struts1.1 or 1.0.</p>
+</div>
+</div>
+<div class="subsection1">
+    <h3>Definition File Syntax</h3>
+
+    <p>The definition file syntax can be found in the
+        <a href="http://tiles.apache.org/dtds/tiles-config_2_0.dtd">tiles-config_2_0.dtd file</a>.
+    </p>
+
+    <p>Following is a simple example:</p>
+      <pre>
+&lt;!DOCTYPE tiles-definitions PUBLIC
+       &amp;&amp;quot;-//Apache Software Foundation//DTD Tiles Configuration//EN&amp;&amp;quot;
+       &amp;&amp;quot;http://tiles.apache.org/dtds/tiles-config_2_0.dtd&amp;&amp;quot;&gt;
+
+&lt;!-- Definitions for Tiles documentation   --&gt;
+&lt;tiles-definitions&gt;
+
+  &lt;!-- ========================================================== --&gt;
+  &lt;!-- Master definition                                          --&gt;
+  &lt;!-- ========================================================== --&gt;
+  &lt;!-- Main page layout used as a root for other page definitions --&gt;
+
+  &lt;definition name=&amp;&amp;quot;site.mainLayout&amp;&amp;quot; template=&amp;&amp;quot;/layouts/classicLayout.jsp&amp;&amp;quot;&gt;
+	  &lt;put name=&amp;&amp;quot;title&amp;&amp;quot;  value=&amp;&amp;quot;Tiles Blank Site&amp;&amp;quot; /&gt;
+	  &lt;put name=&amp;&amp;quot;header&amp;&amp;quot; value=&amp;&amp;quot;/tiles/common/header.jsp&amp;&amp;quot; /&gt;
+	  &lt;put name=&amp;&amp;quot;menu&amp;&amp;quot;   value=&amp;&amp;quot;site.menu.bar&amp;&amp;quot; /&gt;
+	  &lt;put name=&amp;&amp;quot;footer&amp;&amp;quot; value=&amp;&amp;quot;/tiles/common/footer.jsp&amp;&amp;quot; /&gt;
+	  &lt;put name=&amp;&amp;quot;body&amp;&amp;quot;   value=&amp;&amp;quot;/tiles/body.jsp&amp;&amp;quot; /&gt;
+  &lt;/definition&gt;
+
+  &lt;!-- ========================================================== --&gt;
+  &lt;!-- Index page definition                                      --&gt;
+  &lt;!-- ========================================================== --&gt;
+    &lt;!-- This definition inherits from the main definition.
+	  It overloads the page title and the body used.
+	  Use the same mechanism to define new pages sharing common 
+	  properties (here header, menu, footer, layout)
+	--&gt;
+
+  &lt;definition name=&amp;&amp;quot;site.index.page&amp;&amp;quot; extends=&amp;&amp;quot;site.mainLayout&amp;&amp;quot; &gt;
+	  &lt;put name=&amp;&amp;quot;title&amp;&amp;quot;  value=&amp;&amp;quot;Tiles Blank Site Index&amp;&amp;quot; /&gt;
+	  &lt;put name=&amp;&amp;quot;body&amp;&amp;quot;   value=&amp;&amp;quot;/tiles/body.jsp&amp;&amp;quot; /&gt;
+  &lt;/definition&gt;
+
+&lt;/tiles-definition&gt;
+</pre>
+</div>
+<div class="subsection1">
+    <h3>Debugging</h3>
+
+    <p>To debug a page made of Tiles, you can use following advices:</p>
+    <ul>
+        <li>Check each Tiles separatly. Try to access nested Tiles directly to test
+            if thes work properly.
+        </li>
+        <li>Enable Tiles logging. See the commons-logging package help.</li>
+    </ul>
+</div>
+</div>
+</div>
+</body>
+</html>

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/web/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/web/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/web/package.html (added)
+++ tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/web/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Web utilities</title>
+</head>
+<body>
+Utility classes to use Tiles in a servlet environment.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/web/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/web/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/Constants.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/Constants.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/Constants.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/Constants.java Thu Apr 12 03:19:41 2007
@@ -31,11 +31,11 @@
     /**
      * Name used to store attribute context stack.
      */
-    public static final String ATTRIBUTE_CONTEXT_STACK = "org.apache.tiles.AttributeContext.STACK";
+    String ATTRIBUTE_CONTEXT_STACK = "org.apache.tiles.AttributeContext.STACK";
 
     /**
      * The attribute name that is used to store the current locale.
      */
-    public static final String LOCALE_KEY = "org.apache.tiles.LOCALE";
+    String LOCALE_KEY = "org.apache.tiles.LOCALE";
 
 }

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java Thu Apr 12 03:19:41 2007
@@ -35,54 +35,54 @@
      *
      * @param value The value of this item.
      */
-    public void setValue(String value);
+    void setValue(String value);
 
     /**
      * Returns the value (i.e. the visible part) of this menu item.
      *
      * @return The value of this item.
      */
-    public String getValue();
+    String getValue();
 
     /**
      * Sets the URL of this menu item.
      *
      * @param link The URL of this item.
      */
-    public void setLink(String link);
+    void setLink(String link);
 
     /**
      * Returns the URL of this menu item.
      *
      * @return The URL of this item.
      */
-    public String getLink();
+    String getLink();
 
     /**
      * Sets the icon URL of this menu item.
      *
      * @param link The icon URL.
      */
-    public void setIcon(String link);
+    void setIcon(String link);
 
     /**
      * Returns the icon URL of this menu item.
      *
      * @return The icon URL.
      */
-    public String getIcon();
+    String getIcon();
 
     /**
      * Sets the tooltip text.
      *
      * @param link The tooltip text.
      */
-    public void setTooltip(String link);
+    void setTooltip(String link);
 
     /**
      * Returns the tooltip text.
      *
      * @return The tooltip text.
      */
-    public String getTooltip();
+    String getTooltip();
 }

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles menu items and beans</title>
+</head>
+<body>
+Classes to work with Tiles menu items and beans.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/enhanced/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/enhanced/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/enhanced/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/enhanced/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,31 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles enhanced context package</title>
+</head>
+<body>
+Classes and interfaces that allow to access the various contexts using also the
+classpath to access resources.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/enhanced/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/enhanced/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,31 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles context package</title>
+</head>
+<body>
+Classes and interfaces that allow to access the various contexts in an
+application in a uniformed way.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/portlet/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/portlet/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/portlet/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/portlet/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,31 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles portlet-specific context package</title>
+</head>
+<body>
+Classes and interfaces that allow to access the various contexts from a portlet
+application.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/portlet/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/portlet/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/servlet/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/servlet/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/servlet/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/servlet/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,31 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles servlet-specific context package</title>
+</head>
+<body>
+Classes and interfaces that allow to access the various contexts from a servlet
+application.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/servlet/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/servlet/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/Definitions.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/Definitions.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/Definitions.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/Definitions.java Thu Apr 12 03:19:41 2007
@@ -43,7 +43,7 @@
      * @return the Definition matching the given name or null if none
      *         is found.
      */
-    public Definition getDefinition(String name);
+    Definition getDefinition(String name);
 
     /**
      * Adds new Definition objects to the internal collection and
@@ -53,7 +53,7 @@
      * @throws NoSuchDefinitionException if a Definition extends from
      *                                   one that doesn't exist.
      */
-    public void addDefinitions(Map<String, Definition> defsMap) throws NoSuchDefinitionException;
+    void addDefinitions(Map<String, Definition> defsMap) throws NoSuchDefinitionException;
 
     /**
      * Adds new locale-specific Definition objects to the internal
@@ -64,7 +64,7 @@
      * @throws NoSuchDefinitionException if a Definition extends from
      *                                   one that doesn't exist.
      */
-    public void addDefinitions(Map<String, Definition> defsMap, Locale locale) throws NoSuchDefinitionException;
+    void addDefinitions(Map<String, Definition> defsMap, Locale locale) throws NoSuchDefinitionException;
 
     /**
      * Returns a Definition object that matches the given name and locale.
@@ -74,14 +74,14 @@
      * @return the Definition matching the given name or null if none
      *         is found.
      */
-    public Definition getDefinition(String name, Locale locale);
+    Definition getDefinition(String name, Locale locale);
 
     /**
      * Resolves configuration inheritance properties.
      *
      * @throws NoSuchDefinitionException If parent definitions are not found.
      */
-    public void resolveInheritances() throws NoSuchDefinitionException;
+    void resolveInheritances() throws NoSuchDefinitionException;
 
     /**
      * Resolves locale-specific configuration inheritance properties.
@@ -89,17 +89,17 @@
      * @param locale The locale object to use.
      * @throws NoSuchDefinitionException If parent definitions are not found.
      */
-    public void resolveInheritances(Locale locale) throws NoSuchDefinitionException;
+    void resolveInheritances(Locale locale) throws NoSuchDefinitionException;
 
     /**
      * Clears definitions.
      */
-    public void reset();
+    void reset();
 
     /**
      * Returns base definitions collection.
      *
      * @return A map of the type "definition name -> definition".
      */
-    public Map<String, Definition> getBaseDefinitions();
+    Map<String, Definition> getBaseDefinitions();
 }

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsFactory.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsFactory.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsFactory.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsFactory.java Thu Apr 12 03:19:41 2007
@@ -42,19 +42,19 @@
     /**
      * Property name that specifies the implementation of the DefinitionsReader.
      */
-    public static final String READER_IMPL_PROPERTY =
+    String READER_IMPL_PROPERTY =
         "org.apache.tiles.definition.DefinitionsReader";
     /**
      * Property name that specifies the implementation of Definitions.
      */
-    public static final String DEFINITIONS_IMPL_PROPERTY =
+    String DEFINITIONS_IMPL_PROPERTY =
         "org.apache.tiles.definition.Definitions";
 
     /**
      * Property name that specifies the implementation of
      * {@link org.apache.tiles.locale.LocaleResolver}.
      */
-    public static final String LOCALE_RESOLVER_IMPL_PROPERTY =
+    String LOCALE_RESOLVER_IMPL_PROPERTY =
         "org.apache.tiles.locale.LocaleResolver";
 
     /**
@@ -66,7 +66,7 @@
      * @throws TilesException If a Tiles exception, such as an initialization
      * error, occurs.
      */
-    public void init(Map<String, String> params) throws TilesException;
+    void init(Map<String, String> params) throws TilesException;
 
     /**
      * Returns a Definition object that matches the given name and
@@ -78,8 +78,8 @@
      *         is found.
      * @throws DefinitionsFactoryException if an error occurs reading definitions.
      */
-    public Definition getDefinition(String name,
-                                             TilesRequestContext tilesContext) throws DefinitionsFactoryException;
+    Definition getDefinition(String name, TilesRequestContext tilesContext)
+            throws DefinitionsFactoryException;
 
     /**
      * Adds a source where Definition objects are stored.
@@ -95,7 +95,7 @@
      * @throws DefinitionsFactoryException if an invalid source is passed in or
      *                                     an error occurs resolving the source to an actual data store.
      */
-    public void addSource(Object source) throws DefinitionsFactoryException;
+    void addSource(Object source) throws DefinitionsFactoryException;
 
     /**
      * Creates and returns a {@link Definitions} set by reading
@@ -105,6 +105,6 @@
      * @throws DefinitionsFactoryException if an error occurs reading the
      *                                     sources.
      */
-    public Definitions readDefinitions()
+    Definitions readDefinitions()
         throws DefinitionsFactoryException;
 }

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsReader.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsReader.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsReader.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/DefinitionsReader.java Thu Apr 12 03:19:41 2007
@@ -47,7 +47,7 @@
      * @throws DefinitionsFactoryException if required properties are not
      *                                     passed in or the initialization fails.
      */
-    public void init(Map<String, String> params) throws DefinitionsFactoryException;
+    void init(Map<String, String> params) throws DefinitionsFactoryException;
 
     /**
      * Reads <code>{@link org.apache.tiles.definition.Definition}</code> objects from a source.
@@ -60,6 +60,6 @@
      * @throws DefinitionsFactoryException if the source is invalid or
      *                                     an error occurs when reading definitions.
      */
-    public Map<String, Definition> read(Object source) throws DefinitionsFactoryException;
+    Map<String, Definition> read(Object source) throws DefinitionsFactoryException;
 
 }

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ReloadableDefinitionsFactory.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ReloadableDefinitionsFactory.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ReloadableDefinitionsFactory.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ReloadableDefinitionsFactory.java Thu Apr 12 03:19:41 2007
@@ -35,7 +35,7 @@
      *
      * @return <code>true</code> if the definitions need to be refreshed.
      */
-    public boolean refreshRequired();
+    boolean refreshRequired();
 
     /**
      * Refreshes the stored definitions, reloading them.
@@ -43,5 +43,5 @@
      * @throws DefinitionsFactoryException If something goes wrong during
      * refresh.
      */
-    public void refresh() throws DefinitionsFactoryException;
+    void refresh() throws DefinitionsFactoryException;
 }

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/digester/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/digester/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/digester/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/digester/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles definition with digester package</title>
+</head>
+<body>
+Allows reading definitions with the use of Jakarta Commons Digester.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/digester/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/digester/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,31 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles definition package</title>
+</head>
+<body>
+It contains classes and interfaces to allow manipulations of "definitions", i.e.
+objects made of a template page and a number of filled attributes.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/util/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/util/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/util/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/util/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles utility package for definitions</title>
+</head>
+<body>
+Utility classes for definitions.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/util/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/util/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/factory/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/factory/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/factory/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/factory/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles factory package</title>
+</head>
+<body>
+Factory classes, to allow creation of container instances.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/factory/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/factory/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/filter/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/filter/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/filter/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/filter/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles filter package</title>
+</head>
+<body>
+Filters, in a Servlet-based application sense.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/filter/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/filter/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/KeyedDefinitionsFactoryTilesContainer.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/KeyedDefinitionsFactoryTilesContainer.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/KeyedDefinitionsFactoryTilesContainer.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/KeyedDefinitionsFactoryTilesContainer.java Thu Apr 12 03:19:41 2007
@@ -74,7 +74,7 @@
          * @param request The request object.
          * @return The needed factory key.
          */
-        public String getDefinitionsFactoryKey(TilesRequestContext request);
+        String getDefinitionsFactoryKey(TilesRequestContext request);
     }
 
     /**

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/mgmt/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/mgmt/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/mgmt/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/mgmt/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles mutable container implementation package</title>
+</head>
+<body>
+It contains the basic implementations of mutable Tiles containers.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/mgmt/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/mgmt/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles container implementation package</title>
+</head>
+<body>
+It contains the basic implementations of Tiles container.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/impl/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/listener/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/listener/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/listener/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/listener/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles listener package</title>
+</head>
+<body>
+Listeners, in a Servlet-based application sense.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/listener/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/listener/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/LocaleResolver.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/LocaleResolver.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/LocaleResolver.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/LocaleResolver.java Thu Apr 12 03:19:41 2007
@@ -43,7 +43,7 @@
      * @throws TilesException if required properties are not passed
      * in or the initialization fails.
      */
-    public void init(Map<String, String> params) throws TilesException;
+    void init(Map<String, String> params) throws TilesException;
 
     /**
      * Resolves the locale.
@@ -51,5 +51,5 @@
      * @param request The Tiles request object.
      * @return The current locale for the current request.
      */
-    public Locale resolveLocale(TilesRequestContext request);
+    Locale resolveLocale(TilesRequestContext request);
 }

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/impl/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/impl/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/impl/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/impl/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles locale implementation package</title>
+</head>
+<body>
+Basic implementation of the locale resolver.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/impl/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/impl/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,31 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles locale package</title>
+</head>
+<body>
+Classes and interfaces to allow locale resolution in an application, i.e. it
+allows to specify how to access the locale that the user wants to use.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/locale/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java (original)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java Thu Apr 12 03:19:41 2007
@@ -53,7 +53,7 @@
      * @param attributeContext Current tile context.
      * @throws Exception If something goes wrong during execution.
      */
-    public void execute(TilesRequestContext tilesContext,
+    void execute(TilesRequestContext tilesContext,
         AttributeContext attributeContext)
         throws Exception;
 }

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,33 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles view preparers package</title>
+</head>
+<body>
+"View preparers" are objects that allows the "preparation" of a Tiles artifact
+(definition, template or attribute) before it is rendered.<br>
+It is useful, for example, when a view item should be built and stored in a
+particular context (e.g. a menu) and then rendered.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/servlet/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/servlet/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/servlet/package.html (added)
+++ tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/servlet/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles servlet package</title>
+</head>
+<body>
+Tiles Servlet support classes.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/servlet/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/servlet/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/KeyedDefinitionsFactoryTilesContainerFactoryTest.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/KeyedDefinitionsFactoryTilesContainerFactoryTest.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/KeyedDefinitionsFactoryTilesContainerFactoryTest.java (original)
+++ tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/KeyedDefinitionsFactoryTilesContainerFactoryTest.java Thu Apr 12 03:19:41 2007
@@ -25,6 +25,8 @@
 import javax.servlet.ServletContext;
 
 import org.easymock.EasyMock;
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
 import org.apache.tiles.TilesContainer;
 import org.apache.tiles.TilesException;
 import org.apache.tiles.impl.BasicTilesContainer;
@@ -43,6 +45,12 @@
 public class KeyedDefinitionsFactoryTilesContainerFactoryTest extends TestCase {
 
     /**
+     * The logging object.
+     */
+    private static final Log LOG = LogFactory
+            .getLog(KeyedDefinitionsFactoryTilesContainerFactoryTest.class);
+
+    /**
      * The servlet context.
      */
     private ServletContext context;
@@ -124,6 +132,9 @@
             container.init(new HashMap<String, String>());
             fail("Container should have already been initialized");
         } catch (IllegalStateException te) {
+            if (LOG.isDebugEnabled()) {
+                LOG.debug("The container has been initialized, the exception is ok", te);
+            }
         }
 
     }

Modified: tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/TilesContainerFactoryTest.java
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/TilesContainerFactoryTest.java?view=diff&rev=527870&r1=527869&r2=527870
==============================================================================
--- tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/TilesContainerFactoryTest.java (original)
+++ tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/factory/TilesContainerFactoryTest.java Thu Apr 12 03:19:41 2007
@@ -106,6 +106,9 @@
             TilesContainerFactory.getFactory(context);
             fail("Invalid classname.  Exception should have been thrown.");
         } catch (TilesException e) {
+            if (LOG.isDebugEnabled()) {
+                LOG.debug("The classname is invalid, it is ok", e);
+            }
         }
     }
 

Added: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/context/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/context/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/context/package.html (added)
+++ tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/context/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles JSP context package</title>
+</head>
+<body>
+Tiles context classes in a JSP environment.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/context/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/context/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/package.html (added)
+++ tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles JSP support</title>
+</head>
+<body>
+Support for Tiles in a JavaServer Pages environment.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/package.html
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/package.html?view=auto&rev=527870
==============================================================================
--- tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/package.html (added)
+++ tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/package.html Thu Apr 12 03:19:41 2007
@@ -0,0 +1,30 @@
+<!--
+/*
+ * $Id$
+ *
+ * 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.
+ */
+-->
+<html>
+<head>
+    <title>Tiles JSP tags for definitions</title>
+</head>
+<body>
+Part of the tag library to create definitions inside JSP pages.
+</body>
+</html>
\ No newline at end of file

Propchange: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/package.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/package.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL