Flush

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

AUTHORS

@@ -13,3 +13,4 @@ Documentation:
 	chris@turchin.net (Chris Turchin)
 	jaspervp@gmx.net (Jasper van Putten)
 	wizito@gentelibre.org ( Néstor Salceda)
+	cmorgan@alum.wpi.edu

doc/en/Gdk/Drawable.xml

@@ -241,7 +241,8 @@
 	    <see cref="T:Gdk.Pixmap" /> and <see cref="T:Gdk.Window" /> are server-side
 	    objects. This method obtains the pixels from a
 	    server-side drawable as a client-side <see cref="T:Gdk.Image" />.  
-	  </p><p>
+	  </p>
+          <p>
 	    The format of a <see cref="T:Gdk.Image" /> depends on 
 	    the <see cref="T:Gdk.Visual" /> of the current display, which
 	    makes manipulating <see cref="T:Gdk.Image" /> extremely difficult; 
@@ -262,22 +263,26 @@
         <returns>A <see cref="T:Gdk.Image" /> containing the contents of this Drawable object.</returns>
         <remarks>
           <p>
-	  </p><p>
+          </p>
+          <p>
             <paramref name="x" />, <paramref name="y" />, 
 	    <paramref name="width" />, and <paramref name="height" /> define 
 	    the region of the drawable to obtain as an image.
-	  </p><p>
+	  </p>
+          <p>
 	    You would usually copy image data to the client side if you intend
 	    to examine the values of individual pixels, for example to darken
 	    an image or add a red tint. It would be prohibitively slow to
 	    make a round-trip request to the windowing system for each pixel,
 	    so instead you get all of them at once, modify them, then copy
 	    them all back at once.
-	  </p><p>
+	  </p>
+          <p>
 	    If the X server or other windowing system backend is on the local
 	    machine, this function may use shared memory to avoid copying
 	    the image data.
-	  </p><p>
+	  </p>
+          <p>
 	    If the source drawable is a #GdkWindow and partially offscreen
 	    or obscured, then the obscured portions of the returned image
 	    will contain undefined data.
@@ -327,8 +332,7 @@
 	  bitmap as a clip mask on your #GdkGC, then use gdk_draw_rectangle()
 	  to draw a rectangle clipped to the bitmap.
 	  <p>TODO: This API needs to be adjusted; <paramref name="src" /> should
-	    probably not exist.</p>
-	</remarks>
+	    probably not exist.</p></remarks>
       </Docs>
     </Member>
     <Member MemberName="DrawImage">
@@ -599,13 +603,27 @@
         <summary>To be added</summary>
         <param name="gc">a <see cref="T:Gdk.GC" /></param>
         <param name="filled">a <see cref="T:System.Boolean" /></param>
-        <param name="x">a <see cref="T:System.Int32" /></param>
-        <param name="y">a <see cref="T:System.Int32" /></param>
+        <param name="x">a <see cref="T:System.Int32" /><para>
+The x-coordinate of the upper left hand of the bounding box of the arc.
+</para></param>
+        <param name="y">a <see cref="T:System.Int32" /><para>
+The y-coordinate of the upper left hand of the bounding box of the arc.
+</para></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <param name="angle1">a <see cref="T:System.Int32" /></param>
-        <param name="angle2">a <see cref="T:System.Int32" /></param>
-        <remarks/>
+        <param name="angle1">a <see cref="T:System.Int32" /><para>
+The starting angle of the arc in the clockwise direction in reference to the 3'oclock position in terms of 1/64th of a degree.
+</para></param>
+        <param name="angle2">a <see cref="T:System.Int32" /><para>
+The number of 1/64ths of a degree to sweep the arc in a clockwise direction relative to the starting angle.
+</para></param>
+        <remarks>
+          <example>
+	Draw the left side of a circle with a radius of 5 units.
+  <code lang="C#">
+	Gdk.Pixmap.DrawArc(gc, false, 0, 0, 10, 10, 90 * 64, 180 * 64);
+  </code></example>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="DrawPixbuf">

doc/en/Gtk/Window.xml

@@ -868,10 +868,9 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>Sets ot obtains the transient parent.</summary>
+        <summary>Sets or obtains the transient parent window.</summary>
         <param name="value">Parent <paramref name="window" />.</param>
-        <returns>
-        </returns>
+        <returns />
         <remarks>
           <para>
 	  Dialog windows should be transient for the main <paramref name="window" /> they were spawned from, this allows windows managers to e.g. keep the dialog on top of the main <paramref name="window" />, or center the dialog over the main <paramref name="window" />.