geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ccard...@apache.org
Subject svn commit: r511458 [2/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-jetty6-builder/src/main/schema/geronimo-jetty-1.2.xsd
URL: http://svn.apache.org/viewvc/geronimo/server/trunk/modules/geronimo-jetty6-builder/src/main/schema/geronimo-jetty-1.2.xsd?view=diff&rev=511458&r1=511457&r2=511458
==============================================================================
--- geronimo/server/trunk/modules/geronimo-jetty6-builder/src/main/schema/geronimo-jetty-1.2.xsd (original)
+++ geronimo/server/trunk/modules/geronimo-jetty6-builder/src/main/schema/geronimo-jetty-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,50 +16,200 @@
     limitations under the License.
 -->
 
-<xs:schema
-    xmlns:web="http://geronimo.apache.org/xml/ns/j2ee/web/jetty-1.2"
+<xs:schema xmlns:web="http://geronimo.apache.org/xml/ns/j2ee/web/jetty-1.2"
     targetNamespace="http://geronimo.apache.org/xml/ns/j2ee/web/jetty-1.2"
     xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.2"
     xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.2"
     xmlns:app="http://geronimo.apache.org/xml/ns/j2ee/application-1.2"
-    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:annotation>
+        <xs:documentation>
+            This is an XML Schema Definition for Geronimo jetty 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/jetty-1.2". The
+            default location for this document is
+            http://geronimo.apache.org/schemas-1.2/geronimo-jetty-1.2.xsd
+        </xs:documentation>
+    </xs:annotation>
+
     <!--xmlns:security="http://geronimo.apache.org/xml/ns/security-1.2"-->
 
-    <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/security-1.2" schemaLocation="geronimo-security-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: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:element name="web-app" type="web:web-appType"/>
+    <!--<xs:import namespace="http://geronimo.apache.org/xml/ns/security-1.2" schemaLocation="geronimo-security-1.2.xsd"/>-->
 
+    <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 and clustering element
+                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="web:web-appType">
+        <xs:annotation>
+            <xs:documentation>
+                The web-app element is the root of the deployment descriptor for
+                a Geronimo jetty 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 name="context-root" type="xs:string" minOccurs="0"/>
-
-            <xs:element ref="app:clustering" minOccurs="0"/>
-
-            <xs:element ref="naming:web-container" minOccurs="0"/>
-
-            <xs:element name="host" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
-            <xs:element name="virtual-host" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
-            <xs:element name="session-manager" type="xs:string" minOccurs="0"/>
-
-            <xs:group ref="naming:jndiEnvironmentRefsGroup"/>
-            <xs:element ref="naming:message-destination" minOccurs="0" maxOccurs="unbounded"/>
+            <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 ref="app:clustering" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        Reference to abstract clustering element defined in
+                        imported "geronimo-application-1.2.xsd"
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+
+            <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"
+                maxOccurs="unbounded">
+                <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="virtual-host" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
+                <xs:annotation>
+                    <xs:documentation>
+                        The virtual-host element maps the web application to
+                        this particular host name.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="session-manager" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The session-manager provides the fully qualified class
+                        name of the clustering implementation
+                        (org.codehaus.wadi.jetty5.JettyManager) used by this web
+                        application.
+                    </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>
 

Modified: geronimo/server/trunk/modules/geronimo-jetty6-builder/src/main/schema/geronimo-jetty-config-1.0.xsd
URL: http://svn.apache.org/viewvc/geronimo/server/trunk/modules/geronimo-jetty6-builder/src/main/schema/geronimo-jetty-config-1.0.xsd?view=diff&rev=511458&r1=511457&r2=511458
==============================================================================
--- geronimo/server/trunk/modules/geronimo-jetty6-builder/src/main/schema/geronimo-jetty-config-1.0.xsd (original)
+++ geronimo/server/trunk/modules/geronimo-jetty6-builder/src/main/schema/geronimo-jetty-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.
@@ -17,21 +16,65 @@
     limitations under the License.
 -->
 
-<xs:schema
-    xmlns:jetty="http://geronimo.apache.org/xml/ns/web/jetty/config-1.0"
+<xs:schema xmlns:jetty="http://geronimo.apache.org/xml/ns/web/jetty/config-1.0"
     targetNamespace="http://geronimo.apache.org/xml/ns/web/jetty/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="jetty" type="jetty:jetty-configType"/>
+    <xs:annotation>
+        <xs:documentation>
+            This is an XML Schema Definition for Geronimo jetty 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 jetty with namespace
+            specified as
+            xmlns="http://geronimo.apache.org/xml/ns/j2ee/jetty-config-1.0". The
+            default location for this document is
+            http://geronimo.apache.org/schemas-1.2/geronimo-jetty-config-1.0.xsd
+        </xs:documentation>
+    </xs:annotation>
+    <xs:element name="jetty" type="jetty:jetty-configType">
+        <xs:annotation>
+            <xs:documentation>
+                The jetty element is the root of the deployment descriptor for a
+                jetty 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="jetty-configType">
         <xs:sequence>
-            <xs:element name="host" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
-            <xs:element name="virtual-host" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
-            <xs:element name="session-manager" type="xs:string" minOccurs="0"/>
+            <xs:element name="host" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
+                <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="virtual-host" type="xs:string" minOccurs="0"
+                maxOccurs="unbounded">
+                <xs:annotation>
+                    <xs:documentation>
+                        The virtual-host element maps the web application to
+                        this particular host name.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
+            <xs:element name="session-manager" type="xs:string" minOccurs="0">
+                <xs:annotation>
+                    <xs:documentation>
+                        The session-manager provides the fully qualified class
+                        name of the clustering implementation
+                        (org.codehaus.wadi.jetty5.JettyManager) used by this web
+                        application.
+                    </xs:documentation>
+                </xs:annotation>
+            </xs:element>
         </xs:sequence>
     </xs:complexType>
 

Modified: geronimo/server/trunk/modules/geronimo-naming-builder/src/main/schema/geronimo-naming-1.2.xsd
URL: http://svn.apache.org/viewvc/geronimo/server/trunk/modules/geronimo-naming-builder/src/main/schema/geronimo-naming-1.2.xsd?view=diff&rev=511458&r1=511457&r2=511458
==============================================================================
--- geronimo/server/trunk/modules/geronimo-naming-builder/src/main/schema/geronimo-naming-1.2.xsd (original)
+++ geronimo/server/trunk/modules/geronimo-naming-builder/src/main/schema/geronimo-naming-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,59 +16,195 @@
     limitations under the License.
 -->
 
-<xsd:schema
-        targetNamespace="http://geronimo.apache.org/xml/ns/naming-1.2"
-        xmlns:gernaming="http://geronimo.apache.org/xml/ns/naming-1.2"
-        xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.2"
-        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-        elementFormDefault="qualified"
-        attributeFormDefault="unqualified"
-        version="1.0">
-
-    <xsd:import namespace="http://geronimo.apache.org/xml/ns/deployment-1.2" schemaLocation="geronimo-module-1.2.xsd"/>
+<xsd:schema targetNamespace="http://geronimo.apache.org/xml/ns/naming-1.2"
+    xmlns:gernaming="http://geronimo.apache.org/xml/ns/naming-1.2"
+    xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.2"
+    xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
+    attributeFormDefault="unqualified" version="1.0">
 
     <xsd:annotation>
         <xsd:documentation>
-            <![CDATA[
-            Partial schema containing common naming elements which can be included in other schemas.
-            ]]>
+            This is a partial XML Schema Definition for common naming elements
+            for resolving EJB, Web, services, or resource references. This
+            schema will never be used directly but its elements are used in
+            geronimo-application-client-1.2.xsd, geronimo-connector-1.2.xsd,
+            geronimo-web-1.2.xsd, geronimo-tomcat-1.2.xsd, and
+            geronimo-jetty-1.2.xsd. 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/naming-1.2". The default
+            location for this document is
+            http://geronimo.apache.org/schemas-1.2/geronimo-naming-1.2.xsd.
         </xsd:documentation>
     </xsd:annotation>
 
+    <xsd:import namespace="http://geronimo.apache.org/xml/ns/deployment-1.2"
+        schemaLocation="geronimo-module-1.2.xsd">
+        <xsd:annotation>
+            <xsd:documentation>
+                Import Geronimo Services deployment plans, the imported plan
+                includes complex types like moduleType, environmentType,
+                dependenciesType, etc. required by this plan schema.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:import>
 
-    <xsd:element name="ejb-ref" type="gernaming:ejb-refType"/>
-    <xsd:element name="ejb-local-ref" type="gernaming:ejb-local-refType"/>
-    <xsd:element name="service-ref" type="gernaming:service-refType"/>
-    <xsd:element name="resource-ref" type="gernaming:resource-refType"/>
-    <xsd:element name="resource-env-ref" type="gernaming:resource-env-refType"/>
+    <xsd:element name="ejb-ref" type="gernaming:ejb-refType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element ejb-ref is used to map EJB references to EJB's in
+                other applications using remote home and remote interface. The
+                application which contains the EJB being referenced should
+                either be in same EAR or should be included in dependency list
+                of this application. Also note as the EJB's referenced are in a
+                different JVM all the Client interfaces should also be included
+                in current application.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
+    <xsd:element name="ejb-local-ref" type="gernaming:ejb-local-refType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element ejb-local-ref is used to map EJB references to EJB's
+                in other applications using local home and local interface. The
+                application which contains the EJB being referenced should
+                either be in same EAR or should be included in dependency list
+                of this application. Also note as the EJB's referenced are in a
+                different JVM all the Client interfaces should also be included
+                in current application.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
+    <xsd:element name="service-ref" type="gernaming:service-refType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element service-ref is used to map service references to
+                service's in other applications. The application which contains
+                the EJB being referenced should either be in same EAR or should
+                be included in dependency list of this application.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
+    <xsd:element name="resource-ref" type="gernaming:resource-refType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element resource-ref is used to map resource references to
+                resources's like JDBC resources, JMS resources, etc. configured
+                outside the current application.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
+    <xsd:element name="resource-env-ref"
+        type="gernaming:resource-env-refType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element resource-env-ref is used to map resource references
+                to administrative objects deployed as a part of connectors.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
-    <xsd:element name="message-destination" type="gernaming:message-destinationType"/>
+    <xsd:element name="message-destination"
+        type="gernaming:message-destinationType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element message-destination is used to configure a JMS queue
+                or topic which act like a destination for the messages
+                delivered.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:group name="jndiEnvironmentRefsGroup">
         <xsd:annotation>
             <xsd:documentation>
-
                 This group keeps the usage of the contained JNDI environment
-                reference elements consistent across J2EE deployment descriptors.
-
+                reference elements consistent across J2EE deployment
+                descriptors.
             </xsd:documentation>
         </xsd:annotation>
         <xsd:sequence>
-            <xsd:element ref="gernaming:abstract-naming-entry" minOccurs="0" maxOccurs="unbounded"/>
-            <xsd:element name="ejb-ref" type="gernaming:ejb-refType" minOccurs="0" maxOccurs="unbounded"/>
-            <xsd:element name="ejb-local-ref" type="gernaming:ejb-local-refType" minOccurs="0" maxOccurs="unbounded"/>
-            <xsd:element name="service-ref" type="gernaming:service-refType" minOccurs="0" maxOccurs="unbounded"/>
-            <xsd:element name="resource-ref" type="gernaming:resource-refType" minOccurs="0" maxOccurs="unbounded"/>
-            <xsd:element name="resource-env-ref" type="gernaming:resource-env-refType" minOccurs="0"
-                         maxOccurs="unbounded"/>
+            <xsd:element ref="gernaming:abstract-naming-entry" minOccurs="0"
+                maxOccurs="unbounded" />
+            <xsd:element name="ejb-ref" type="gernaming:ejb-refType"
+                minOccurs="0" maxOccurs="unbounded">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element ejb-ref is used to map EJB references to
+                        EJB's in other applications using remote home and remote
+                        interface. The application which contains the EJB being
+                        referenced should either be in same EAR or should be
+                        included in dependency list of this application. Also
+                        note as the EJB's referenced are in a different JVM all
+                        the Client interfaces should also be included in current
+                        application.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="ejb-local-ref" type="gernaming:ejb-local-refType"
+                minOccurs="0" maxOccurs="unbounded">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element ejb-local-ref is used to map EJB references
+                        to EJB's in other applications using local home and
+                        local interface. The application which contains the EJB
+                        being referenced should either be in same EAR or should
+                        be included in dependency list of this application. Also
+                        note as the EJB's referenced are in a different JVM all
+                        the Client interfaces should also be included in current
+                        application.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="service-ref" type="gernaming:service-refType"
+                minOccurs="0" maxOccurs="unbounded">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element service-ref is used to map service
+                        references to service's in other applications. The
+                        application which contains the EJB being referenced
+                        should either be in same EAR or should be included in
+                        dependency list of this application.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="resource-ref" type="gernaming:resource-refType"
+                minOccurs="0" maxOccurs="unbounded">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element resource-ref is used to map resource
+                        references to resources's like JDBC resources, JMS
+                        resources, etc. configured outside the current
+                        application.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="resource-env-ref"
+                type="gernaming:resource-env-refType" minOccurs="0"
+                maxOccurs="unbounded">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element resource-env-ref is used to map resource
+                        references to administrative objects deployed as a part
+                        of connectors.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
         </xsd:sequence>
     </xsd:group>
 
-    <xsd:element name="abstract-naming-entry" abstract="true" type="gernaming:abstract-naming-entryType"/>
+    <xsd:element name="abstract-naming-entry" abstract="true"
+        type="gernaming:abstract-naming-entryType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element abstract-naming-entry is an abstract element used as
+                a generic element for all the references.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:complexType name="abstract-naming-entryType" abstract="true">
-        <xsd:sequence>
-        </xsd:sequence>
+        <xsd:sequence></xsd:sequence>
     </xsd:complexType>
 
     <!--ejb-link acts like ejb-link in spec descriptors-->
@@ -78,89 +213,360 @@
     <!--url in resource-ref contains the url for URL typed resource refs-->
     <!--Possibly the external-uri element should be revived to connect to other naming systems-->
     <!--when server to server communication exists we will need an element in ejb-ref to specify the geronimo server
-    we wish to talk to.  It might be possible to use the objectName server element for this depending on what we decide it means-->
+        we wish to talk to.  It might be possible to use the objectName server element for this depending on what we decide it means-->
     <!--otherwise you can supply the entire object name using the gbean-nameGroup-->
 
     <xsd:complexType name="ejb-refType">
         <xsd:sequence>
-            <xsd:element name="ref-name" type="xsd:string"/>
+            <xsd:element name="ref-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element ref-name is used to identify this remote ejb
+                        reference. This name should be unique in a module and
+                        will be used by application as a part of JNDI name for
+                        the referenced ejb. The JNDI name used will be
+                        "java:/comp/env/ref-name. It should map to the
+                        "ejb-ref-name" provided in deployment descriptor.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:choice>
-                <xsd:element name="pattern" type="gernaming:patternType"/>
-                <xsd:group ref="gernaming:corbaNameGroup"/>
-                <xsd:element name="ejb-link" type="xsd:string"/>
+                <xsd:element name="pattern" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element pattern is used to provide additional
+                            selection criterion for remote ejbs if multiple ejbs
+                            with same ejb-link exists in EAR or dependency
+                            modules. The pattern mapped should result in single
+                            remote EJB.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:group ref="gernaming:corbaNameGroup">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            Reference to corbaNameGroup defined later in this
+                            schema. This group defines the EJB using CORBA as
+                            communication protocol.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:group>
+                <xsd:element name="ejb-link" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element ejb-link is used to identify the remote
+                            ejb specified in same EAR or dependency modules.
+                            This name should match the ejb-name defined in EJB
+                            deployment descriptor. If the name is not unique the
+                            pattern element will be used to uniquely identify
+                            this remote ejb.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
             </xsd:choice>
         </xsd:sequence>
     </xsd:complexType>
 
     <xsd:complexType name="ejb-local-refType">
         <xsd:sequence>
-            <xsd:element name="ref-name" type="xsd:string"/>
+            <xsd:element name="ref-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element ref-name is used to identify this local ejb
+                        reference. This name should be unique in a module and
+                        will be used by application to as a part of JNDI name
+                        for the referenced ejb. The JNDI name used will be
+                        "java:/comp/env/ref-name. It should map to the
+                        "ejb-ref-name" provided in deployment descriptor.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:choice>
-                <xsd:element name="pattern" type="gernaming:patternType"/>
-                <xsd:element name="ejb-link" type="xsd:string"/>
+                <xsd:element name="pattern" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element pattern is used to provide additional
+                            selection criterion for local ejb's if multiple
+                            local ejb's with same ejb-link exists in EAR or
+                            dependency modules. The pattern mapped should result
+                            in single local EJB.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="ejb-link" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element ejb-link is used to identify the local
+                            ejb specified in same EAR or dependency modules.
+                            This name should match the ejb-name defined in EJB
+                            deployment descriptor. If the name is not unique the
+                            pattern element will be used to uniquely identify
+                            this local ejb.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
             </xsd:choice>
         </xsd:sequence>
     </xsd:complexType>
 
     <xsd:complexType name="resource-refType">
         <xsd:sequence>
-            <xsd:element name="ref-name" type="xsd:string"/>
+            <xsd:element name="ref-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element ref-name is used to identify this resource
+                        reference. This name should be unique in a module and
+                        will be used by application to as a part of JNDI name
+                        for the referenced resource. The JNDI name used will be
+                        "java:/comp/env/ref-name. It should map to the
+                        "resource-ref-name" provided in deployment descriptor.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:choice>
-                <xsd:element name="pattern" type="gernaming:patternType"/>
-                <xsd:element name="resource-link" type="xsd:string"/>
-                <xsd:element name="url" type="xsd:string"/>
+                <xsd:element name="pattern" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element pattern is used to provide additional
+                            selection criterion for resources if multiple
+                            resources with same resource-link or URI exists
+                            dependency modules. The pattern mapped should result
+                            in single resource.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="resource-link" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element resource-link is used to identify the
+                            JDBC, JMS, or JavaMail resource specified in all the
+                            dependency modules. This name should match the
+                            connectiondefination-instance/name defined in
+                            resource adapter deployment descriptor. If the name
+                            is not unique the pattern element will be used to
+                            uniquely identify this resource.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="url" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element url is used to identify the resources of
+                            type java.net.URL deployed in all the dependency
+                            modules. If the url doesn't map to unique resource
+                            the pattern element will be used to uniquely
+                            identify this resource.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
             </xsd:choice>
         </xsd:sequence>
     </xsd:complexType>
 
-    <xsd:element name="gbean-ref" type="gernaming:gbean-refType" substitutionGroup="gernaming:abstract-naming-entry"/>
+    <xsd:element name="gbean-ref" type="gernaming:gbean-refType"
+        substitutionGroup="gernaming:abstract-naming-entry">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element gbean-ref is used to map gbean references to gbeans
+                configured outside the current module.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:complexType name="gbean-refType">
         <xsd:complexContent>
             <xsd:extension base="gernaming:abstract-naming-entryType">
                 <xsd:sequence>
-                    <xsd:element name="ref-name" type="xsd:string"/>
-                    <xsd:element name="ref-type" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
+                    <xsd:element name="ref-name" type="xsd:string">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element ref-name is used to identify this
+                                gbean reference. This name should be unique in a
+                                module and will be used by application to as a
+                                part of JNDI name for the referenced gbean. The
+                                JNDI name used will be "java:/comp/env/ref-name.
+                                It should map to the "ref-name" provided in
+                                deployment descriptor.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
+                    <xsd:element name="ref-type" type="xsd:string" minOccurs="0"
+                        maxOccurs="unbounded">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element ref-type is used to specify the
+                                interface implemented by GBean being referenced.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
                     <xsd:choice minOccurs="0" maxOccurs="unbounded">
-                        <xsd:element name="pattern" type="gernaming:patternType"/>
+                        <xsd:element name="pattern"
+                            type="gernaming:patternType">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The element pattern is used to provide
+                                    additional selection criterion for gbeans if
+                                    multiple gbeans with same name exists in
+                                    dependency modules. The pattern mapped
+                                    should result in single gbean.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
                     </xsd:choice>
                 </xsd:sequence>
             </xsd:extension>
         </xsd:complexContent>
     </xsd:complexType>
 
-    <xsd:element name="persistence-unit-ref" type="gernaming:persistence-unit-refType"
-                 substitutionGroup="gernaming:abstract-naming-entry"/>
+    <xsd:element name="persistence-unit-ref"
+        type="gernaming:persistence-unit-refType"
+        substitutionGroup="gernaming:abstract-naming-entry">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element persistence-unit-ref is used to map persistence unit
+                references to persistence units configured outside the current
+                module.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:complexType name="persistence-unit-refType">
         <xsd:complexContent>
             <xsd:extension base="gernaming:abstract-naming-entryType">
                 <xsd:sequence>
-                    <xsd:element name="persistence-unit-ref-name" type="xsd:string"/>
+                    <xsd:element name="persistence-unit-ref-name"
+                        type="xsd:string">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element persistence-unit-ref-name is used to
+                                identify this persistence unit reference. This
+                                name should be unique in a module and will be
+                                used by application as a part of JNDI name for
+                                the referenced persistence unit. The JNDI name
+                                used will be "java:/comp/env/ref-name. It should
+                                map to the "ref-name" provided in deployment
+                                descriptor.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
                     <xsd:choice>
-                        <xsd:element name="persistence-unit-name" type="xsd:string"/>
-                        <xsd:element name="pattern" type="gernaming:patternType"/>
+                        <xsd:element name="persistence-unit-name"
+                            type="xsd:string">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The element persistence-unit-name is used to
+                                    identify persistence unit specified in any
+                                    of the dependency modules. This name should
+                                    match the persistence-unit-name defined in
+                                    deployment descriptor. If the name is not
+                                    unique the pattern element will be used to
+                                    uniquely identify this persistence unit.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                        <xsd:element name="pattern"
+                            type="gernaming:patternType">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The element pattern is used to provide
+                                    additional selection criterion for
+                                    persistence units if multiple persistence
+                                    units with same persistence-unit-name exists
+                                    in dependency modules. The pattern mapped
+                                    should result in single persistence unit.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
                     </xsd:choice>
                 </xsd:sequence>
             </xsd:extension>
         </xsd:complexContent>
     </xsd:complexType>
 
-    <xsd:element name="persistence-context-ref" type="gernaming:persistence-context-refType"
-                 substitutionGroup="gernaming:abstract-naming-entry"/>
+    <xsd:element name="persistence-context-ref"
+        type="gernaming:persistence-context-refType"
+        substitutionGroup="gernaming:abstract-naming-entry">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element entity-manager-factory-ref is used to map
+                persistence context references to persistence contexts
+                configured outside the current module.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:complexType name="persistence-context-refType">
         <xsd:complexContent>
             <xsd:extension base="gernaming:abstract-naming-entryType">
                 <xsd:sequence>
-                    <xsd:element name="persistence-context-ref-name" type="xsd:string"/>
+                    <xsd:element name="persistence-context-ref-name"
+                        type="xsd:string">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element ref-name is used to identify this
+                                persistence context reference. This name should
+                                be unique in a module and will be used by
+                                application as a part of JNDI name for the
+                                referenced persistence context. The JNDI name
+                                used will be "java:/comp/env/ref-name. It should
+                                map to the "ref-name" provided in deployment
+                                descriptor.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
                     <xsd:choice>
-                        <xsd:element name="persistence-unit-name" type="xsd:string"/>
-                        <xsd:element name="pattern" type="gernaming:patternType"/>
+                        <xsd:element name="persistence-unit-name"
+                            type="xsd:string">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The element persistence-unit-name is used to
+                                    identify persistence context specified in
+                                    any of the dependency modules. This name
+                                    should match the persistence-unit-name
+                                    defined in deployment descriptor. If the
+                                    name is not unique the pattern element will
+                                    be used to uniquely identify this
+                                    persistence unit.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
+                        <xsd:element name="pattern"
+                            type="gernaming:patternType">
+                            <xsd:annotation>
+                                <xsd:documentation>
+                                    The element pattern is used to provide
+                                    additional selection criterion for
+                                    persistence context's if multiple
+                                    persistence context's with same
+                                    persistence-unit-name exists in dependency
+                                    modules. The pattern mapped should result in
+                                    single persistence context.
+                                </xsd:documentation>
+                            </xsd:annotation>
+                        </xsd:element>
                     </xsd:choice>
-                    <xsd:element name="persistence-context-type" type="gernaming:persistence-context-typeType"
-                                 minOccurs="0"/>
-                    <xsd:element name="property" type="gernaming:propertyType" minOccurs="0" maxOccurs="unbounded"/>
+                    <xsd:element name="persistence-context-type"
+                        type="gernaming:persistence-context-typeType"
+                        minOccurs="0">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element persistence-context-type is used to
+                                provide transaction features if persistence
+                                context reference. It can have value of
+                                transaction-scoped or extended.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
+                    <xsd:element name="property" type="gernaming:propertyType"
+                        minOccurs="0" maxOccurs="unbounded">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element property is used to provide vendor
+                                specific properties for persistence context
+                                reference.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
                 </xsd:sequence>
             </xsd:extension>
         </xsd:complexContent>
@@ -168,50 +574,150 @@
 
     <xsd:simpleType name="persistence-context-typeType">
         <xsd:restriction base="xsd:string">
-            <xsd:enumeration value="Transactional"/>
-            <xsd:enumeration value="Extended"/>
+            <xsd:enumeration value="Transactional" />
+            <xsd:enumeration value="Extended" />
         </xsd:restriction>
     </xsd:simpleType>
 
     <xsd:complexType name="propertyType">
         <xsd:sequence>
-            <xsd:element name="key" type="xsd:string"/>
-            <xsd:element name="value" type="xsd:string"/>
+            <xsd:element name="key" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element key provides the key identifying this
+                        property.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="value" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element value provides the value for this property.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
         </xsd:sequence>
     </xsd:complexType>
 
-    <!--used by openejb cmp datasource specification -->
-    <xsd:element name="cmp-connection-factory" type="gernaming:resource-locatorType"/>
+    <!-- used by openejb cmp datasource specification -->
+    <xsd:element name="cmp-connection-factory"
+        type="gernaming:resource-locatorType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element cmp-connection-factory defines the connection pool
+                which will be used by CMP entity beans to connect to datasource.
+                This element will be used by openejb specifications.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
-    <!--used by openejb mdb resource adapter specification -->
-    <xsd:element name="resource-adapter" type="gernaming:resource-locatorType"/>
+    <!-- used by openejb mdb resource adapter specification -->
+    <xsd:element name="resource-adapter"
+        type="gernaming:resource-locatorType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element resource-adapter defines the JMS destination which
+                will be used by MDB to connect to destination. This element will
+                be used by openejb specifications.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:complexType name="resource-locatorType">
         <xsd:sequence>
             <xsd:choice>
-                <xsd:element name="pattern" type="gernaming:patternType"/>
-                <xsd:element name="resource-link" type="xsd:string"/>
-                <xsd:element name="url" type="xsd:string"/>
+                <xsd:element name="pattern" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element pattern is used to provide additional
+                            selection criterion for resources if multiple
+                            resources with same resource-name exists in
+                            dependency modules. The pattern mapped should result
+                            in single resource.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="resource-link" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element resource-link is used to identify the
+                            JDBC, JMS, or JavaMail resource specified in all the
+                            dependency modules. This name should match the
+                            connectiondefination-instance/name defined in
+                            resource adapter deployment descriptor. If the name
+                            is not unique the pattern element will be used to
+                            uniquely identify this resource.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="url" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element url is used to identify the resources of
+                            type java.net.URL deployed in all the dependency
+                            modules. If the url doesn't map to unique resource
+                            the pattern element will be used to uniquely
+                            identify this resource.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
             </xsd:choice>
         </xsd:sequence>
     </xsd:complexType>
 
     <xsd:complexType name="resource-env-refType">
         <xsd:sequence>
-            <xsd:element name="ref-name" type="xsd:string"/>
+            <xsd:element name="ref-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element ref-name is used to identify this resource
+                        reference. This name should be unique in a module and
+                        will be used by application as a part of JNDI name for
+                        the referenced resource. The JNDI name used will be
+                        "java:/comp/env/ref-name. It should map to the
+                        "res-ref-name" provided in deployment descriptor.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:choice>
-                <xsd:element name="pattern" type="gernaming:patternType"/>
-                <xsd:element name="message-destination-link" type="xsd:string">
+                <xsd:element name="pattern" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element pattern is used to provide additional
+                            selection criterion for admin object's if multiple
+                            admin object's with same admin-object-link exists in
+                            dependency modules. The pattern mapped should result
+                            in single admin object.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="message-destination-link"
+                    type="xsd:string">
                     <xsd:annotation>
                         <xsd:documentation>
-                            This element is deprecated and should not be used. Use admin-object-link instead.
-                            That is effectively a renamed version of this.
+                            This element is deprecated and should not be used.
+                            Use admin-object-link instead. That is effectively a
+                            renamed version of this.
                         </xsd:documentation>
                     </xsd:annotation>
                 </xsd:element>
                 <xsd:sequence>
-                    <xsd:element name="admin-object-module" type="xsd:string" minOccurs="0"/>
-                    <xsd:element name="admin-object-link" type="xsd:string"/>
+                    <xsd:element name="admin-object-module" type="xsd:string"
+                        minOccurs="0" />
+                    <xsd:element name="admin-object-link" type="xsd:string">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element admin-object-link is used to
+                                identify the admin object resource specified in
+                                any of the dependency modules. This name should
+                                match the message-definition-name defined in
+                                admin object section of deployment descriptor.
+                                If the name is not unique the pattern element
+                                will be used to uniquely identify this admin
+                                object resource.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
                 </xsd:sequence>
             </xsd:choice>
         </xsd:sequence>
@@ -219,83 +725,303 @@
 
     <xsd:complexType name="message-destinationType">
         <xsd:sequence>
-            <xsd:element name="message-destination-name" type="xsd:string"/>
+            <xsd:element name="message-destination-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element message-destination-name is used to identify
+                        this message destination reference. This name should be
+                        unique in a module and will be used by application to as
+                        a part of JNDI name for the message destination. The
+                        JNDI name used will be "java:/comp/env/ref-name. It
+                        should map to the "message-destination-name" provided in
+                        deployment descriptor.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:choice>
-                <xsd:element name="pattern" type="gernaming:patternType"/>
+                <xsd:element name="pattern" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element pattern is used to provide additional
+                            selection criterion for JMS destination's if
+                            multiple destination's with same admin-object-link
+                            exists in dependency modules. The pattern mapped
+                            should result in single destination.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
                 <xsd:sequence>
-                    <xsd:element name="admin-object-module" type="xsd:string" minOccurs="0"/>
-                    <xsd:element name="admin-object-link" type="xsd:string"/>
+                    <xsd:element name="admin-object-module" type="xsd:string"
+                        minOccurs="0" />
+                    <xsd:element name="admin-object-link" type="xsd:string">
+                        <xsd:annotation>
+                            <xsd:documentation>
+                                The element admin-object-link is used to
+                                identify the admin object resource specified in
+                                any of the dependency modules. This name should
+                                match the message-definition-name defined in
+                                admin object section of deployment descriptor.
+                                If the name is not unique the pattern element
+                                will be used to uniquely identify this admin
+                                object resource.
+                            </xsd:documentation>
+                        </xsd:annotation>
+                    </xsd:element>
                 </xsd:sequence>
             </xsd:choice>
         </xsd:sequence>
     </xsd:complexType>
 
-    <!--used by resource adapter -->
-    <xsd:element name="workmanager" type="gernaming:gbean-locatorType"/>
+    <!-- used by resource adapter -->
+    <xsd:element name="workmanager" type="gernaming:gbean-locatorType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element workmanager defines the work manager implementation
+                used by resource adapter. This element will be used by resource
+                adapter plan.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
-    <!-- used by web apps/builders-->
-    <xsd:element name="web-container" type="gernaming:gbean-locatorType"/>
+    <!-- used by web apps/builders -->
+    <xsd:element name="web-container" type="gernaming:gbean-locatorType">
+        <xsd:annotation>
+            <xsd:documentation>
+                The element web-container defines the binding between web
+                application and web container instance. It specifies which
+                container application should be deployed to.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
 
     <xsd:complexType name="gbean-locatorType">
         <xsd:sequence>
             <xsd:choice>
-                <xsd:element name="pattern" type="gernaming:patternType"/>
-                <xsd:element name="gbean-link" type="xsd:string"/>
+                <xsd:element name="pattern" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element pattern is used to provide additional
+                            selection criterion for gbean's if multiple gbean's
+                            with same name exists in dependency modules. The
+                            pattern mapped should result in single gbean.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="gbean-link" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element gbean-link is used to identify the gbean
+                            deployed in any of the dependency modules. This name
+                            should match the gbean-name defined in deployment
+                            plane. If the name is not unique the pattern element
+                            will be used to uniquely identify this gbean.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
             </xsd:choice>
         </xsd:sequence>
     </xsd:complexType>
 
     <xsd:complexType name="patternType">
         <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="module" type="xsd:string" minOccurs="0"/>
-            <xsd:element name="name" type="xsd:string"/>
+            <xsd:element name="groupId" type="xsd:string" minOccurs="0">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The name for group containing module to match. By
+                        default is it considered 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.
+                    </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 latest available version matching other
+                        criterions.
+                    </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:group name="serverGroup">
         <xsd:annotation>
-            <xsd:documentation>This group contains the protocol, address, and port for a server</xsd:documentation>
+            <xsd:documentation>
+                This group contains the protocol, address, and port for a server
+            </xsd:documentation>
         </xsd:annotation>
         <xsd:sequence>
-            <xsd:element name="protocol" type="xsd:string"/>
-            <xsd:element name="host" type="xsd:string"/>
-            <xsd:element name="port" type="xsd:int"/>
+            <xsd:element name="protocol" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The protocol element is used to specify the network
+                        protocol used for connection. This could be http or
+                        https.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="host" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The host element is used to specify the network host to
+                        connect.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="port" type="xsd:int">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The port element is used to specify the network port to
+                        connect.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
         </xsd:sequence>
     </xsd:group>
 
     <xsd:complexType name="portType">
         <xsd:sequence>
-            <xsd:element name="port-name" type="xsd:string"/>
-            <xsd:group ref="gernaming:serverGroup" minOccurs="0"/>
-            <xsd:element name="uri" type="xsd:string"/>
-            <xsd:element name="credentials-name" type="xsd:string" minOccurs="0"/>
+            <xsd:element name="port-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The port-name element provides the name to identify the
+                        port to connect.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:group ref="gernaming:serverGroup" minOccurs="0">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        Reference to serverGroup defined later in this schema.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:group>
+            <xsd:element name="uri" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The uri element provides the path to particular resource
+                        once connection is established.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="credentials-name" type="xsd:string"
+                minOccurs="0">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The credentials-name element provides the credentials
+                        name to identify the credentials used for secure
+                        connections.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
         </xsd:sequence>
     </xsd:complexType>
 
     <xsd:complexType name="service-refType">
         <xsd:sequence>
-            <xsd:element name="service-ref-name" type="xsd:string"/>
+            <xsd:element name="service-ref-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element service-ref-name is used to identify this
+                        service reference. This name should be unique in a
+                        module and will be used by application to as a part of
+                        JNDI name for the web service. The JNDI name used will
+                        be "java:/comp/env/ref-name. It should map to the
+                        "service-ref-name" provided in service-ref of deployment
+                        descriptor.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:choice>
-                <xsd:element name="service-completion" type="gernaming:service-completionType"/>
-                <xsd:element name="port" type="gernaming:portType" maxOccurs="unbounded"/>
+                <xsd:element name="service-completion"
+                    type="gernaming:service-completionType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element service-completion is used to provide
+                            missing information for web service. If this element
+                            doesn't exist all the information should be
+                            available in WSDL.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="port" type="gernaming:portType"
+                    maxOccurs="unbounded">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element port defines the ports available though
+                            service reference. If this element doesn't exist the
+                            port information should be available in WSDL.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
             </xsd:choice>
         </xsd:sequence>
     </xsd:complexType>
 
     <xsd:complexType name="service-completionType">
         <xsd:sequence>
-            <xsd:element name="service-name" type="xsd:string"/>
-            <xsd:element name="port-completion" type="gernaming:port-completionType" maxOccurs="unbounded"/>
+            <xsd:element name="service-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element service-name provides the name of the
+                        service missing in service block of WSDL.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="port-completion"
+                type="gernaming:port-completionType" maxOccurs="unbounded">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element port-completion provides the port
+                        information missing in WSDL.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
         </xsd:sequence>
     </xsd:complexType>
 
     <xsd:complexType name="port-completionType">
         <xsd:sequence>
-            <xsd:element name="port" type="gernaming:portType"/>
-            <xsd:element name="binding-name" type="xsd:string"/>
+            <xsd:element name="port" type="gernaming:portType">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element port provides the port used for web services
+                        connection.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="binding-name" type="xsd:string">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The element binding-name is used to provide the name for
+                        binding for a port and URL.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
         </xsd:sequence>
     </xsd:complexType>
 
@@ -322,10 +1048,24 @@
                 </xsd:annotation>
             </xsd:element>
             <xsd:choice>
-                <xsd:element name="css" type="gernaming:patternType"/>
-                <xsd:element name="css-link" type="xsd:string"/>
+                <xsd:element name="css" type="gernaming:patternType">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The element css provides the gbean name to identify
+                            the client security service used.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
+                <xsd:element name="css-link" type="xsd:string">
+                    <xsd:annotation>
+                        <xsd:documentation>
+                            The css-link identify the client security service by
+                            its name.
+                        </xsd:documentation>
+                    </xsd:annotation>
+                </xsd:element>
             </xsd:choice>
         </xsd:sequence>
     </xsd:group>
 
-</xsd:schema>
\ No newline at end of file
+</xsd:schema>



Mime
View raw message