Patch from gnumuthu@users.sf.net

svn path=/trunk/gtk-sharp/; revision=56298

doc/en/GLib/Argv.xml

@@ -8,7 +8,17 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>Argv marshaling class.</summary>
-    <remarks />
+    <remarks>Argv class is used to get the arguments passed to the program from the command line.
+
+<example>
+        <code lang="shell">
+   $mono hello.exe 1 2 3 4
+  </code>
+      </example>
+
+Then you application [hello.exe] will be able to access these arguments passed from the command line,
+[1,2,3,4 in this case] using the Glib.Argv class.
+</remarks>
     <since version="Gtk# 2.4" />
   </Docs>
   <Base>
@@ -74,4 +84,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Glade/Global.xml

@@ -9,7 +9,24 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>Global API elements for <see cref="N:Glade" /></summary>
-    <remarks />
+    <remarks>Global class collects certain, commonly used funtions of the underlying libglade API
+which is necessary to glade-sharp to load the .glade files.
+
+All members of this class are static functions.
+
+Glade-sharp uses the functions to load
+
+<list type="bullet">
+        <item>
+          <term>Register custom properties to a widget </term>
+        </item>
+        <item>
+          <term>Read enums/flags from strings present in .glade files </term>
+        </item>
+        <item>
+          <term>Register widget with XML tree, read widget name from widget pointer</term>
+        </item>
+      </list></remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
@@ -29,7 +46,7 @@
         <summary>Used to get the name of a widget that was generated by a <see cref="T:Glade.XML" /> object.</summary>
         <param name="widget">a <see cref="T:Gtk.Widget" /></param>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks />
+        <remarks>Get Widget Name of current widget.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetWidgetTree">
@@ -86,7 +103,8 @@
       <Parameters />
       <Docs>
         <summary>Default constructor</summary>
-        <remarks />
+        <remarks>The Global class has only static functions, and no methods,
+which make it redundant for us to normally create this object.</remarks>
       </Docs>
     </Member>
     <Member MemberName="RegisterCustomProp">
@@ -141,7 +159,7 @@
         <param name="type">a <see cref="T:GLib.GType" /></param>
         <param name="str1ng">a <see cref="T:System.String" /></param>
         <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks />
+        <remarks>The string is composed of string names or nicknames for various flags separated by '|'. </remarks>
       </Docs>
     </Member>
     <Member MemberName="RegisterWidget">
@@ -167,4 +185,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Glade/HandlerNotFoundException.xml

@@ -9,7 +9,13 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>Exception thrown when signal autoconnection fails.</summary>
-    <remarks />
+    <remarks>This class is the expression thrown, when signal autoconnection fails.
+This happens when you donot have the functions assigned in your callback
+section of the .glade file, present in your CIL assembly. 
+
+You can rectify this exception by adding the corresponding function in
+your code, and recompiling the application.
+</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.SystemException</BaseTypeName>
@@ -128,4 +134,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Glade/Parser.xml

@@ -9,7 +9,12 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>Glade's parser used to turn XML into its internal format.</summary>
-    <remarks />
+    <remarks>Parser class loads / parses the .glade files from memory [buffer], or a file in disk.
+This class has the helper functions to load the UI description from file/buffer, and 
+turn it into a GladeInterface, which has metadata about the .glade file,
+its connections and properties etc.
+
+</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
@@ -66,4 +71,4 @@ Generally, user code will not need to call this function. Instead, it should go
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>