From ccd8bc998d690d0e4be8615f0459cf4f78882034 Mon Sep 17 00:00:00 2001
From: Mike Kestner <mkestner@gmail.com>
Date: Fri, 5 Oct 2007 18:20:57 +0000
Subject: [PATCH] document some recent API additions to GLib namespace.

svn path=/trunk/gtk-sharp/; revision=87003
---
 doc/en/GLib/ClassInitializerAttribute.xml |  5 +++++
 doc/en/GLib/List.xml                      | 18 ++++++++++++++++++
 doc/en/GLib/ListBase.xml                  | 15 +++++++++++++++
 doc/en/GLib/Object.xml                    |  9 +++++++++
 doc/en/GLib/Opaque.xml                    | 16 ++++++++++++++++
 doc/en/GLib/SList.xml                     | 18 ++++++++++++++++++
 6 files changed, 81 insertions(+)

diff --git a/doc/en/GLib/ClassInitializerAttribute.xml b/doc/en/GLib/ClassInitializerAttribute.xml
index 0c6b7194d..3bd61429f 100644
--- a/doc/en/GLib/ClassInitializerAttribute.xml
+++ b/doc/en/GLib/ClassInitializerAttribute.xml
@@ -27,4 +27,9 @@
       </Docs>
     </Member>
   </Members>
+  <Attributes>
+    <Attribute>
+      <AttributeName>System.Obsolete("Replaced by TypeInitializerAttribute")</AttributeName>
+    </Attribute>
+  </Attributes>
 </Type>
diff --git a/doc/en/GLib/List.xml b/doc/en/GLib/List.xml
index 572c69bf5..f0061686a 100644
--- a/doc/en/GLib/List.xml
+++ b/doc/en/GLib/List.xml
@@ -142,5 +142,23 @@
         <remarks>This type is only recommended for marshaling GList parameters and return values in bindings.</remarks>
       </Docs>
     </Member>
+    <Member MemberName=".ctor">
+      <MemberSignature Language="C#" Value="public List (object[] elements, Type element_type, bool owned, bool elements_owned);" />
+      <MemberType>Constructor</MemberType>
+      <Parameters>
+        <Parameter Name="elements" Type="System.Object[]" />
+        <Parameter Name="element_type" Type="System.Type" />
+        <Parameter Name="owned" Type="System.Boolean" />
+        <Parameter Name="elements_owned" Type="System.Boolean" />
+      </Parameters>
+      <Docs>
+        <param name="elements">An array of list member objects.</param>
+        <param name="element_type">The type of the members.</param>
+        <param name="owned">Indicates if the list reference must be released on finalization.</param>
+        <param name="elements_owned">Indicates if the list members must be released on finalization.</param>
+        <summary>Public constructor.</summary>
+        <remarks>Constructs a native GList containing a set of member objects.</remarks>
+      </Docs>
+    </Member>
   </Members>
 </Type>
diff --git a/doc/en/GLib/ListBase.xml b/doc/en/GLib/ListBase.xml
index 8a6debdd0..1e83bc87b 100644
--- a/doc/en/GLib/ListBase.xml
+++ b/doc/en/GLib/ListBase.xml
@@ -263,5 +263,20 @@
         <since version="Gtk# 2.4" />
       </Docs>
     </Member>
+    <Member MemberName="Append">
+      <MemberSignature Language="C#" Value="public void Append (object item);" />
+      <MemberType>Method</MemberType>
+      <ReturnValue>
+        <ReturnType>System.Void</ReturnType>
+      </ReturnValue>
+      <Parameters>
+        <Parameter Name="item" Type="System.Object" />
+      </Parameters>
+      <Docs>
+        <param name="item">An item to be appended to the list.</param>
+        <summary>Appends an item to the List.</summary>
+        <remarks />
+      </Docs>
+    </Member>
   </Members>
 </Type>
diff --git a/doc/en/GLib/Object.xml b/doc/en/GLib/Object.xml
index 38bcdfcf3..5c1eda8f9 100644
--- a/doc/en/GLib/Object.xml
+++ b/doc/en/GLib/Object.xml
@@ -465,5 +465,14 @@ This method is called by the generated classes by the Gtk# framework.
         <since version="Gtk# 2.4" />
       </Docs>
     </Member>
+    <Member MemberName=".ctor">
+      <MemberSignature Language="C#" Value="protected Object ();" />
+      <MemberType>Constructor</MemberType>
+      <Parameters />
+      <Docs>
+        <summary>Protected constructor.</summary>
+        <remarks>Chain to this constructor causes a native type to be registered and a native object instance to be constructed.</remarks>
+      </Docs>
+    </Member>
   </Members>
 </Type>
diff --git a/doc/en/GLib/Opaque.xml b/doc/en/GLib/Opaque.xml
index 52cc6e1ca..342bdbeef 100644
--- a/doc/en/GLib/Opaque.xml
+++ b/doc/en/GLib/Opaque.xml
@@ -181,5 +181,21 @@
         <remarks>By default, this is set to <see langword="true" /> for opaque objects created with the no-argument constructor, and <see langword="false" /> for opaque objects created with the <see cref="T:System.IntPtr" /> constructor. Methods that return an opaque object can override this by setting the <see cref="M:GLib.Opaque.Owned" /> property accordingly to obey the memory-management conventions of the underlying C code.</remarks>
       </Docs>
     </Member>
+    <Member MemberName="Copy">
+      <MemberSignature Language="C#" Value="protected virtual GLib.Opaque Copy (IntPtr raw);" />
+      <MemberType>Method</MemberType>
+      <ReturnValue>
+        <ReturnType>GLib.Opaque</ReturnType>
+      </ReturnValue>
+      <Parameters>
+        <Parameter Name="raw" Type="System.IntPtr" />
+      </Parameters>
+      <Docs>
+        <param name="raw">Native opaque structure pointer to copy.</param>
+        <summary>Copies an existing opaque type.</summary>
+        <returns>A copied reference, or the original if the type doesn't support copying.</returns>
+        <remarks />
+      </Docs>
+    </Member>
   </Members>
 </Type>
diff --git a/doc/en/GLib/SList.xml b/doc/en/GLib/SList.xml
index ffcf9f199..be0c394cc 100644
--- a/doc/en/GLib/SList.xml
+++ b/doc/en/GLib/SList.xml
@@ -83,5 +83,23 @@
         <remarks>This type should only be used for marshaling GSList parameters and return values in bindings.</remarks>
       </Docs>
     </Member>
+    <Member MemberName=".ctor">
+      <MemberSignature Language="C#" Value="public SList (object[] members, Type element_type, bool owned, bool elements_owned);" />
+      <MemberType>Constructor</MemberType>
+      <Parameters>
+        <Parameter Name="members" Type="System.Object[]" />
+        <Parameter Name="element_type" Type="System.Type" />
+        <Parameter Name="owned" Type="System.Boolean" />
+        <Parameter Name="elements_owned" Type="System.Boolean" />
+      </Parameters>
+      <Docs>
+        <param name="members">An array of list member objects.</param>
+        <param name="element_type">The type of the members.</param>
+        <param name="owned">Indicates if the list reference must be released on finalization.</param>
+        <param name="elements_owned">Indicates if the list members must be released on finalization.</param>
+        <summary>Public constructor.</summary>
+        <remarks>Constructs a native GList containing a set of member objects.</remarks>
+      </Docs>
+    </Member>
   </Members>
 </Type>