Changes from Erik Dasque

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

doc/en/GConf/ChangeSet.xml

@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
+    <summary>A ChangeSet is a set of changes to the GConf database that can be commited and reversed easily.</summary>
-    <remarks>To be added</remarks>
+    <remarks>The changes can be both set and unset operations. Currently the ChangeSet operations are not atomic, and not specially optimized for. However, it is suitable for use, for instance, preferences dialogs.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>GConf.ClientBase</BaseTypeName>
@@ -31,8 +31,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Disposes the resources associated with the object</summary>
-        <remarks>To be added</remarks>
+        <remarks>Called by Finalize</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -41,8 +41,8 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Initializes a new ChangeSet object</summary>
-        <returns>To be added: an object of type 'GConf.ChangeSet'</returns>
+        <returns>an object of type 'GConf.ChangeSet'</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>

doc/en/GConf/NoSuchKeyException.xml

@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
+    <summary>This Exception is thrown when a key is not found in the user GConf file</summary>
-    <remarks>To be added</remarks>
+    <remarks>This exception is thrown by the Get methods of the ChangeSet and Client classes when a value is requested for a key that does not exist.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Exception</BaseTypeName>

doc/en/GConf/NotifyEventArgs.xml

@@ -10,7 +10,7 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
+    <summary>Arguments of the GConf Notify event that was called due to a GConf key being added, removed or updated.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
@@ -28,11 +28,11 @@
         <Parameter Name="val" Type="System.Object" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>This constructor is called to initialize a NotifyEventArgs with the key/value that was updated, removed or added in GConf</summary>
         <param name="key">To be added: an object of type 'string'</param>
         <param name="val">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'GConf.NotifyEventArgs'</returns>
+        <returns>an object of type 'GConf.NotifyEventArgs', event arguments to the NotifyEventHandler delegate</returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Value">
@@ -42,8 +42,9 @@
         <ReturnType>System.Object</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
+        <summary>This NotifyEventArgs property refers to the GConf Value from an entry which modification, addition or removal cause the event to be fired.
-        <returns>To be added: an object of type 'object'</returns>
+</summary>
+        <returns>the object stored in the GConf which modification, removal or addition cause the event to be fired.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -54,8 +55,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
+        <summary>This NotifyEventArgs property refers to the key which value modification, addition or removal cause the event to be fired.</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>a string for the key name</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>

doc/en/GConf/NotifyEventHandler.xml

@@ -9,8 +9,13 @@
   </AssemblyInfo>
   <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>To be added</summary>
+    <summary>NotifyEventHandler is a delegate object that can be used to notify your program whenever a key's value is changed, either in your program or externally (i.e. via gconf-editor).</summary>
-    <remarks>To be added</remarks>
+    <remarks>You only have to attach a GConf.NotifyEventHandler delegate to a key, this way:
+<example>
+        <code lang="C#">gconfClient.AddNotify (key, new GConf.NotifyEventHandler(function));
+  </code>
+      </example>
+This is very important for graphic interfaces, as it is a good practice to make the application react instantly to preference changes.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>