You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@struts.apache.org by ap...@apache.org on 2006/11/14 13:59:07 UTC
svn commit: r474775 - in /struts/sandbox/trunk/tiles/tiles-core: pom.xml
src/main/resources/org/apache/tiles/resources/tiles-config_2_0.dtd
Author: apetrelli
Date: Tue Nov 14 04:59:06 2006
New Revision: 474775
URL: http://svn.apache.org/viewvc?view=rev&rev=474775
Log:
SB-82
Updated Tiles configuration file DTD to follow DTDDoc syntax and updated pom.xml to add the title in DTDDoc plugin configuration
Modified:
struts/sandbox/trunk/tiles/tiles-core/pom.xml
struts/sandbox/trunk/tiles/tiles-core/src/main/resources/org/apache/tiles/resources/tiles-config_2_0.dtd
Modified: struts/sandbox/trunk/tiles/tiles-core/pom.xml
URL: http://svn.apache.org/viewvc/struts/sandbox/trunk/tiles/tiles-core/pom.xml?view=diff&rev=474775&r1=474774&r2=474775
==============================================================================
--- struts/sandbox/trunk/tiles/tiles-core/pom.xml (original)
+++ struts/sandbox/trunk/tiles/tiles-core/pom.xml Tue Nov 14 04:59:06 2006
@@ -86,6 +86,9 @@
<plugin>
<groupId>net.sf.dtddoc</groupId>
<artifactId>dtddoc-maven-plugin</artifactId>
+ <configuration>
+ <docTitle>Tiles Definition File</docTitle>
+ </configuration>
</plugin>
</plugins>
</reporting>
Modified: struts/sandbox/trunk/tiles/tiles-core/src/main/resources/org/apache/tiles/resources/tiles-config_2_0.dtd
URL: http://svn.apache.org/viewvc/struts/sandbox/trunk/tiles/tiles-core/src/main/resources/org/apache/tiles/resources/tiles-config_2_0.dtd?view=diff&rev=474775&r1=474774&r2=474775
==============================================================================
--- struts/sandbox/trunk/tiles/tiles-core/src/main/resources/org/apache/tiles/resources/tiles-config_2_0.dtd (original)
+++ struts/sandbox/trunk/tiles/tiles-core/src/main/resources/org/apache/tiles/resources/tiles-config_2_0.dtd Tue Nov 14 04:59:06 2006
@@ -1,34 +1,28 @@
<!--
-/*
- * 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.
- */
--->
-<!--
- DTD for the Tile Definition File, Version 2.0
-
- To support validation of your configuration file, include the following
- DOCTYPE element at the beginning (after the "xml" declaration):
-
- <!DOCTYPE tiles-definitions PUBLIC
- "-//Apache Software Foundation//DTD Tiles Configuration 2.0//EN"
- "http://struts.apache.org/dtds/tiles-config_2_0.dtd">
-
- $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.
+
+%
+
+@hidden $Id$
+@title DTD for the Tiles Definition File, Version 2.0
+@doctype declaredRoot PUBLIC "-//Apache Software Foundation//DTD Tiles Configuration 2.0//EN" "http://struts.apache.org/dtds/tiles-config_2_0.dtd"
+@root declaredRoot
-->
@@ -95,54 +89,62 @@
<!-- The "definition" element describes a definition that can be inserted in a jsp
page. This definition is identified by its logical name. A definition allows
to define all the attributes that can be set in <insert> tag from a jsp page.
-
- preparer The fully qualified Java class name of the preparer
+-->
+<!ELEMENT definition (icon?, display-name?, description?, put*, putList*)>
+<!ATTLIST definition id ID #IMPLIED>
+<!--
+@attr preparer The fully qualified Java class name of the preparer
subclass to call immediately before the tiles is inserted.
Only one of preparerClass or preparerUrl should be
specified.
-
- extends Name of a definition that is used as ancestor of this definition.
+-->
+<!ATTLIST definition preparer %ClassName; #IMPLIED>
+<!--
+@attr extends Name of a definition that is used as ancestor of this definition.
All attributes from the ancestor are available to the new
definition. Any attribute inherited from the ancestor can
be overloaded by providing a new value.
-
- name The unique identifier for this definition.
-
- role Security role name that is allowed access to this definition
+-->
+<!ATTLIST definition extends %DefinitionName; #IMPLIED>
+<!--
+@attr name The unique identifier for this definition.
+-->
+<!ATTLIST definition name %DefinitionName; #REQUIRED>
+<!--
+@attr role Security role name that is allowed access to this definition
object. The definition is inserted only if the role name is
allowed.
-
- template The context-relative path to the resource used as tiles to
+-->
+<!ATTLIST definition role CDATA #IMPLIED>
+<!--
+@attr template The context-relative path to the resource used as tiles to
insert. This tiles will be inserted and a tiles context
containing appropriate attributes will be available.
-->
-<!ELEMENT definition (icon?, display-name?, description?, put*, putList*)>
-<!ATTLIST definition id ID #IMPLIED>
-<!ATTLIST definition preparer %ClassName; #IMPLIED>
-<!ATTLIST definition extends %DefinitionName; #IMPLIED>
-<!ATTLIST definition name %DefinitionName; #REQUIRED>
-<!ATTLIST definition role CDATA #IMPLIED>
<!ATTLIST definition template %RequestPath; #IMPLIED>
<!-- The "put" element describes an attribute of a definition. It allows to
specify the tiles attribute name and its value. The tiles value can be
specified as an xml attribute, or in the body of the <put> tag.
-
- name The unique identifier for this put.
-
- type The type of the value. Can be: string, page, template or definition.
- By default, no type is associated to a value. If a type is
- associated, it will be used as a hint to process the value
- when the attribute will be used in the inserted tiles.
-
- value The value associated to this tiles attribute. The value should
- be specified with this tag attribute, or in the body of the tag.
-->
<!ELEMENT put (#PCDATA)>
<!ATTLIST put id ID #IMPLIED>
+<!--
+@attr name The unique identifier for this put.
+-->
<!ATTLIST put name CDATA #REQUIRED>
+<!--
+@attr type The type of the value. Can be: string, template or definition.
+ By default, no type is associated to a value. If a type is
+ associated, it will be used as a hint to process the value
+ when the attribute will be used in the inserted tiles.
+-->
<!ATTLIST put type %ContentType; #IMPLIED>
+<!--
+@attr value The value associated to this tiles attribute. The value should
+ be specified with this tag attribute, or in the body of the tag.
+-->
<!ATTLIST put value CDATA #IMPLIED>
@@ -150,56 +152,62 @@
specify an attribute that is a java List containing any kind of values. In
the config file, the list elements are specified by nested <add>, <item> or
<putList>.
-
- name The unique identifier for this put list.
-->
<!ELEMENT putList ( (add* | item* | bean* | putList*)+) >
<!ATTLIST putList id ID #IMPLIED>
+<!--
+@attr name The unique identifier for this put list.
+-->
<!ATTLIST putList name CDATA #REQUIRED>
<!-- ========== Subordinate Elements ====================================== -->
<!-- The "add" element describes an element of a list. It is similar to the
<put> element.
-
- type The type of the value. Can be: string, page, template or definition.
+-->
+<!ELEMENT add (#PCDATA)>
+<!ATTLIST add id ID #IMPLIED>
+<!--
+@attr type The type of the value. Can be: string, template or definition.
By default, no type is associated to a value. If a type is
associated, it will be used as a hint to process the value
when the attribute will be used in the inserted tiles.
-
- value The value associated to this tiles attribute. The value should
- be specified with this tag attribute, or in the body of the tag.
-->
-<!ELEMENT add (#PCDATA)>
-<!ATTLIST add id ID #IMPLIED>
<!ATTLIST add type %ContentType; #IMPLIED>
+<!--
+@attr value The value associated to this tiles attribute. The value should
+ be specified with this tag attribute, or in the body of the tag.
+-->
<!ATTLIST add value CDATA #IMPLIED>
<!-- The "bean" element describes an element of a list. It create a bean of the
specified java classtype. This bean is initialized with appropriate nested
<set-property>.
-
- classtype The fully qualified classname for this bean.
--->
+-->
<!ELEMENT bean (set-property*)>
<!ATTLIST bean id ID #IMPLIED>
+<!--
+@attr classtype The fully qualified classname for this bean.
+-->
<!ATTLIST bean classtype %ClassName; #REQUIRED>
<!-- The "set-property" element specifies the method name and initial value of
a bean property. When the object representing
the surrounding element is instantiated, the accessor for the indicated
property is called and passed the indicated value.
-
- property Name of the JavaBeans property whose setter method
- will be called.
-
- value String representation of the value to which this
- property will be set, after suitable type conversion
-->
<!ELEMENT set-property EMPTY>
<!ATTLIST set-property id ID #IMPLIED>
+<!--
+@attr property Name of the JavaBeans property whose setter method
+ will be called.
+-->
<!ATTLIST set-property property %PropName; #REQUIRED>
+<!--
+@attr value String representation of the value to which this
+ property will be set, after suitable type conversion
+-->
<!ATTLIST set-property value CDATA #REQUIRED>
@@ -210,25 +218,30 @@
By default the bean is of type
"org.apache.struts.tiles.beans.SimpleMenuItem". This bean is useful to
create a list of beans used as menu items.
-
- classtype The fully qualified classtype for this bean.
- If specified, the classtype must be a subclass of the interface
- "org.apache.struts.tiles.beans.MenuItem".
-
- icon The bean 'icon' property.
-
- link The bean 'link' property.
-
- tooltip The bean 'tooltip' property.
-
- value The bean 'value' property.
-->
<!ELEMENT item (#PCDATA)>
<!ATTLIST item id ID #IMPLIED>
+<!--
+@attr classtype The fully qualified classtype for this bean.
+ If specified, the classtype must be a subclass of the interface
+ "org.apache.struts.tiles.beans.MenuItem".
+-->
<!ATTLIST item classtype %ClassName; #IMPLIED>
+<!--
+@attr icon The bean 'icon' property.
+-->
<!ATTLIST item icon CDATA #IMPLIED>
+<!--
+@attr link The bean 'link' property.
+-->
<!ATTLIST item link CDATA #REQUIRED>
+<!--
+@attr tooltip The bean 'tooltip' property.
+-->
<!ATTLIST item tooltip CDATA #IMPLIED>
+<!--
+@attr value The bean 'value' property.
+-->
<!ATTLIST item value CDATA #REQUIRED>