Doc updates

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

doc/en/Gnome/CanvasItem.xml

@@ -303,7 +303,6 @@
         </remarks>
       </Docs>
     </Member>
-    
     <Member MemberName="Ungrab">
       <MemberSignature Language="C#" Value="public void Ungrab (uint etime);" />
       <MemberType>Method</MemberType>
@@ -320,7 +319,6 @@
         </remarks>
       </Docs>
     </Member>
-    
     <Member MemberName="Raise">
       <MemberSignature Language="C#" Value="public void Raise (int positions);" />
       <MemberType>Method</MemberType>
@@ -414,7 +412,6 @@
         </remarks>
       </Docs>
     </Member>
-    
     <Member MemberName=".ctor">
       <MemberSignature Language="C#" Value="public CanvasItem (IntPtr raw);" />
       <MemberType>Constructor</MemberType>
@@ -460,7 +457,8 @@
         <Attribute>
           <AttributeName>GLib.Property(Name="parent")</AttributeName>
         </Attribute>
-      </Attributes></Member>
+      </Attributes>
+    </Member>
     <Member MemberName="CanvasEvent">
       <MemberSignature Language="C#" Value="public event Gnome.CanvasEventHandler CanvasEvent;" />
       <MemberType>Event</MemberType>
@@ -483,7 +481,8 @@
         <Attribute>
           <AttributeName>GLib.Signal(CName="event")</AttributeName>
         </Attribute>
-      </Attributes></Member>
+      </Attributes>
+    </Member>
     <Member MemberName="GType">
       <MemberSignature Language="C#" Value="public static GLib.GType GType { get; };" />
       <MemberType>Property</MemberType>
@@ -529,7 +528,8 @@
         <Attribute>
           <AttributeName>System.Obsolete(Message=null, IsError=False)</AttributeName>
         </Attribute>
-      </Attributes></Member>
+      </Attributes>
+    </Member>
     <Member MemberName=".ctor">
       <MemberSignature Language="C#" Value="public CanvasItem (Gnome.CanvasGroup group, GLib.GType type);" />
       <MemberType>Constructor</MemberType>
@@ -624,7 +624,7 @@
         <Parameter Name="buf" Type="Gnome.CanvasBuf&amp;" RefType="ref" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Renders the CanvasItem when using an anti-aliased GnomeCanvas.</summary>
         <param name="buf">a <see cref="T:Gnome.CanvasBuf" /></param>
         <remarks>To be added</remarks>
       </Docs>

doc/en/Gtk/Button.xml

@@ -387,7 +387,16 @@ public class ButtonApp  {
       <Docs>
         <summary>Creates a new <see cref="T:Gtk.Button" /> containing the image and text from a stock item.</summary>
         <param name="stock_id">a <see cref="T:System.String" /></param>
-        <remarks>The valid names of Stock items can be found in the <see cref="T:Gtk.Stock" /> class.</remarks>
+        <remarks>The valid names of Stock items can be found in the <see cref="T:Gtk.Stock" /> class.
+
+
+<para>
+This for example creates a stock OK button:
+</para><example>
+            <code lang="C#">
+     Button b = new Button (Stock.Ok);
+  </code>
+          </example></remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">

doc/en/Gtk/Dialog.xml

@@ -181,7 +181,7 @@ namespace GtkDialogSample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Waits for the <see cref="E:Gtk.Dialog.Response" /> event or the <see cref="T:Gtk.Dialog" /> to be detroyed.</summary>
+        <summary>Waits for the <see cref="E:Gtk.Dialog.Response" /> event or the <see cref="T:Gtk.Dialog" /> to be destroyed.</summary>
         <returns>an object of type <see cref="T:System.UInt32" />.</returns>
         <remarks>
           <para>