Merge pull request #920

[mono.git] / mcs / class / System.XML / Documentation / en / System.Xml.Schema / XmlSchemaCompilationSettings.xml

diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCompilationSettings.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCompilationSettings.xml
index 637e1f554ddae260f89df8083dec53c3bbb60fec..cb11d0fc8bccffdc96eb090c62bc62936f98af19 100644 (file)
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCompilationSettings.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCompilationSettings.xml
@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
 <Type Name="XmlSchemaCompilationSettings" FullName="System.Xml.Schema.XmlSchemaCompilationSettings">
   <TypeSignature Language="C#" Value="public sealed class XmlSchemaCompilationSettings" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit XmlSchemaCompilationSettings extends System.Object" />
@@ -11,9 +12,15 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
     <since version=".NET 2.0" />
+    <remarks>
+      <attribution license="cc4" from="Microsoft" modified="false" />
+      <para>The <see cref="T:System.Xml.Schema.XmlSchemaCompilationSettings" /> class provides schema compilation options for the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> class. For example, the <see cref="P:System.Xml.Schema.XmlSchemaCompilationSettings.EnableUpaCheck" /> property specifies that the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> should check for Unique Particle Attribution (UPA) violations when schemas in the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> are compiled.</para>
+    </remarks>
+    <summary>
+      <attribution license="cc4" from="Microsoft" modified="false" />
+      <para>Provides schema compilation options for the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> class This class cannot be inherited.</para>
+    </summary>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -26,9 +33,12 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Initializes a new instance of the <see cref="T:System.Xml.Schema.XmlSchemaCompilationSettings" /> class. </para>
+        </summary>
       </Docs>
     </Member>
     <Member MemberName="EnableUpaCheck">
@@ -43,11 +53,41 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>When the <see cref="P:System.Xml.Schema.XmlSchemaCompilationSettings.EnableUpaCheck" /> property is set to false, validation will be performed based on the following rules.</para>
+          <list type="ordered">
+            <item>
+              <para>If there is a choice between a strong type and a wildcard, the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> will pick the strongly typed particle as illustrated in the following schema and Xml examples.</para>
+            </item>
+          </list>
+          <para>&lt;xs:sequence&gt;</para>
+          <para>    &lt;xs:any namespace="##any"/&gt;</para>
+          <para>    &lt;xs:element name="A" type="xs:string" minOccurs="0"/&gt;</para>
+          <para>&lt;/xs:sequence&gt;</para>
+          <para>In the following Xml, the A element will be associated with &lt;xs:element name="A" type="xs:string" minOccurs="0"/&gt; in the schema.</para>
+          <para>&lt;A&gt;some text&lt;/A&gt;</para>
+          <list type="ordered">
+            <item>
+              <para>If there is a choice between two strongly typed elements, the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> will pick the first one.</para>
+            </item>
+          </list>
+          <para>&lt;xs:sequence&gt;</para>
+          <para>    &lt;xs:element name="A" type="xs:string"/&gt;</para>
+          <para>    &lt;xs:element name="B" type="xs:string" minOccurs="0"/&gt;</para>
+          <para>    &lt;xs:element name="B" type="xs:string"/&gt;</para>
+          <para>&lt;/xs:sequence&gt;</para>
+          <para>In the following Xml, the B element will be associated with &lt;xs:element name="B" type="xs:string" minOccurs="0"/&gt; in the schema.</para>
+          <para>&lt;A/&gt;</para>
+          <para>&lt;B/&gt;</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Gets or sets a value indicating whether the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> should check for Unique Particle Attribution (UPA) violations.</para>
+        </summary>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file