geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ccard...@apache.org
Subject svn commit: r511458 [4/5] - in /geronimo/server/trunk/modules: geronimo-client-builder/src/main/schema/ geronimo-connector-builder/src/main/schema/ geronimo-j2ee-builder/src/main/schema/ geronimo-jetty6-builder/src/main/schema/ geronimo-naming-builder/...
Date Sun, 25 Feb 2007 06:29:16 GMT
Modified: geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/attributes-1.1.xsd
URL: http://svn.apache.org/viewvc/geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/attributes-1.1.xsd?view=diff&rev=511458&r1=511457&r2=511458
==============================================================================
--- geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/attributes-1.1.xsd (original)
+++ geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/attributes-1.1.xsd Sat Feb 24 22:29:15 2007
@@ -6,9 +6,9 @@
     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
-
+    
+        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.
@@ -18,17 +18,21 @@
 
 <!-- $Rev$ $Date$ -->
 
-<xsd:schema
-    targetNamespace="http://geronimo.apache.org/xml/ns/attributes-1.1"
+<xsd:schema targetNamespace="http://geronimo.apache.org/xml/ns/attributes-1.1"
     xmlns:atts="http://geronimo.apache.org/xml/ns/attributes-1.1"
-    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-    elementFormDefault="qualified"
+    xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
     attributeFormDefault="unqualified">
 
     <xsd:annotation>
         <xsd:documentation>
-            The definition of the XML format for storing manageable attribute values.
-            Should look like this:
+            This is an XML Schema Definition for storing manageable attribute
+            values. All the schema's or plans using elements of this schema must
+            specify the top level element with one of the namespace specified as
+            "http://geronimo.apache.org/xml/ns/j2ee/attributes-1.1". The default
+            location for this document is
+            http://geronimo.apache.org/schemas-1.1/attributes-1.1.xsd. The
+            definition of the XML format for storing manageable attribute
+            values. Should look like this:
             <![CDATA[
             <attributes>
                 <module name="mygroup/mycomponent/1.1/jar">
@@ -43,84 +47,205 @@
     </xsd:annotation>
 
     <!-- Main element for the manageable attribute store configuration -->
-    <xsd:element name="attributes" type="atts:attributesType"/>
-
-    <!-- Element used by the plugin system to list individual GBeans -->
-    <xsd:element name="gbean" type="atts:gbeanType"/>
+    <xsd:element name="attributes" type="atts:attributesType">
+        <xsd:annotation>
+            <xsd:documentation>
+                Provides the definition of named attributes. Attributes are
+                mixed type and can include simple text and elements.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
+    <xsd:element name="gbean" type="atts:gbeanType">
+        <xsd:annotation>
+            <xsd:documentation>
+                Element used by the plugin system to list individual GBeans.
+                Note that the name attribute for a gbean element may hold either
+                the full GBeanName, or only the value for the "name=" portion of
+                the GBeanName. If there are multiple GBeans in the module with
+                manageable attributes and the same "name=" portion of the
+                GBeanName, then all must be listed and all must be listed with a
+                full GBeanName.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:complexType name="attributesType">
         <xsd:choice>
-            <xsd:element name="module" type="atts:moduleType" minOccurs="0" maxOccurs="unbounded"/>
+            <xsd:element name="module" type="atts:moduleType" minOccurs="0"
+                maxOccurs="unbounded" />
 
             <!-- The config.xml file in 1.0 use configuration instead of module -->
-            <xsd:element name="configuration" type="atts:moduleType" minOccurs="0" maxOccurs="unbounded"/>
+            <xsd:element name="configuration" type="atts:moduleType"
+                minOccurs="0" maxOccurs="unbounded" />
         </xsd:choice>
     </xsd:complexType>
 
     <xsd:complexType name="moduleType">
         <xsd:sequence>
-            <xsd:element name="gbean" type="atts:gbeanType" minOccurs="0" maxOccurs="unbounded"/>
+            <xsd:element name="gbean" type="atts:gbeanType" minOccurs="0"
+                maxOccurs="unbounded" />
         </xsd:sequence>
-        <xsd:attribute name="name" type="xsd:string" use="required"/>
-        <xsd:attribute name="load" type="xsd:boolean" use="optional" default="true"/>
-        <xsd:attribute name="condition" type="xsd:string" use="optional"/>
+        <xsd:attribute name="name" type="xsd:string" use="required" />
+        <xsd:attribute name="load" type="xsd:boolean" use="optional"
+            default="true" />
+        <xsd:attribute name="condition" type="xsd:string" use="optional" />
     </xsd:complexType>
 
     <xsd:complexType name="gbeanType">
         <xsd:annotation>
             <xsd:documentation>
-                Note that the name attribute for a gbean element may hold
-                either the full GBeanName, or only the value for the
-                "name=" portion of the GBeanName.  If there are multiple
-                GBeans in the module with manageable attributes and
-                the same "name=" portion of the GBeanName, then all must be
-                listed and all must be listed with a full GBeanName.
+                Element used by the plugin system to list individual GBeans.
+                Note that the name attribute for a gbean element may hold either
+                the full GBeanName, or only the value for the "name=" portion of
+                the GBeanName. If there are multiple GBeans in the module with
+                manageable attributes and the same "name=" portion of the
+                GBeanName, then all must be listed and all must be listed with a
+                full GBeanName.
             </xsd:documentation>
         </xsd:annotation>
         <xsd:choice minOccurs="0" maxOccurs="unbounded">
-            <xsd:element name="attribute" type="atts:attributeType"/>
-            <xsd:element name="reference" type="atts:referenceType"/>
+            <xsd:element name="attribute" type="atts:attributeType" />
+            <xsd:element name="reference" type="atts:referenceType" />
         </xsd:choice>
-        <xsd:attribute name="name" type="xsd:string" use="required"/>
-        <xsd:attribute name="gbeanInfo" type="xsd:string" use="optional"/>
-        <xsd:attribute name="load" type="xsd:boolean" use="optional" default="true"/>
+        <xsd:attribute name="name" type="xsd:string" use="required">
+            <xsd:annotation>
+                <xsd:documentation>
+                    The name attribute specifies the name portion of the
+                    GBeanName.
+                </xsd:documentation>
+            </xsd:annotation>
+        </xsd:attribute>
+        <xsd:attribute name="gbeanInfo" type="xsd:string" use="optional">
+            <xsd:annotation>
+                <xsd:documentation>
+                    The gbeanInfo attribute provide the gbean infomation for
+                    specified GBean.
+                </xsd:documentation>
+            </xsd:annotation>
+        </xsd:attribute>
+        <xsd:attribute name="load" type="xsd:boolean" use="optional"
+            default="true">
+            <xsd:annotation>
+                <xsd:documentation>
+                    The load attribute specifies if the gbean is to be loaded or
+                    not.
+                </xsd:documentation>
+            </xsd:annotation>
+        </xsd:attribute>
     </xsd:complexType>
 
     <xsd:complexType name="attributeType">
         <xsd:annotation>
             <xsd:documentation>
-                Provides the definition of a single named attribute.  Attributes are mixed type
-                and can include simple text and elements.
+                Provides the definition of a single named attribute. Attributes
+                are mixed type and can include simple text and elements.
             </xsd:documentation>
         </xsd:annotation>
         <xsd:complexContent mixed="true">
             <xsd:restriction base="xsd:anyType">
                 <xsd:sequence>
-                    <xsd:any minOccurs="0" maxOccurs="unbounded" processContents="lax"/>
+                    <xsd:any minOccurs="0" maxOccurs="unbounded"
+                        processContents="lax" />
                 </xsd:sequence>
-                <xsd:attribute name="name" use="required"/>
-                <xsd:attribute name="null" use="optional"/>
-                <xsd:attribute name="value" use="optional"/>
+                <xsd:attribute name="name" use="required">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The name attribute provides the name of single
+                            attribute.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:attribute>
+                <xsd:attribute name="null" use="optional">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The null attribute defines if this atribute is null
+                            or not.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:attribute>
+                <xsd:attribute name="value" use="optional">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The value attribute is the value of specified
+                            attribute.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:attribute>
             </xsd:restriction>
         </xsd:complexContent>
     </xsd:complexType>
-    
+
     <xsd:complexType name="referenceType">
         <xsd:sequence>
             <xsd:element name="pattern" minOccurs="0" maxOccurs="unbounded">
-              <xsd:complexType>
-                  <xsd:sequence>
-                      <xsd:element name="groupId" type="xsd:string" minOccurs="0"/>
-                      <xsd:element name="artifactId" type="xsd:string" minOccurs="0"/>
-                      <xsd:element name="version" type="xsd:string" minOccurs="0"/>
-                      <xsd:element name="type" type="xsd:string" minOccurs="0"/>
-                      <xsd:element name="module" type="xsd:string" minOccurs="0"/>
-                      <xsd:element name="name" type="xsd:string"/>
-                  </xsd:sequence>
-              </xsd:complexType>
+                <xsd:complexType>
+                    <xsd:sequence>
+                        <xsd:element name="groupId" type="xsd:string"
+                            minOccurs="0">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The name for group containing module to
+                                    match. By default is set to wild card '*'.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                        <xsd:element name="artifactId" type="xsd:string"
+                            minOccurs="0">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The name for module in a specified group to
+                                    be matched. All the artifactId's should be
+                                    unique within a group. If no articfactId is
+                                    provided it will be defaulted to file name
+                                    of the module file.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                        <xsd:element name="version" type="xsd:string"
+                            minOccurs="0">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The version number for the module formatted
+                                    by dot separated numbers. If no version is
+                                    provided it will be defaulted to latest
+                                    available version matching other criterions.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                        <xsd:element name="type" type="xsd:string"
+                            minOccurs="0">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    This element defines the type of the module.
+                                    The type could be 'CAR', 'JAR', EAR', 'WAR'
+                                    etc. If no type is provided it will be
+                                    defaulted appropriately by the deployer
+                                    depending upon type of deployed module.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                        <xsd:element name="module" type="xsd:string"
+                            minOccurs="0">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The value specified here should match the
+                                    file name of the module referenced.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                        <xsd:element name="name" type="xsd:string">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The name element to identify the referenced
+                                    GBean by name.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                    </xsd:sequence>
+                </xsd:complexType>
             </xsd:element>
         </xsd:sequence>
-        <xsd:attribute name="name" type="xsd:string"/>
+        <xsd:attribute name="name" type="xsd:string" />
     </xsd:complexType>
 
 </xsd:schema>

Modified: geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/plugins-1.1.xsd
URL: http://svn.apache.org/viewvc/geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/plugins-1.1.xsd?view=diff&rev=511458&r1=511457&r2=511458
==============================================================================
--- geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/plugins-1.1.xsd (original)
+++ geronimo/server/trunk/modules/geronimo-system/src/main/resources/META-INF/schema/plugins-1.1.xsd Sat Feb 24 22:29:15 2007
@@ -1,15 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-
     Licensed to the Apache Software Foundation (ASF) under one or more
     contributor license agreements.  See the NOTICE file distributed with
     this work for additional information regarding copyright ownership.
     The ASF licenses this file to You under the Apache License, Version 2.0
     (the "License"); you may not use this file except in compliance with
     the License.  You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
+    
+        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.
@@ -17,85 +16,103 @@
     limitations under the License.
 -->
 
-<xs:schema
-        targetNamespace="http://geronimo.apache.org/xml/ns/plugins-1.1"
-        xmlns:list="http://geronimo.apache.org/xml/ns/plugins-1.1"
-        xmlns:atts="http://geronimo.apache.org/xml/ns/attributes-1.1"
-        xmlns:xs="http://www.w3.org/2001/XMLSchema"
-        elementFormDefault="qualified"
-        attributeFormDefault="unqualified"
-        >
+<xs:schema targetNamespace="http://geronimo.apache.org/xml/ns/plugins-1.1"
+    xmlns:list="http://geronimo.apache.org/xml/ns/plugins-1.1"
+    xmlns:atts="http://geronimo.apache.org/xml/ns/attributes-1.1"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
+    attributeFormDefault="unqualified">
+
+    <xs:annotation>
+        <xs:documentation>
+            This is an XML Schema Definition for a list of Geronimo plugins
+            available at some external site (e.g., a Maven 2 repository). All
+            the Geronimo plugin list document must specify the top level element
+            as geronimo-plugin-list with namespace specified as
+            xmlns="http://geronimo.apache.org/xml/ns/j2ee/plugins-1.2". The
+            default location for this document is
+            http://geronimo.apache.org/schemas-1.2/plugins-1.2.xsd
+        </xs:documentation>
+    </xs:annotation>
 
     <xs:import namespace="http://geronimo.apache.org/xml/ns/attributes-1.1"
-               schemaLocation="attributes-1.1.xsd"/>
+        schemaLocation="attributes-1.1.xsd" />
 
     <xs:annotation>
         <xs:documentation>
-            Schema for a list of Geronimo plugins available at some external site
-            (namely, a Maven 2 repository).
+            Schema for a list of Geronimo plugins available at some external
+            site (namely, a Maven 2 repository).
         </xs:documentation>
     </xs:annotation>
 
-    <!--   Top-level elements   -->
+    <!-- Top-level elements -->
 
     <xs:element name="geronimo-plugin-list" type="list:plugin-listType">
         <xs:annotation>
             <xs:documentation>
-                The geronimo-plugin-list root element is used for the config file present
-                in the root directory of a Maven repository supporting Geronimo plugin
-                downloads. This will be scanned by Geronimo clients to determine what
-                plugins are available on that server.
+                The geronimo-plugin-list root element is used for the config
+                file present in the root directory of a Maven repository
+                supporting Geronimo plugin downloads. This will be scanned by
+                Geronimo clients to determine what plugins are available on that
+                server.
             </xs:documentation>
         </xs:annotation>
     </xs:element>
     <xs:element name="geronimo-plugin" type="list:pluginType">
         <xs:annotation>
             <xs:documentation>
-                The geronimo-plugin root element is used as the config file submitted
-                with an individual Geronimo plugin to the plugin repository. It will be
-                merged into the plugin list for the repository when the submitted plugin
-                is accepted.
-
-                It is also used for the metadata packed into a plugin when a plugin archive
-                is downloaded from an online repository for local installation, in which
-                case it should be packed into the archive at META-INF/geronimo-plugin.xml
+                The geronimo-plugin root element is used as the config file
+                submitted with an individual Geronimo plugin to the plugin
+                repository. It will be merged into the plugin list for the
+                repository when the submitted plugin is accepted.
+
+                It is also used for the metadata packed into a plugin when a
+                plugin archive is downloaded from an online repository for local
+                installation, in which case it should be packed into the archive
+                at META-INF/geronimo-plugin.xml
             </xs:documentation>
         </xs:annotation>
     </xs:element>
 
-    <!--   Data types used in this schema   -->
+    <!-- Data types used in this schema -->
 
     <!-- Format for a list of available plugins provided by a remote repository -->
     <xs:complexType name="plugin-listType">
         <xs:sequence>
-            <xs:element name="plugin" type="list:pluginType" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="plugin" type="list:pluginType" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        The list of plugins available in the current plugin repository.
+                        The list of plugins available in the current plugin
+                        repository.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="default-repository" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="default-repository" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        Each default-repository is a URL to check for any dependencies that
-                        need to be downloaded.  Different values can be used, for example, to
-                        host Geronimo plugins at one site and common third-party JARs at
-                        another site, or to maintain a plugin list at a site that is not
-                        actually a repository.
+                        Each default-repository is a URL to check for any
+                        dependencies that need to be downloaded. Different
+                        values can be used, for example, to host Geronimo
+                        plugins at one site and common third-party JARs at
+                        another site, or to maintain a plugin list at a site
+                        that is not actually a repository.
 
-                        The URL where this fill is downloaded from must list itself as the
-                        first default-repository if it wants to be checked for file
-                        downloads in addition to hosting the plugin list.  For every
-                        dnwload, each of the repositories listed here will be checked in
-                        the order listed until the artifact is found.  However, if a
-                        plugin in the list includes its own source-repository list, those
-                        repositories will be used instead of these list-level repositories
-                        when downloading that plugin or its dependencies.
+                        The URL where this fill is downloaded from must list
+                        itself as the first default-repository if it wants to be
+                        checked for file downloads in addition to hosting the
+                        plugin list. For every download, each of the
+                        repositories listed here will be checked in the order
+                        listed until the artifact is found. However, if a plugin
+                        in the list includes its own source-repository list,
+                        those repositories will be used instead of these
+                        list-level repositories when downloading that plugin or
+                        its dependencies.
 
-                        Note that while the primary repository may be protected by HTTP
-                        Basic authentication, the backup repositories must either use the
-                        same username and password as the primary or use no authentication.
+                        Note that while the primary repository may be protected
+                        by HTTP Basic authentication, the backup repositories
+                        must either use the same username and password as the
+                        primary or use no authentication.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
@@ -107,20 +124,23 @@
             <xs:element name="name" type="xs:string">
                 <xs:annotation>
                     <xs:documentation>
-                        A human-readable name for this plugin. This will be used to identify
-                        the plugin to a user when giving them a list of plugins to select from.
+                        A human-readable name for this plugin. This will be used
+                        to identify the plugin to a user when giving them a list
+                        of plugins to select from.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
             <xs:element name="module-id" type="xs:string" minOccurs="0">
                 <xs:annotation>
                     <xs:documentation>
-                        The Geronimo moduleId for this plugins, which uniquely identifies
-                        it, and also is used to construct a path to download it if necessary.
-
-                        If no module-id is provided, that means this is a plugin group, which is
-                        just a list of other plugins to install.  The prerequisites must still be
-                        met, but then the dependencies listed for this plugin will be treated as
+                        The Geronimo moduleId for this plugins, which uniquely
+                        identifies it, and also is used to construct a path to
+                        download it if necessary.
+
+                        If no module-id is provided, that means this is a plugin
+                        group, which is just a list of other plugins to install.
+                        The prerequisites must still be met, but then the
+                        dependencies listed for this plugin will be treated as
                         the list of actual plugins to install.
                     </xs:documentation>
                 </xs:annotation>
@@ -128,200 +148,242 @@
             <xs:element name="category" type="xs:string">
                 <xs:annotation>
                     <xs:documentation>
-                        A category name for this plugin. The user interface typically groups
-                        plugins by their category name, so this should match the value for other
-                        plugins in the same category.
+                        A category name for this plugin. The user interface
+                        typically groups plugins by their category name, so this
+                        should match the value for other plugins in the same
+                        category.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
             <xs:element name="description" type="xs:string">
                 <xs:annotation>
                     <xs:documentation>
-                        A description of this plugin. This will be displayed when the user
-                        looks for more information about this plugin. It typically includes
-                        a description of what it does, what if any third-party software it's
-                        based on, why it would be interesting to use it, etc.
-
-                        Currently this should be plain text, where whitespace is not significant
-                        except an entirely blank line indicates a paragraph break (like this
-                        documentation, for example). This may change to a more structured format
-                        in the future, if we can agree on what that ought to be.
+                        A description of this plugin. This will be displayed
+                        when the user looks for more information about this
+                        plugin. It typically includes a description of what it
+                        does, what if any third-party software it's based on,
+                        why it would be interesting to use it, etc.
+
+                        Currently this should be plain text, where whitespace is
+                        not significant except an entirely blank line indicates
+                        a paragraph break (like this documentation, for
+                        example). This may change to a more structured format in
+                        the future, if we can agree on what that ought to be.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
             <xs:element name="url" type="xs:string" minOccurs="0">
                 <xs:annotation>
                     <xs:documentation>
-                        The URL for a site that contains more detailed information about this
-                        plugin.  The plugin repository has access to the basic information
-                        provided in this file, but a plugin may have a home page with more
-                        detailed information, documentation, source code, etc.
+                        The URL for a site that contains more detailed
+                        information about this plugin. The plugin repository has
+                        access to the basic information provided in this file,
+                        but a plugin may have a home page with more detailed
+                        information, documentation, source code, etc.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
             <xs:element name="author" type="xs:string" minOccurs="0">
                 <xs:annotation>
                     <xs:documentation>
-                        Names the author of the plugin.  This may be a person, a company, an
-                        open source project, or whatever.  Basically, this gives some idea who
-                        submitted the plugin, perhaps where to go for support, etc.
+                        Names the author of the plugin. This may be a person, a
+                        company, an open source project, or whatever. Basically,
+                        this gives some idea who submitted the plugin, perhaps
+                        where to go for support, etc.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="license" type="list:licenseType" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="license" type="list:licenseType" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        The name of the license that applies to this plugin, usually composed of a
-                        license class (if any) followed by the name and version of a license:
-                        BSD -- Apache Software License (ASL) 2.0
-                        GPL -- Lesser General Public License (LGPL) 2
+                        The name of the license that applies to this plugin,
+                        usually composed of a license class (if any) followed by
+                        the name and version of a license: BSD -- Apache
+                        Software License (ASL) 2.0 GPL -- Lesser General Public
+                        License (LGPL) 2
 
-                        If there is more than one license listed then that means the user may choose
-                        among any of the available licenses.
+                        If there is more than one license listed then that means
+                        the user may choose among any of the available licenses.
 
-                        Contains a mandatory true/false attribute indicating whether this license
-                        is OSI-approved (e.g. whether the plugin is open source).
+                        Contains a mandatory true/false attribute indicating
+                        whether this license is OSI-approved (e.g. whether the
+                        plugin is open source).
 
-                        Note that the license declared here applies only to the current component.
-                        Any dependencies may be licensed separately.
+                        Note that the license declared here applies only to the
+                        current component. Any dependencies may be licensed
+                        separately.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
             <xs:element name="hash" type="list:hashType" minOccurs="0">
                 <xs:annotation>
                     <xs:documentation>
-                        A hash value (typically MD5 or SHA-1) that applies to the plugin download
-                        file.  This can be used to confirm that a plugin download was complete, and
-                        to ensure that the file downloaded is the same as the file originally
+                        A hash value (typically MD5 or SHA-1) that applies to
+                        the plugin download file. This can be used to confirm
+                        that a plugin download was complete, and to ensure that
+                        the file downloaded is the same as the file originally
                         posted to the repository.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="geronimo-version" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="geronimo-version" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        Indicates a version of the Geronimo base server that this plugin can run in.
-                        If no geronimo-version is listed, that means the plugin can run in any version
-                        of Geronimo so long as the prerequisites, parents, and dependencies are present.
-                        If one or more geronimo-version elements are listed, then the current version of
-                        Geronimo must match one of them in order for this plugin to be installable.
+                        Indicates a version of the Geronimo base server that
+                        this plugin can run in. If no geronimo-version is
+                        listed, that means the plugin can run in any version of
+                        Geronimo so long as the prerequisites, parents, and
+                        dependencies are present. If one or more
+                        geronimo-version elements are listed, then the current
+                        version of Geronimo must match one of them in order for
+                        this plugin to be installable.
 
-                        This is applied as an exact match: 1.2 does not match 1.2.1 or 1.2-SNAPSHOT
+                        This is applied as an exact match: 1.2 does not match
+                        1.2.1 or 1.2-SNAPSHOT
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="jvm-version" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="jvm-version" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        Indicates a version of the JVM that this plugin can run in. If no jvm-version
-                        is listed, that means the plugin can run in any version of the JVM supported
-                        by Geronimo so long as the prerequisites, parents, and dependencies are present.
-                        If one or more jvm-version elements are listed, then the JVM that Geronimo is
-                        currently running on must match one of them in order for this plugin to be
-                        installable. (It does not stop you from restarting Geronimo on a different JVM
-                        version once the components is already installed.)
+                        Indicates a version of the JVM that this plugin can run
+                        in. If no jvm-version is listed, that means the plugin
+                        can run in any version of the JVM supported by Geronimo
+                        so long as the prerequisites, parents, and dependencies
+                        are present. If one or more jvm-version elements are
+                        listed, then the JVM that Geronimo is currently running
+                        on must match one of them in order for this plugin to be
+                        installable. (It does not stop you from restarting
+                        Geronimo on a different JVM version once the components
+                        is already installed.)
 
-                        This is not normally used, but must be for plugins that use CORBA or
-                        serialized QNames, etc.
+                        This is not normally used, but must be for plugins that
+                        use CORBA or serialized QNames, etc.
 
-                        This is applied as a prefix match: 1.4 matches 1.4.2 or 1.4.2_10
+                        This is applied as a prefix match: 1.4 matches 1.4.2 or
+                        1.4.2_10
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="prerequisite" type="list:prerequisiteType" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="prerequisite" type="list:prerequisiteType"
+                minOccurs="0" maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        A dependency of this plugin that must be previously installed if this
-                        plugin is to be considered to be installable. This is generally the
-                        same as the dependency element (for example, it may refer to a plugin
-                        by moduleId or a JAR by repository ID) except that the dependency will not
-                        be downloaded on demand and must have been previously installed.
+                        A dependency of this plugin that must be previously
+                        installed if this plugin is to be considered to be
+                        installable. This is generally the same as the
+                        dependency element (for example, it may refer to a
+                        plugin by moduleId or a JAR by repository ID) except
+                        that the dependency will not be downloaded on demand and
+                        must have been previously installed.
 
-                        This is currently used for a web application to specify the web container it
-                        runs in (so we don't show Tomcat downloads for a Jetty installation, etc.). It
-                        may be used for similar things in the future if more distribution choices are
-                        added to Geronimo.
+                        This is currently used for a web application to specify
+                        the web container it runs in (so we don't show Tomcat
+                        downloads for a Jetty installation, etc.). It may be
+                        used for similar things in the future if more
+                        distribution choices are added to Geronimo.
 
-                        It is also used by the public Geronimo plugin repository in cases where the
-                        dependencies cannot be redistributed (e.g. a dependency on a commercial JDBC
-                        driver JAR which must be manually acquired and installed).
+                        It is also used by the public Geronimo plugin repository
+                        in cases where the dependencies cannot be redistributed
+                        (e.g. a dependency on a commercial JDBC driver JAR which
+                        must be manually acquired and installed).
 
-                        It is also used when a user must set something up (like a database pool or
-                        security realm) to point to a custom resource in their environment before the
-                        plugin can be installed.
+                        It is also used when a user must set something up (like
+                        a database pool or security realm) to point to a custom
+                        resource in their environment before the plugin can be
+                        installed.
 
-                        This is applied as an exact match, except that the version number may be
-                        omitted, in which case any matching version of the dependency will work.
+                        This is applied as an exact match, except that the
+                        version number may be omitted, in which case any
+                        matching version of the dependency will work.
 
-                        It has an optional resource-type attribute indicating to the user what type
-                        of prerequisite this is (for cases where they're expected to set something up
-                        as opposed to just downloading a JAR). e.g. it could be set to "JDBC Pool".
-                        Likewise there is an option description to provide more detailed guidance for
-                        how to resolve the prerequisite.
+                        It has an optional resource-type attribute indicating to
+                        the user what type of prerequisite this is (for cases
+                        where they're expected to set something up as opposed to
+                        just downloading a JAR). e.g. it could be set to "JDBC
+                        Pool". Likewise there is an option description to
+                        provide more detailed guidance for how to resolve the
+                        prerequisite.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="dependency" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="dependency" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        The moduleId of another plugin or Geronimo module, or the repository ID of
-                        a 3rd party JAR that this plugin depends on. That means that the dependency
-                        must be downloaded and installed if this plugin is selected.
+                        The moduleId of another plugin or Geronimo module, or
+                        the repository ID of a 3rd party JAR that this plugin
+                        depends on. That means that the dependency must be
+                        downloaded and installed if this plugin is selected.
 
-                        This is applied as an exact match, except that the version number may be
-                        omitted, in which case any matching version of the dependency will work.
+                        This is applied as an exact match, except that the
+                        version number may be omitted, in which case any
+                        matching version of the dependency will work.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="obsoletes" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="obsoletes" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        The moduleId of another plugin or Geronimo module that this plugin replaces.
-                        That can be used, for example, to replace a less functional module
-                        with a more functional one, or to upgrade a component to a newer version.
+                        The moduleId of another plugin or Geronimo module that
+                        this plugin replaces. That can be used, for example, to
+                        replace a less functional module with a more functional
+                        one, or to upgrade a component to a newer version.
 
-                        This is applied as an exact match, except that the version number may be
-                        omitted, in which case any matching version of the module or plugin will be
-                        replaced.  Be aware that omitting the version number may cause a
-                        plugin to be downgraded, so you may choose to explicitly list all
-                        lesser versions.  That may not be desirable either, though.  If the
-                        server has foo-1.0.2 installed and you install foo-1.0.1, would you
-                        rather have it downgrade or end up with both installed?
+                        This is applied as an exact match, except that the
+                        version number may be omitted, in which case any
+                        matching version of the module or plugin will be
+                        replaced. Be aware that omitting the version number may
+                        cause a plugin to be downgraded, so you may choose to
+                        explicitly list all lesser versions. That may not be
+                        desirable either, though. If the server has foo-1.0.2
+                        installed and you install foo-1.0.1, would you rather
+                        have it downgrade or end up with both installed?
 
-                        NOTE: currently the "obsoletes" entries are only processed on the
-                        plugin(s) passed directly to the PluginInstaller (not on dependencies that
-                        are brought down as a result).  That means that a plugin group must list
-                        obsoletes for all its components, etc.
+                        NOTE: currently the "obsoletes" entries are only
+                        processed on the plugin(s) passed directly to the
+                        PluginInstaller (not on dependencies that are brought
+                        down as a result). That means that a plugin group must
+                        list obsoletes for all its components, etc.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="source-repository" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="source-repository" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        The base URL for the repository that this plugin should be downloaded from.
-                        The repositories listed here will be consulted in the order listed every
-                        time something needs to be downloaded, and the search will stop at the
-                        first repository that holds any matching plugin or JAR.
+                        The base URL for the repository that this plugin should
+                        be downloaded from. The repositories listed here will be
+                        consulted in the order listed every time something needs
+                        to be downloaded, and the search will stop at the first
+                        repository that holds any matching plugin or JAR.
 
-                        In a normal plugin list, the repositories are specified at the list level,
-                        and do not need to be repeated at the plugin level.  However, any values
-                        specified at the plugin level replace the values specified at the list
-                        level.  This can be used to maintain a single list of plugins from multiple
-                        sources.
+                        In a normal plugin list, the repositories are specified
+                        at the list level, and do not need to be repeated at the
+                        plugin level. However, any values specified at the
+                        plugin level replace the values specified at the list
+                        level. This can be used to maintain a single list of
+                        plugins from multiple sources.
 
-                        This value is required if this is not a plugin list but metadata for a
-                        single plugin included in a plugin file downloaded from a repository.
-                        Otherwise, the installer would not know where to download any dependencies
-                        from.
+                        This value is required if this is not a plugin list but
+                        metadata for a single plugin included in a plugin file
+                        downloaded from a repository. Otherwise, the installer
+                        would not know where to download any dependencies from.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
-            <xs:element name="copy-file" type="list:copy-fileType" minOccurs="0" maxOccurs="unbounded">
+            <xs:element name="copy-file" type="list:copy-fileType" minOccurs="0"
+                maxOccurs="unbounded">
                 <xs:annotation>
                     <xs:documentation>
-                        Lets a plugin include files that should be copied into the Geronimo
-                        installation tree, beyond copying the plugin into the repository.  For
-                        example, this could be used to copy files into geronimo/bin, geronimo/lib,
+                        Lets a plugin include files that should be copied into
+                        the Geronimo installation tree, beyond copying the
+                        plugin into the repository. For example, this could be
+                        used to copy files into geronimo/bin, geronimo/lib,
                         geronimo/var/security/keystores, or other Geronimo dirs.
                     </xs:documentation>
                 </xs:annotation>
@@ -329,16 +391,17 @@
             <xs:element name="config-xml-content" minOccurs="0">
                 <xs:annotation>
                     <xs:documentation>
-                        Lets a plugin declare data that should be inserted into config.xml
-                        when the plugin is installed.  This is normally used to add ports
-                        and other settings that the user is likely to want to change.  The
-                        gbean entries declared here will be written into config.xml for the
+                        Lets a plugin declare data that should be inserted into
+                        config.xml when the plugin is installed. This is
+                        normally used to add ports and other settings that the
+                        user is likely to want to change. The gbean entries
+                        declared here will be written into config.xml for the
                         new module when the plugin is installed.
                     </xs:documentation>
                 </xs:annotation>
                 <xs:complexType>
                     <xs:sequence>
-                        <xs:element ref="atts:gbean" maxOccurs="unbounded"/>
+                        <xs:element ref="atts:gbean" maxOccurs="unbounded" />
                     </xs:sequence>
                 </xs:complexType>
             </xs:element>
@@ -347,21 +410,23 @@
 
     <xs:complexType name="licenseType">
         <xs:annotation>
-            <xs:documentation>
-                See pluginType/license above
-            </xs:documentation>
+            <xs:documentation>See pluginType/license above</xs:documentation>
         </xs:annotation>
 
         <xs:simpleContent>
             <xs:extension base="xs:string">
-                <xs:attribute name="osi-approved" use="required" type="xs:boolean">
+                <xs:attribute name="osi-approved" use="required"
+                    type="xs:boolean">
                     <xs:annotation>
                         <xs:documentation>
-                            Indicates whether this license is OSI-approved, which is to say, whether
-                            the plugin is open source. Typically this is true for all licenses
-                            you'd expect to be open source, and false for proprietary plugins.
+                            Indicates whether this license is OSI-approved,
+                            which is to say, whether the plugin is open source.
+                            Typically this is true for all licenses you'd expect
+                            to be open source, and false for proprietary
+                            plugins.
 
-                            If there's some doubt, visit http://www.opensource.org/licenses/index.php
+                            If there's some doubt, visit
+                            http://www.opensource.org/licenses/index.php
                         </xs:documentation>
                     </xs:annotation>
                 </xs:attribute>
@@ -371,25 +436,26 @@
 
     <xs:complexType name="dependencyType">
         <xs:annotation>
-            <xs:documentation>
-                See pluginType/dependency above
-            </xs:documentation>
+            <xs:documentation>See pluginType/dependency above</xs:documentation>
         </xs:annotation>
 
         <xs:simpleContent>
             <xs:extension base="xs:string">
-                <xs:attribute name="start" use="optional" type="xs:boolean" default="false">
+                <xs:attribute name="start" use="optional" type="xs:boolean"
+                    default="false">
                     <xs:annotation>
                         <xs:documentation>
-                            Normally when a plugin dependency is installed it will not
-                            be started.  The user may be prompted to start the plugin
-                            with whatever tool kicked off the install to begin with.
-
-                            This attribute may be set to "true" to force the plugin to
-                            be started after it is installed.  NOTE: this currently only
-                            affects the dependencies of the plugins actually passed to
-                            the PluginInstaller (not nested dependencies).  This
-                            means it's primarily useful for plugin lists.
+                            Normally when a plugin dependency is installed it
+                            will not be started. The user may be prompted to
+                            start the plugin with whatever tool kicked off the
+                            install to begin with.
+
+                            This attribute may be set to "true" to force the
+                            plugin to be started after it is installed. NOTE:
+                            this currently only affects the dependencies of the
+                            plugins actually passed to the PluginInstaller (not
+                            nested dependencies). This means it's primarily
+                            useful for plugin lists.
                         </xs:documentation>
                     </xs:annotation>
                 </xs:attribute>
@@ -399,9 +465,7 @@
 
     <xs:complexType name="hashType">
         <xs:annotation>
-            <xs:documentation>
-                See pluginType/hash above
-            </xs:documentation>
+            <xs:documentation>See pluginType/hash above</xs:documentation>
         </xs:annotation>
 
         <xs:simpleContent>
@@ -409,17 +473,17 @@
                 <xs:attribute name="type" use="required">
                     <xs:annotation>
                         <xs:documentation>
-                            Indicates the type of hash.  The values presently supported are:
+                            Indicates the type of hash. The values presently
+                            supported are:
 
-                                  MD5
-                                  SHA-1
+                            MD5 SHA-1
 
                         </xs:documentation>
                     </xs:annotation>
                     <xs:simpleType>
                         <xs:restriction base="xs:NMTOKEN">
-                            <xs:enumeration value="MD5"/>
-                            <xs:enumeration value="SHA-1"/>
+                            <xs:enumeration value="MD5" />
+                            <xs:enumeration value="SHA-1" />
                         </xs:restriction>
                     </xs:simpleType>
                 </xs:attribute>
@@ -430,11 +494,11 @@
     <xs:complexType name="copy-fileType">
         <xs:annotation>
             <xs:documentation>
-                The name of a file in the plugin archive that should be copied into
-                the server installation tree somewhere when the plugin is installed.
-                There may be a path component (relative to the root of the plugin
-                archive), though that will not be used to construct the destination
-                location.  For example:
+                The name of a file in the plugin archive that should be copied
+                into the server installation tree somewhere when the plugin is
+                installed. There may be a path component (relative to the root
+                of the plugin archive), though that will not be used to
+                construct the destination location. For example:
 
                 <copy-file relative-to="server" dest-dir="security/keystores">
                     resources/keystores/my-keystore
@@ -450,28 +514,27 @@
                 <xs:attribute name="relative-to" use="required">
                     <xs:annotation>
                         <xs:documentation>
-                            Indicates whether the destination is relative to the Geronimo install
-                            directory or the server instance var/ directory.  The values presently
-                            supported are:
+                            Indicates whether the destination is relative to the
+                            Geronimo install directory or the server instance
+                            var/ directory. The values presently supported are:
 
-                                  geronimo
-                                  server
+                            geronimo server
 
                         </xs:documentation>
                     </xs:annotation>
                     <xs:simpleType>
                         <xs:restriction base="xs:NMTOKEN">
-                            <xs:enumeration value="geronimo"/>
-                            <xs:enumeration value="server"/>
+                            <xs:enumeration value="geronimo" />
+                            <xs:enumeration value="server" />
                         </xs:restriction>
                     </xs:simpleType>
                 </xs:attribute>
                 <xs:attribute name="dest-dir" use="required" type="xs:string">
                     <xs:annotation>
                         <xs:documentation>
-                            The directory to copy the file to, relative to either the Geronimo
-                            install dir or the server's home directory (normally var/ but may
-                            vary).
+                            The directory to copy the file to, relative to
+                            either the Geronimo install dir or the server's home
+                            directory (normally var/ but may vary).
                         </xs:documentation>
                     </xs:annotation>
                 </xs:attribute>
@@ -484,67 +547,72 @@
             <xs:element name="id" type="xs:string">
                 <xs:annotation>
                     <xs:documentation>
-                        The Module ID of the prerequisite. This is used to check whether
-                        it's available on the server that you're downloading the plugin
-                        into. It may omit some portions of the Module ID to be more
-                        accomodating (e.g. "*/MyDBPool/*/*" to identify a database pool
-                        instead of "console/MyDBPool/1.0/car").
-
-                        Note that the values here may take the non-standard syntax of
-                        * instead of the empty string for a missing value, which will
-                        hopefully make the wildcard format more user-friendly.
-                        (On the theory that "Please install */MyDBPool/*/*" should make
-                        more sense than "Please install /MyDBPool//" for an average user)
+                        The Module ID of the prerequisite. This is used to check
+                        whether it's available on the server that you're
+                        downloading the plugin into. It may omit some portions
+                        of the Module ID to be more accomodating (e.g.
+                        "*/MyDBPool/*/*" to identify a database pool instead of
+                        "console/MyDBPool/1.0/car").
+
+                        Note that the values here may take the non-standard
+                        syntax of * instead of the empty string for a missing
+                        value, which will hopefully make the wildcard format
+                        more user-friendly. (On the theory that "Please install
+                        */MyDBPool/*/*" should make more sense than "Please
+                        install /MyDBPool//" for an average user)
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
             <xs:element name="resource-type" type="xs:string" minOccurs="0">
                 <xs:annotation>
                     <xs:documentation>
-                        Describes the type of resource that the prerequisite is. Examples
-                        include:
+                        Describes the type of resource that the prerequisite is.
+                        Examples include:
+
+                        JDBC Driver JDBC Pool JMS Resource Group JavaMail
 
-                        JDBC Driver
-                        JDBC Pool
-                        JMS Resource Group
-                        JavaMail
-
-                        This is mainly used for prerequisites where the user needs to set
-                        something up and you want to indicate what. So for example, you
-                        could say "console/myapp-pool/*/jar" is a prerequisite with resource
-                        type "JDBC Pool" and then the user should understand that they can
-                        install your plugin if they create a JDBC pool called "myapp-pool"
-                        in the console, or manually deploy a pool with moduleId
-                        "console/myapp-pool/(something)/jar"
-
-                        Another option in that case would be to use a dependency on a JDBC
-                        pool plugins you provide, but then it would have to use the
-                        system database (and run a DDL script on the first connect) in order
-                        to be installable in an arbitrary Geronimo server. That would be a
-                        better approach for demonstration applications, whereas the
-                        prerequisite on a user-installed pool would be a better approach for
-                        production applications.
+                        This is mainly used for prerequisites where the user
+                        needs to set something up and you want to indicate what.
+                        So for example, you could say "console/myapp-pool/*/jar"
+                        is a prerequisite with resource type "JDBC Pool" and
+                        then the user should understand that they can install
+                        your plugin if they create a JDBC pool called
+                        "myapp-pool" in the console, or manually deploy a pool
+                        with moduleId "console/myapp-pool/(something)/jar"
+
+                        Another option in that case would be to use a dependency
+                        on a JDBC pool plugins you provide, but then it would
+                        have to use the system database (and run a DDL script on
+                        the first connect) in order to be installable in an
+                        arbitrary Geronimo server. That would be a better
+                        approach for demonstration applications, whereas the
+                        prerequisite on a user-installed pool would be a better
+                        approach for production applications.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
             <xs:element name="description" type="xs:string" minOccurs="0">
                 <xs:annotation>
                     <xs:documentation>
-                        A description for the user about why this is a prerequisite and what
-                        they should do to set it up. Here are a couple examples:
-
-                        This plugin of SomeApp is configured for the Jetty version of
-                        Geronimo. It cannot be installed on the Tomcat version of Geronimo.
-                        There's a separate plugin for the Tomcat version of Geronimo.
-
-                        SomeApp requires a database connection pool. Supported databases
-                        are PostgreSQL and MySQL. Please configure a database connection
-                        pool with the name "SomeAppPool" and then run the associated create
-                        script from http://someapp.com/db-scripts/ before installing this
+                        A description for the user about why this is a
+                        prerequisite and what they should do to set it up. Here
+                        are a couple examples:
+
+                        This plugin of SomeApp is configured for the Jetty
+                        version of Geronimo. It cannot be installed on the
+                        Tomcat version of Geronimo. There's a separate plugin
+                        for the Tomcat version of Geronimo.
+
+                        SomeApp requires a database connection pool. Supported
+                        databases are PostgreSQL and MySQL. Please configure a
+                        database connection pool with the name "SomeAppPool" and
+                        then run the associated create script from
+                        http://someapp.com/db-scripts/ before installing this
                         plugin.
                     </xs:documentation>
                 </xs:annotation>
             </xs:element>
         </xs:sequence>
     </xs:complexType>
+
 </xs:schema>

Modified: geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-1.2.xsd
URL: http://svn.apache.org/viewvc/geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-1.2.xsd?view=diff&rev=511458&r1=511457&r2=511458
==============================================================================
--- geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-1.2.xsd (original)
+++ geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-1.2.xsd Sat Feb 24 22:29:15 2007
@@ -1,15 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-
     Licensed to the Apache Software Foundation (ASF) under one or more
     contributor license agreements.  See the NOTICE file distributed with
     this work for additional information regarding copyright ownership.
     The ASF licenses this file to You under the Apache License, Version 2.0
     (the "License"); you may not use this file except in compliance with
     the License.  You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
+    
+        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.
@@ -17,54 +16,225 @@
     limitations under the License.
 -->
 
-<xs:schema
-    xmlns:tomcat="http://geronimo.apache.org/xml/ns/j2ee/web/tomcat-1.2"
+<xs:schema xmlns:tomcat="http://geronimo.apache.org/xml/ns/j2ee/web/tomcat-1.2"
     targetNamespace="http://geronimo.apache.org/xml/ns/j2ee/web/tomcat-1.2"
     xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.2"
     xmlns:app="http://geronimo.apache.org/xml/ns/j2ee/application-1.2"
     xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.2"
-    xmlns:xs="http://www.w3.org/2001/XMLSchema"
-    elementFormDefault="qualified"
-    attributeFormDefault="unqualified"
-    version="1.1">
-
-    <xs:import namespace="http://geronimo.apache.org/xml/ns/naming-1.2" schemaLocation="geronimo-naming-1.2.xsd"/>
-    <xs:import namespace="http://geronimo.apache.org/xml/ns/j2ee/application-1.2" schemaLocation="geronimo-application-1.2.xsd"/>
-    <xs:import namespace="http://geronimo.apache.org/xml/ns/deployment-1.2" schemaLocation="geronimo-module-1.2.xsd"/>
-
-    <xs:element name="web-app" type="tomcat:web-appType"/>
+    xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
+    attributeFormDefault="unqualified" version="1.1">
 
+    <xs:annotation>
+        <xs:documentation>
+            This is an XML Schema Definition for Geronimo tomcat web application
+            deployment plan. In case the web application deployment plan is
+            provided internally in the web archive, it should be named
+            META-INF/geronimo-web.xml. In case the web application deployment
+            plan is provided externally, the deployment descriptor can be named
+            anything and provided to the deploy tool. Alternatively, it can be
+            included in the EAR and referenced by an alt-dd element of the EAR
+            deployment plan. All the web application deployment plan must
+            specify the top level element as web-app with namespace specified as
+            xmlns="http://geronimo.apache.org/xml/ns/j2ee/tomcat-1.2". The
+            default location for this document is
+            http://geronimo.apache.org/schemas-1.2/geronimo-tomcat-1.2.xsd
+        </xs:documentation>
+    </xs:annotation>
+
+    <xs:import namespace="http://geronimo.apache.org/xml/ns/naming-1.2"
+        schemaLocation="geronimo-naming-1.2.xsd">
+        <xs:annotation>
+            <xs:documentation>
+                Import partial schema containing common naming elements, the
+                imported plan declares elements like ejb-ref, ejb-local-ref,
+                service-ref, resource-ref, and resource-env-ref required by this
+                plan schema.
+            </xs:documentation>
+        </xs:annotation>
+    </xs:import>
+    <xs:import
+        namespace="http://geronimo.apache.org/xml/ns/j2ee/application-1.2"
+        schemaLocation="geronimo-application-1.2.xsd">
+        <xs:annotation>
+            <xs:documentation>
+                Import Geronimo application deployment plans. The imported plan
+                includes abstract complex types security required by this plan
+                schema.
+            </xs:documentation>
+        </xs:annotation>
+    </xs:import>
+    <xs:import namespace="http://geronimo.apache.org/xml/ns/deployment-1.2"
+        schemaLocation="geronimo-module-1.2.xsd">
+        <xs:annotation>
+            <xs:documentation>
+                Import Geronimo Services deployment plans. The imported plan
+                includes complex types like moduleType, environmentType,
+                dependenciesType, etc. required by this plan schema.
+            </xs:documentation>
+        </xs:annotation>
+    </xs:import>
+
+    <xs:element name="web-app" type="tomcat:web-appType">
+        <xs:annotation>
+            <xs:documentation>
+                The web-app element is the root of the deployment descriptor for
+                a Geronimo tomcat web application. Note that the sub-elements of
+                this element should be as in the given order in a sequence.
+            </xs:documentation>
+        </xs:annotation>
+    </xs:element>
 
     <xs:complexType name="web-appType">
         <xs:sequence>
-            <xs:element ref="sys:environment" minOccurs="0"/>
+            <xs:element ref="sys:environment" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        Reference to environment element defined in imported
+                        "geronimo-module-1.2.xsd"
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+
+            <xs:element name="context-root" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        This is the first part of the URL used to access the web
+                        application. For example context-root of "Sample-App"
+                        will have URL of http://host:port/Sample-App" and a
+                        context-root of "/" would make this the default web
+                        application to the server.
+
+                        If the web application is packaged as an EAR that can
+                        use application context in the "application.xml". This
+                        element is necessary unless you want context root to
+                        default to the WAR name.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
 
-            <xs:element name="context-root" type="xs:string" minOccurs="0"/>
             <!--<xs:element name="context-priority-classloader" type="xs:boolean" minOccurs="0"/>-->
 
-            <xs:element ref="naming:web-container" minOccurs="0"/>
-
-            <xs:element name="host" type="xs:string" minOccurs="0"/>
-            <xs:element name="cross-context" type="tomcat:emptyType" minOccurs="0"/>
-            <xs:element name="disable-cookies" type="tomcat:emptyType" minOccurs="0"/>
-            <xs:element name="valve-chain" type="xs:string" minOccurs="0"/>
-            <xs:element name="tomcat-realm" type="xs:string" minOccurs="0"/>
-            <xs:element name="manager" type="xs:string" minOccurs="0"/>
-            <xs:element name="cluster" type="xs:string" minOccurs="0"/>
-
-            <xs:group ref="naming:jndiEnvironmentRefsGroup"/>
-            <xs:element ref="naming:message-destination" minOccurs="0" maxOccurs="unbounded"/>
+            <xs:element ref="naming:web-container" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        Reference to web-container element defined in imported
+                        "geronimo-naming-1.2.xsd"
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+
+            <xs:element name="host" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The host element maps the web application to this
+                        particular host name.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="cross-context" type="tomcat:emptyType"
+                minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The cross-context is an indicative element to specify
+                        that the web application will use dispatch request to
+                        other applications and this cross context should be
+                        enabled.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="disable-cookies" type="tomcat:emptyType"
+                minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The presence of disable-cookies element indicates the
+                        cookies will not be used by tomcat web application and
+                        should be disabled.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="valve-chain" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The valve-chain provides the list of first element
+                        tomcat valves chain for this web application.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="tomcat-realm" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The tomcat-realm provides the tomcat security realm used
+                        by this web application.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="manager" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The manager provides the clustering implementation used
+                        by this web application.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="cluster" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The cluster provides the name of cluster this web
+                        application belongs to.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+
+            <xs:group ref="naming:jndiEnvironmentRefsGroup">
+                <xs:annotation>
+                    <xs:documentation>
+                        Reference to jndiEnvironmentRefsGroup group defined in
+                        imported "geronimo-naming-1.2.xsd"
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:group>
+            <xs:element ref="naming:message-destination" minOccurs="0"
+                maxOccurs="unbounded">
+                <xs:annotation>
+                    <xs:documentation>
+                        Reference to message-destination element defined in
+                        imported "geronimo-naming-1.2.xsd"
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
 
             <xs:sequence minOccurs="0">
-                <xs:element name="security-realm-name" type="xs:string"/>
-                <xs:element ref="app:security" minOccurs="0"/>
+                <xs:element name="security-realm-name" type="xs:string">
+                    <xs:annotation>
+                        <xs:documentation>
+                            The security-realm-name element provides the name of
+                            security realm that will be used by JAAS
+                            authentication. The name should match the your
+                            security realm GBean.
+                        </xs:documentation>
+                    </xs:annotation>
+                </xs:element>
+                <xs:element ref="app:security" minOccurs="0">
+                    <xs:annotation>
+                        <xs:documentation>
+                            Reference to security element defined in imported
+                            "geronimo-security-1.2.xsd"
+                        </xs:documentation>
+                    </xs:annotation>
+                </xs:element>
             </xs:sequence>
 
-            <xs:element ref="sys:service" minOccurs="0" maxOccurs="unbounded"/>
-
+            <xs:element ref="sys:service" minOccurs="0" maxOccurs="unbounded">
+                <xs:annotation>
+                    <xs:documentation>
+                        Reference to security element defined in imported
+                        "geronimo-module-1.2.xsd"
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
         </xs:sequence>
     </xs:complexType>
 
-    <xs:complexType name="emptyType"/>
+    <xs:complexType name="emptyType" />
 
 </xs:schema>

Modified: geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-config-1.0.xsd
URL: http://svn.apache.org/viewvc/geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-config-1.0.xsd?view=diff&rev=511458&r1=511457&r2=511458
==============================================================================
--- geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-config-1.0.xsd (original)
+++ geronimo/server/trunk/modules/geronimo-tomcat6-builder/src/main/schema/geronimo-tomcat-config-1.0.xsd Sat Feb 24 22:29:15 2007
@@ -1,15 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-
     Licensed to the Apache Software Foundation (ASF) under one or more
     contributor license agreements.  See the NOTICE file distributed with
     this work for additional information regarding copyright ownership.
     The ASF licenses this file to You under the Apache License, Version 2.0
     (the "License"); you may not use this file except in compliance with
     the License.  You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
+    
+        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.
@@ -20,25 +19,99 @@
 <xs:schema
     xmlns:tomcat="http://geronimo.apache.org/xml/ns/web/tomcat/config-1.0"
     targetNamespace="http://geronimo.apache.org/xml/ns/web/tomcat/config-1.0"
-    xmlns:xs="http://www.w3.org/2001/XMLSchema"
-    elementFormDefault="qualified"
-    attributeFormDefault="unqualified"
-    version="1.0">
+    xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
+    attributeFormDefault="unqualified" version="1.0">
 
-    <xs:element name="tomcat" type="tomcat:tomcat-configType"/>
+    <xs:annotation>
+        <xs:documentation>
+            This is an XML Schema Definition for Geronimo tomcat specific
+            configuration. It is a used as a sub part of the web application
+            deployment plan. The elements defined in this plan are included in
+            container-config element of web application plan. The top level
+            element included in container-config is tomcat with namespace
+            specified as
+            xmlns="http://geronimo.apache.org/xml/ns/j2ee/tomcat-config-1.0".
+            The default location for this document is
+            http://geronimo.apache.org/schemas-1.2/geronimo-tomcat-config-1.0.xsd
+        </xs:documentation>
+    </xs:annotation>
+    <xs:element name="tomcat" type="tomcat:tomcat-configType">
+        <xs:annotation>
+            <xs:documentation>
+                The tomcat element is the root of the deployment descriptor for
+                a tomcat specific configuration in web application. Note that
+                the sub-elements of this element should be as in the given order
+                in a sequence.
+            </xs:documentation>
+        </xs:annotation>
+    </xs:element>
 
     <xs:complexType name="tomcat-configType">
         <xs:sequence>
-            <xs:element name="host" type="xs:string" minOccurs="0"/>
-            <xs:element name="cross-context" type="tomcat:emptyType" minOccurs="0"/>
-            <xs:element name="disable-cookies" type="tomcat:emptyType" minOccurs="0"/>
-            <xs:element name="valve-chain" type="xs:string" minOccurs="0"/>
-            <xs:element name="tomcat-realm" type="xs:string" minOccurs="0"/>
-            <xs:element name="manager" type="xs:string" minOccurs="0"/>
-            <xs:element name="cluster" type="xs:string" minOccurs="0"/>
+            <xs:element name="host" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The host element maps the web application to this
+                        particular host name.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="cross-context" type="tomcat:emptyType"
+                minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The cross-context is an indicative element to specify
+                        that the web application will use dispatch request to
+                        other applications and this cross context should be
+                        enabled.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="disable-cookies" type="tomcat:emptyType"
+                minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The presence of disable-cookies element indicates the
+                        cookies will not be used by tomcat web application and
+                        should be disabled.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="valve-chain" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The valve-chain provides the list of first element
+                        tomcat valves chain for this web application.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="tomcat-realm" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The tomcat-realm provides the tomcat security realm used
+                        by this web application.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="manager" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The manager provides the clustering implementation used
+                        by this web application.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="cluster" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The cluster provides the name of cluster this web
+                        application belongs to.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
         </xs:sequence>
     </xs:complexType>
 
-    <xs:complexType name="emptyType"/>
+    <xs:complexType name="emptyType" />
 
 </xs:schema>



Mime
View raw message