From be5d49f85de0e028dbc448d2e761914076fcf357 Mon Sep 17 00:00:00 2001
From: Dan Winship <danw@mono-cvs.ximian.com>
Date: Tue, 9 Nov 2004 14:22:51 +0000
Subject: [PATCH]         * en/GLib/Object.xml:         * en/Gtk/Widget.xml:
 update for CreateNativeObject changes

svn path=/trunk/gtk-sharp/; revision=35886
---
 doc/ChangeLog          |  5 +++++
 doc/en/GLib/Object.xml | 10 +++++-----
 doc/en/Gtk/Widget.xml  | 16 ++++++++++++++++
 3 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 2af7938d4..70e1b9e2d 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2004-11-09  Dan Winship  <danw@novell.com>
+
+	* en/GLib/Object.xml: 
+	* en/Gtk/Widget.xml: update for CreateNativeObject changes
+
 2004-11-08  Dan Winship  <danw@novell.com>
 
 	* en/Gtk/Box.xml:
diff --git a/doc/en/GLib/Object.xml b/doc/en/GLib/Object.xml
index 8a1a5ecae..ae880be93 100644
--- a/doc/en/GLib/Object.xml
+++ b/doc/en/GLib/Object.xml
@@ -319,7 +319,7 @@
       </Docs>
     </Member>
     <Member MemberName="CreateNativeObject">
-      <MemberSignature Language="C#" Value="protected void CreateNativeObject (string [] names, GLib.Value[] vals);" />
+      <MemberSignature Language="C#" Value="protected virtual void CreateNativeObject (string [] names, GLib.Value[] vals);" />
       <MemberType>Method</MemberType>
       <ReturnValue>
         <ReturnType>System.Void</ReturnType>
@@ -329,10 +329,10 @@
         <Parameter Name="vals" Type="GLib.Value[]" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="names">a <see cref="T:System.String" /></param>
-        <param name="vals">a <see cref="T:GLib.Value" /></param>
-        <remarks>To be added</remarks>
+        <summary>Creates the GObject underlying a managed <see cref="T:GLib.Object"/> subclass</summary>
+        <param name="names">an array of (GObject) property names</param>
+        <param name="vals">the values for the properties identified by <paramref name="names"/></param>
+        <remarks>This is the method used by managed <see cref="T:GLib.Object"/> subclasses (as opposed to classes that are just wrappers around C-based objects) to create their underlying GObject. It will be invoked for you automatically by when you chain to your subclass's base class constructor.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetProperty">
diff --git a/doc/en/Gtk/Widget.xml b/doc/en/Gtk/Widget.xml
index d6c596fef..01c181374 100644
--- a/doc/en/Gtk/Widget.xml
+++ b/doc/en/Gtk/Widget.xml
@@ -4148,4 +4148,20 @@ Widgets are required to honor the size allocation they receive; a size request i
         <param name="label">a <see cref="T:Gtk.Widget" /></param>
         <remarks>To be added</remarks>
       </Docs>
+    </Member><Member MemberName="CreateNativeObject">
+      <MemberSignature Language="C#" Value="protected override void CreateNativeObject (string [] names, GLib.Value[] vals);" />
+      <MemberType>Method</MemberType>
+      <ReturnValue>
+        <ReturnType>System.Void</ReturnType>
+      </ReturnValue>
+      <Parameters>
+        <Parameter Name="names" Type="System.String[]" />
+        <Parameter Name="vals" Type="GLib.Value[]" />
+      </Parameters>
+      <Docs>
+        <summary>Creates the GObject underlying a managed <see cref="T:Gtk.Widget"/> subclass</summary>
+        <param name="names">an array of (GObject) property names</param>
+        <param name="vals">the values for the properties identified by <paramref name="names"/></param>
+        <remarks>See <see cref="M:GLib.Object.CreateNativeObject"/> for more details. This overridden method also sets up event handlers on the object to ensure that the wrapper object always stays alive when the widget is contained by another widget (even when it is contained by an unmanaged widget that doesn't know about its managed wrapper).</remarks>
+      </Docs>
     </Member></Members></Type>
\ No newline at end of file