From a613489634ba2b95b812e692ee020708e6f71483 Mon Sep 17 00:00:00 2001
From: Duncan Mak <duncan@mono-cvs.ximian.com>
Date: Tue, 29 Jul 2003 02:44:45 +0000
Subject: [PATCH] Add more docs to XML.

svn path=/trunk/gtk-sharp/; revision=16818
---
 doc/en/Glade/XML.xml | 77 ++++++++++++++++++++++++++++++--------------
 1 file changed, 53 insertions(+), 24 deletions(-)

diff --git a/doc/en/Glade/XML.xml b/doc/en/Glade/XML.xml
index 7955ba047..fbe592015 100644
--- a/doc/en/Glade/XML.xml
+++ b/doc/en/Glade/XML.xml
@@ -352,10 +352,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="name">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'GLib.List'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+          Retrieves a <see cref="T:GLib.List" /> of widgets whose name
+          share the same prefix
+        </summary>
+        <param name="name">the beginning of a widget name</param>
+        <returns>
+          a <see cref="T:GLib.List" /> of widgets whose name starts
+          with <see paramref="name" />
+        </returns>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="GetWidget">
@@ -368,10 +374,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="name">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Gtk.Widget'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+          Retrieves a widget stored in the <see cref="T:Glade.XML" /> by name
+        </summary>
+        <param name="name">the name of the widget to retrieve</param>
+        <returns>
+          the widget specified by <see paramref="name" /> or
+          <see langword="null" /> if no Widgets of that name exists
+        </returns>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="SetValueFromString">
@@ -449,12 +460,20 @@
         <Parameter Name="domain" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="fname">To be added: an object of type 'string'</param>
-        <param name="root">To be added: an object of type 'string'</param>
-        <param name="domain">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Glade.XML'</returns>
-        <remarks>To be added</remarks>
+        <summary>Creates an <see cref="T:Glade.XML" /> from a file </summary>
+        <param name="fname">the filename</param>
+        <param name="root">
+          the widget node to start building from, or <see langword="null" />.
+        </param>
+        <param name="domain">
+          the translation domain for the XML file
+          (<see langword="null" /> is the default)
+        </param>
+        <returns>
+          the newly created <see cref="T:Glade.XML" /> object, or
+          <see langword="null" /> if the operation failed.
+        </returns>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -468,13 +487,23 @@
         <Parameter Name="domain" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="buffer">To be added: an object of type 'string'</param>
-        <param name="size">To be added: an object of type 'int'</param>
-        <param name="root">To be added: an object of type 'string'</param>
-        <param name="domain">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Glade.XML'</returns>
-        <remarks>To be added</remarks>
+        <summary>Creates an <see cref="T:Glade.XML" /> object from a buffer</summary>
+        <param name="buffer">
+          a string containing the content of the glade XML file
+        </param>
+        <param name="size">the length of <see paramref="buffer" /></param>
+        <param name="root">
+          the widget node to start building from, or <see langword="null" />.
+        </param>
+        <param name="domain">
+          the translation domain for the XML file
+          (<see langword="null" /> is the default)
+        </param>
+        <returns>
+          the newly created <see cref="T:Glade.XML" /> object, or
+          <see langword="null" /> if the operation failed.
+        </returns>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -519,9 +548,9 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
-        <remarks>To be added</remarks>
+        <summary>the filename of the <see cref="T:Glade.XML" /> object</summary>
+        <returns>the filename that this Glade XML object is created from</returns>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Toplevel">