[jboss-cvs] JBossAS SVN: r108084 - projects/jboss-jca/trunk/common/src/main/resources/schema.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Thu Sep 9 12:03:14 EDT 2010


Author: jesper.pedersen
Date: 2010-09-09 12:03:13 -0400 (Thu, 09 Sep 2010)
New Revision: 108084

Modified:
   projects/jboss-jca/trunk/common/src/main/resources/schema/ironjacamar_1_0.xsd
   projects/jboss-jca/trunk/common/src/main/resources/schema/resource-adapters_1_0.xsd
Log:
Documentation updates

Modified: projects/jboss-jca/trunk/common/src/main/resources/schema/ironjacamar_1_0.xsd
===================================================================
--- projects/jboss-jca/trunk/common/src/main/resources/schema/ironjacamar_1_0.xsd	2010-09-09 15:33:20 UTC (rev 108083)
+++ projects/jboss-jca/trunk/common/src/main/resources/schema/ironjacamar_1_0.xsd	2010-09-09 16:03:13 UTC (rev 108084)
@@ -1,35 +1,98 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
+
   <xs:complexType name="boolean-presenceType"></xs:complexType>
+
   <xs:complexType name="config-propertyType" mixed="true">
+    <xs:annotation>
+      <xs:documentation>
+        <![CDATA[[
+          Specifies an override for a config-property element in ra.xml or a @ConfigProperty
+         ]]>
+      </xs:documentation>
+    </xs:annotation>
     <xs:simpleContent>
       <xs:extension base="xs:token">
-        <xs:attribute use="required" name="name" type="xs:token"></xs:attribute>
+        <xs:attribute use="required" name="name" type="xs:token">
+          <xs:annotation>
+            <xs:documentation>
+              <![CDATA[[
+                Specifies the name of the config-property
+               ]]>
+            </xs:documentation>
+          </xs:annotation>
+        </xs:attribute>
       </xs:extension>
     </xs:simpleContent>
   </xs:complexType>
+
   <xs:complexType name="ironjacamarType">
     <xs:sequence>
+      <xs:element name="bean-validation-groups" type="bean-validation-groupsType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies bean validation group that should be used
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="bootstrap-context" type="xs:token" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the unique name of the bootstrap context that should be used
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
       <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-               The config-property specifies a mannaged connection factory property.
-              ]]>
+               The config-property specifies resource adapter configuration properties.
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
-      <xs:element name="bean-validation-groups" type="bean-validation-groupsType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="bootstrap-context" type="xs:token" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="transaction-support" type="transaction-supportType" minOccurs="0"></xs:element>
-      <xs:element name="connection-definitions" type="connection-definitionsType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="admin-objects" type="admin-objectsType" minOccurs="0" maxOccurs="1"></xs:element>
+      <xs:element name="transaction-support" type="transaction-supportType" minOccurs="0">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the transaction support level of the resource adapter
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="connection-definitions" type="connection-definitionsType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the connection definitions
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="admin-objects" type="admin-objectsType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the administration objects
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:simpleType name="transaction-supportType">
     <xs:annotation>
-      <xs:documentation> Define the typoe of transaction supported by this respurce adapter. It overrides/selects
-        connection manager one valid value are: NoTransaction, LocalTransaction, XA</xs:documentation>
+      <xs:documentation>
+        <![CDATA[[
+          Define the type of transaction supported by this resource adapter.
+          Valid values are: NoTransaction, LocalTransaction, XATransaction
+         ]]>
+      </xs:documentation>
     </xs:annotation>
     <xs:restriction base="xs:token">
       <xs:enumeration value="NoTransaction" />
@@ -37,29 +100,71 @@
       <xs:enumeration value="XATransaction" />
     </xs:restriction>
   </xs:simpleType>
+
   <xs:attributeGroup name="common-attribute">
-    <xs:attribute name="class-name" type="xs:token" use="optional"></xs:attribute>
-    <xs:attribute name="jndi-name" type="xs:token" use="required" />
-    <xs:attribute name="enabled" type="xs:boolean" default="true" form="unqualified" use="optional" />
+    <xs:attribute name="class-name" type="xs:token" use="optional">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Specifies the the fully qualified class name of a managed connection factory
+            or admin object
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
+    <xs:attribute name="jndi-name" type="xs:token" use="required">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Specifies the JNDI name
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
+    <xs:attribute name="enabled" type="xs:boolean" default="true" form="unqualified" use="optional">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Should the object in question be activated
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
     <xs:attribute default="false" name="use-java-context" type="xs:boolean">
       <xs:annotation>
         <xs:documentation>
           <![CDATA[[
-              Setting this to false will bind the DataSource into global jndi
-              Ex:
-              <use-java-context>false</use-java-context>
+            Specifies if a global JNDI context should be used 
            ]]>
         </xs:documentation>
       </xs:annotation>
     </xs:attribute>
-    <xs:attribute name="pool-name" type="xs:token" use="optional"></xs:attribute>
+    <xs:attribute name="pool-name" type="xs:token" use="optional">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Specifies the pool name for the object
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
   </xs:attributeGroup>
+
   <xs:complexType name="admin-objectType">
     <xs:sequence>
-      <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded"></xs:element>
+      <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              The config-property specifies administration object configuration properties.
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
     <xs:attributeGroup ref="common-attribute"></xs:attributeGroup>
   </xs:complexType>
+
   <xs:complexType name="time-outType">
     <xs:sequence>
       <xs:element name="blocking-timeout-millis" type="xs:nonNegativeInteger" minOccurs="0">
@@ -103,25 +208,25 @@
           <xs:documentation>
             <![CDATA[[
               The allocation retry wait millis element indicates the time in milliseconds 
-              to wait between retrying to allocate a connection. The default is 5000 (5 
-              seconds). 
+              to wait between retrying to allocate a connection. The default is 5000 (5 seconds). 
               ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
       <xs:element name="xa-resource-timeout" type="xs:nonNegativeInteger" minOccurs="0" maxOccurs="1">
         <xs:annotation>
-          <xs:documentation><![CDATA[[
-               EXPRESSED IN SECONDS
-               Passed to XAResource.setTransactionTimeout()
-               Default is zero which does not invoke the setter
-               e.g. 5 minutes
-               <xa-resource-timeout>300</xa-resource-timeout>]]>
+          <xs:documentation>
+            <![CDATA[[
+              Passed to XAResource.setTransactionTimeout(). Default is zero which does not invoke the setter.              
+              Specified in seconds - e.g. 5 minutes
+              <xa-resource-timeout>300</xa-resource-timeout>
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="validationType">
     <xs:sequence>
       <xs:element name="background-validation" type="xs:boolean" minOccurs="0">
@@ -130,7 +235,7 @@
             <![CDATA[[
               An element to specify that connections should be validated on a background 
               thread versus being validated prior to use 
-              ]]>
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
@@ -138,9 +243,9 @@
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-               The background-validation-minutes element specifies the amount of 
-               time, in minutes, that background validation will run. 
-              ]]>
+              The background-validation-minutes element specifies the amount of 
+              time, in minutes, that background validation will run. 
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
@@ -148,40 +253,91 @@
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-                Whether fail a connection allocation on the first connection if it 
-                is invalid (true) or keep trying until the pool is exhausted of all potential 
-                connections (false) default false. e.g. <use-fast-fail>true</use-fast-fail>
-              ]]>
+              Whether fail a connection allocation on the first connection if it 
+              is invalid (true) or keep trying until the pool is exhausted of all potential 
+              connections (false). Default is false. e.g. <use-fast-fail>true</use-fast-fail>
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="connection-definitionsType">
     <xs:sequence>
-      <xs:element name="connection-definition" type="connection-defintionType" minOccurs="1" maxOccurs="unbounded"></xs:element>
+      <xs:element name="connection-definition" type="connection-defintionType" minOccurs="1" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies a connection definition
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="connection-defintionType">
     <xs:sequence>
-      <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded"></xs:element>
+      <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+               The config-property specifies managed connection factory configuration properties.
+              ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
       <xs:element name="no-tx-separate-pools" type="boolean-presenceType" minOccurs="0" maxOccurs="1">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
               Whether to use separete pools for connection retrieved in a transaction 
-               and those retieved outside a transaction e.g. <no-tx-separate-pools/>  
-              ]]>
+              and those retieved outside a transaction e.g. <no-tx-separate-pools/>  
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
-      <xs:element name="pool" type="poolType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="security" type="securityType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="timeout" type="time-outType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="vaidation" type="validationType" minOccurs="0" maxOccurs="1"></xs:element>
+      <xs:element name="pool" type="poolType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies pooling settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="security" type="securityType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies security settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="timeout" type="time-outType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies timeout settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="vaidation" type="validationType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies validation settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
     <xs:attributeGroup ref="common-attribute"></xs:attributeGroup>
   </xs:complexType>
+
   <xs:complexType name="poolType">
     <xs:sequence>
       <xs:element name="min-pool-size" type="xs:nonNegativeInteger" minOccurs="0">
@@ -200,7 +356,7 @@
           <xs:documentation>
             <![CDATA[[
               The max-pool-size element indicates the maximum number of connections 
-              for a pool. No more than MaxSize connections will be created in each sub-pool. 
+              for a pool. No more than max-pool-size connections will be created in each sub-pool. 
               This defaults to 20. 
              ]]>
           </xs:documentation>
@@ -210,9 +366,8 @@
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-              Whether to attempt to prefill the connection pool. Empty element denotes 
-              a true value. e.g. <prefill>true</prefill>.
-              Default is true
+              Whether to attempt to prefill the connection pool. 
+              Default is true. e.g. <prefill>true</prefill>.
              ]]>
           </xs:documentation>
         </xs:annotation>
@@ -221,7 +376,7 @@
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-              Define if the min-pool-size should be considered a strictly.
+              Specifies if the min-pool-size should be considered strictly.
               Default false
              ]]>
           </xs:documentation>
@@ -229,13 +384,14 @@
       </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="securityType">
     <xs:sequence>
       <xs:element name="user-name" type="xs:token" minOccurs="0">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-               Specify the default username used when creating a new connection. 
+              Specifies the username used when creating a new connection. 
               Ex: <user-name>sa</user-name>
               ]]>
           </xs:documentation>
@@ -245,22 +401,52 @@
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-            Specify the default password used when creating a new connection. 
-            Ex: <password>sa-pass</password>]]>
+              Specifies the password used when creating a new connection. 
+              Ex: <password>sa-pass</password>
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="admin-objectsType">
     <xs:sequence>
-      <xs:element name="admin-object" type="admin-objectType" minOccurs="0" maxOccurs="unbounded"></xs:element>
+      <xs:element name="admin-object" type="admin-objectType" minOccurs="1" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the setup for an admin object
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="bean-validation-groupsType">
     <xs:sequence>
-      <xs:element name="bean-validation-group" type="xs:token" minOccurs="1" maxOccurs="unbounded"></xs:element>
+      <xs:element name="bean-validation-group" type="xs:token" minOccurs="1" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the fully qualified class name for a bean validation group that
+              should be used for validation
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
-  <xs:element name="ironjacamar" type="resource-adapterType"></xs:element>
-</xs:schema>
\ No newline at end of file
+
+  <xs:element name="ironjacamar" type="ironjacamarType">
+    <xs:annotation>
+      <xs:documentation>
+        <![CDATA[[
+          Specifies the fully qualified class name for a bean validation group that
+          should be used for validation
+         ]]>
+      </xs:documentation>
+    </xs:annotation>
+  </xs:element>
+</xs:schema>

Modified: projects/jboss-jca/trunk/common/src/main/resources/schema/resource-adapters_1_0.xsd
===================================================================
--- projects/jboss-jca/trunk/common/src/main/resources/schema/resource-adapters_1_0.xsd	2010-09-09 15:33:20 UTC (rev 108083)
+++ projects/jboss-jca/trunk/common/src/main/resources/schema/resource-adapters_1_0.xsd	2010-09-09 16:03:13 UTC (rev 108084)
@@ -1,37 +1,107 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
   <xs:complexType name="boolean-presenceType"></xs:complexType>
+
   <xs:complexType name="config-propertyType" mixed="true">
+    <xs:annotation>
+      <xs:documentation>
+        <![CDATA[[
+          Specifies an override for a config-property element in ra.xml or a @ConfigProperty
+         ]]>
+      </xs:documentation>
+    </xs:annotation>
     <xs:simpleContent>
       <xs:extension base="xs:token">
-        <xs:attribute use="required" name="name" type="xs:token"></xs:attribute>
+        <xs:attribute use="required" name="name" type="xs:token">
+          <xs:annotation>
+            <xs:documentation>
+              <![CDATA[[
+                Specifies the name of the config-property
+               ]]>
+            </xs:documentation>
+          </xs:annotation>
+        </xs:attribute>
       </xs:extension>
     </xs:simpleContent>
   </xs:complexType>
   
   <xs:complexType name="resource-adapterType">
     <xs:sequence>
-      <xs:element name="archive" type="xs:token" minOccurs="1" maxOccurs="1"></xs:element>
+      <xs:element name="archive" type="xs:token" minOccurs="1" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the resource adapter archive to be activated
+              E.g. <archive>myra.rar</archive>
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="bean-validation-groups" type="bean-validation-groupsType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies bean validation group that should be used
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="bootstrap-context" type="xs:token" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the unique name of the bootstrap context that should be used
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
       <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-               The config-property specifies a mannaged connection factory property.
+               The config-property specifies resource adapter configuration properties.
               ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
-      <xs:element name="bean-validation-groups" type="bean-validation-groupsType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="bootstrap-context" type="xs:token" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="transaction-support" type="transaction-supportType" minOccurs="0"></xs:element>
-      <xs:element name="connection-definitions" type="connection-definitionsType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="admin-objects" type="admin-objectsType" minOccurs="0" maxOccurs="1"></xs:element>
+      <xs:element name="transaction-support" type="transaction-supportType" minOccurs="0">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the transaction support level of the resource adapter
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="connection-definitions" type="connection-definitionsType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the connection definitions
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="admin-objects" type="admin-objectsType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the administration objects
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:simpleType name="transaction-supportType">
     <xs:annotation>
-      <xs:documentation> Define the typoe of transaction supported by this respurce adapter. It overrides/selects
-        connection manager one valid value are: NoTransaction, LocalTransaction, XA</xs:documentation>
+      <xs:documentation>
+        <![CDATA[[
+          Define the type of transaction supported by this resource adapter.
+          Valid values are: NoTransaction, LocalTransaction, XATransaction
+         ]]>
+      </xs:documentation>
     </xs:annotation>
     <xs:restriction base="xs:token">
       <xs:enumeration value="NoTransaction" />
@@ -39,29 +109,71 @@
       <xs:enumeration value="XATransaction" />
     </xs:restriction>
   </xs:simpleType>
+
   <xs:attributeGroup name="common-attribute">
-    <xs:attribute name="class-name" type="xs:token" use="optional"></xs:attribute>
-    <xs:attribute name="jndi-name" type="xs:token" use="required" />
-    <xs:attribute name="enabled" type="xs:boolean" default="true" form="unqualified" use="optional" />
+    <xs:attribute name="class-name" type="xs:token" use="optional">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Specifies the the fully qualified class name of a managed connection factory
+            or admin object
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
+    <xs:attribute name="jndi-name" type="xs:token" use="required">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Specifies the JNDI name
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
+    <xs:attribute name="enabled" type="xs:boolean" default="true" form="unqualified" use="optional">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Should the object in question be activated
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
     <xs:attribute default="false" name="use-java-context" type="xs:boolean">
       <xs:annotation>
         <xs:documentation>
           <![CDATA[[
-              Setting this to false will bind the DataSource into global jndi
-              Ex:
-              <use-java-context>false</use-java-context>
+            Specifies if a global JNDI context should be used 
            ]]>
         </xs:documentation>
       </xs:annotation>
     </xs:attribute>
-    <xs:attribute name="pool-name" type="xs:token" use="optional"></xs:attribute>
+    <xs:attribute name="pool-name" type="xs:token" use="optional">
+      <xs:annotation>
+        <xs:documentation>
+          <![CDATA[[
+            Specifies the pool name for the object
+           ]]>
+        </xs:documentation>
+      </xs:annotation>
+    </xs:attribute>
   </xs:attributeGroup>
+
   <xs:complexType name="admin-objectType">
     <xs:sequence>
-      <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded"></xs:element>
+      <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              The config-property specifies administration object configuration properties.
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
     <xs:attributeGroup ref="common-attribute"></xs:attributeGroup>
   </xs:complexType>
+
   <xs:complexType name="time-outType">
     <xs:sequence>
       <xs:element name="blocking-timeout-millis" type="xs:nonNegativeInteger" minOccurs="0">
@@ -112,18 +224,19 @@
         </xs:annotation>
       </xs:element>
       <xs:element name="xa-resource-timeout" type="xs:nonNegativeInteger" minOccurs="0" maxOccurs="1">
-            <xs:annotation>
-              <xs:documentation><![CDATA[[
-               EXPRESSED IN SECONDS
-               Passed to XAResource.setTransactionTimeout()
-               Default is zero which does not invoke the setter
-               e.g. 5 minutes
-               <xa-resource-timeout>300</xa-resource-timeout>]]>
-              </xs:documentation>
-            </xs:annotation>
-          </xs:element>
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Passed to XAResource.setTransactionTimeout(). Default is zero which does not invoke the setter.              
+              Specified in seconds - e.g. 5 minutes
+              <xa-resource-timeout>300</xa-resource-timeout>
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="validationType">
     <xs:sequence>
       <xs:element name="background-validation" type="xs:boolean" minOccurs="0">
@@ -146,7 +259,7 @@
           </xs:documentation>
         </xs:annotation>
       </xs:element>
-            <xs:element name="use-fast-fail" type="xs:boolean" minOccurs="0">
+      <xs:element name="use-fast-fail" type="xs:boolean" minOccurs="0">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
@@ -157,42 +270,108 @@
           </xs:documentation>
         </xs:annotation>
       </xs:element>
-        </xs:sequence>
+    </xs:sequence>
   </xs:complexType>
 
-  <xs:element name="resource-adapters" type="resource-adaptersType"></xs:element>
+  <xs:element name="resource-adapters" type="resource-adaptersType">
+    <xs:annotation>
+      <xs:documentation>
+        <![CDATA[[
+          Specifies activation of resource adapters
+         ]]>
+      </xs:documentation>
+    </xs:annotation>
+  </xs:element>
+
   <xs:complexType name="resource-adaptersType">
     <xs:sequence>
-      <xs:element name="resource-adapter" type="resource-adapterType" minOccurs="1" maxOccurs="unbounded"></xs:element>
+      <xs:element name="resource-adapter" type="resource-adapterType" minOccurs="1" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies activation of a resource adapter
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
 
   <xs:complexType name="connection-definitionsType">
     <xs:sequence>
-      <xs:element name="connection-definition" type="connection-defintionType" minOccurs="1" maxOccurs="unbounded"></xs:element>
+      <xs:element name="connection-definition" type="connection-defintionType" minOccurs="1" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies a connection definition
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
 
   <xs:complexType name="connection-defintionType">
     <xs:sequence>
-     <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded"></xs:element>
+     <xs:element name="config-property" type="config-propertyType" minOccurs="0" maxOccurs="unbounded">
+       <xs:annotation>
+         <xs:documentation>
+           <![CDATA[[
+             The config-property specifies managed connection factory configuration properties.
+            ]]>
+         </xs:documentation>
+       </xs:annotation>
+     </xs:element>
       <xs:element name="no-tx-separate-pools" type="boolean-presenceType" minOccurs="0" maxOccurs="1">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
               Whether to use separete pools for connection retrieved in a transaction 
-               and those retieved outside a transaction e.g. <no-tx-separate-pools/>  
-              ]]>
+              and those retieved outside a transaction e.g. <no-tx-separate-pools/>  
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
-      <xs:element name="pool" type="poolType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="security" type="securityType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="timeout" type="time-outType" minOccurs="0" maxOccurs="1"></xs:element>
-      <xs:element name="vaidation" type="validationType" minOccurs="0" maxOccurs="1"></xs:element>
+      <xs:element name="pool" type="poolType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies pooling settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="security" type="securityType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies security settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="timeout" type="time-outType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies timeout settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="vaidation" type="validationType" minOccurs="0" maxOccurs="1">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies validation settings
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
     <xs:attributeGroup ref="common-attribute"></xs:attributeGroup>
   </xs:complexType>
+
   <xs:complexType name="poolType">
     <xs:sequence>
       <xs:element name="min-pool-size" type="xs:nonNegativeInteger" minOccurs="0">
@@ -211,7 +390,7 @@
           <xs:documentation>
             <![CDATA[[
               The max-pool-size element indicates the maximum number of connections 
-              for a pool. No more than MaxSize connections will be created in each sub-pool. 
+              for a pool. No more than max-pool-size connections will be created in each sub-pool. 
               This defaults to 20. 
              ]]>
           </xs:documentation>
@@ -221,9 +400,8 @@
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-              Whether to attempt to prefill the connection pool. Empty element denotes 
-              a true value. e.g. <prefill>true</prefill>.
-              Default is true
+              Whether to attempt to prefill the connection pool. Default is true.
+              e.g. <prefill>true</prefill>.
              ]]>
           </xs:documentation>
         </xs:annotation>
@@ -232,31 +410,33 @@
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-              Define if the min-pool-size should be considered a strictly.
+              Define if the min-pool-size should be considered strict.
               Default false
              ]]>
           </xs:documentation>
         </xs:annotation></xs:element>
     </xs:sequence>
   </xs:complexType>
+
   <xs:complexType name="securityType">
     <xs:sequence>
-            <xs:element name="user-name" type="xs:token" minOccurs="0">
+      <xs:element name="user-name" type="xs:token" minOccurs="0">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-               Specify the default username used when creating a new connection. 
+              Specify the username used when creating a new connection. 
               Ex: <user-name>sa</user-name>
-              ]]>
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
-            <xs:element name="password" type="xs:token" minOccurs="0">
+      <xs:element name="password" type="xs:token" minOccurs="0">
         <xs:annotation>
           <xs:documentation>
             <![CDATA[[
-            Specify the default password used when creating a new connection. 
-            Ex: <password>sa-pass</password>]]>
+              Specify the password used when creating a new connection. 
+              Ex: <password>sa-pass</password>
+             ]]>
           </xs:documentation>
         </xs:annotation>
       </xs:element>
@@ -264,12 +444,31 @@
   </xs:complexType>
 
   <xs:complexType name="admin-objectsType">
-    <xs:sequence><xs:element name="admin-object" type="admin-objectType" minOccurs="0" maxOccurs="unbounded"></xs:element></xs:sequence>
+    <xs:sequence>
+      <xs:element name="admin-object" type="admin-objectType" minOccurs="1" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the setup for an admin object
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
+    </xs:sequence>
   </xs:complexType>
 
   <xs:complexType name="bean-validation-groupsType">
     <xs:sequence>
-      <xs:element name="bean-validation-group" type="xs:token" minOccurs="1" maxOccurs="unbounded"></xs:element>
+      <xs:element name="bean-validation-group" type="xs:token" minOccurs="1" maxOccurs="unbounded">
+        <xs:annotation>
+          <xs:documentation>
+            <![CDATA[[
+              Specifies the fully qualified class name for a bean validation group that
+              should be used for validation
+             ]]>
+          </xs:documentation>
+        </xs:annotation>
+      </xs:element>
     </xs:sequence>
   </xs:complexType>
-</xs:schema>
\ No newline at end of file
+</xs:schema>



More information about the jboss-cvs-commits mailing list