From Larry Ewing

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

doc/en/Gdk/Pixbuf.xml

@@ -13,7 +13,7 @@
     <summary>In memory image handling and representation.</summary>
     <remarks>
       <para>
-	The Gdk.Pixbuf class is used to represent an image in
+	The <see cref="T:Gdk.Pixbuf" /> class is used to represent an image in
 	memory.  The in-memory representation uses either a three
 	byte RGB representation or a four byte RGBA representation.  
       </para>
@@ -601,16 +601,17 @@
         <Parameter Name="alpha_threshold" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Render pixbuf alpha channel as a bi-level clip mask to a <see cref="T:Gdk.Bitmap" /></summary>
-        <param name="bitmap">To be added: an object of type 'Gdk.Bitmap'</param>
+        <param name="bitmap">The destination object of type 'Gdk.Bitmap'</param>
-        <param name="src_x">To be added: an object of type 'int'</param>
+        <param name="src_x">Source X coordinate.</param>
-        <param name="src_y">To be added: an object of type 'int'</param>
+        <param name="src_y">Source Y coordinate.</param>
-        <param name="dest_x">To be added: an object of type 'int'</param>
+        <param name="dest_x">Destination X coordinate.
-        <param name="dest_y">To be added: an object of type 'int'</param>
+</param>
-        <param name="width">To be added: an object of type 'int'</param>
+        <param name="dest_y">Destination Y coordinate.</param>
-        <param name="height">To be added: an object of type 'int'</param>
+        <param name="width">The width of the region to modify, or -1 to use <see cref="P:Gdk.Pixbuf.Width" />.</param>
-        <param name="alpha_threshold">To be added: an object of type 'int'</param>
+        <param name="height">The height of the region to reder or -1 to use <see cref="P:Gdk.Pixbuf.Height" /></param>
-        <remarks>To be added</remarks>
+        <param name="alpha_threshold">Value below this will be painted as zero; all other values will be painted as one.</param>
+        <remarks>This function is designed to threshold and render the alpha values from a rectangular of this <see cref="T:Gdk.Pixbuf" /> into the destination <see cref="T:Gdk.Bitmask" /> which can then be used as a clipping mask for a <see cref="T:Gdk.Drawable" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Composite">
@@ -1057,7 +1058,7 @@
         <returns>Returns the number of channels on a Pixbuf</returns>
         <remarks>
 	  The possible values are 3 (for RGB encoding) and 4 (for RGB
-	  with an alpha transparency channel encoding.
+	  with an alpha transparency channel encoding).
 	</remarks>
       </Docs>
     </Member>
@@ -1180,9 +1181,9 @@
         <Parameter Name="copy_pixels" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Construct a pixbuf from a serialized <see cref="T:Gdk.Pixdata" /> structure.</summary>
-        <param name="data_length">To be added: an object of type 'int'</param>
+        <param name="data_length">The length in bytes of the data to be read.</param>
-        <param name="data">To be added: an object of type 'Void*'</param>
+        <param name="data">The raw data representing the serialized <see cref="T:Gdk.Pixdata" /> structure.</param>
         <param name="copy_pixels">To be added: an object of type 'bool'</param>
         <returns>To be added: an object of type 'Gdk.Pixbuf'</returns>
         <remarks>To be added</remarks>
@@ -1285,7 +1286,7 @@
         <Parameter Name="copy_pixels" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Construct a pixbuf from a serialized <see cref="T:Gdk.Pixdata" /> structure</summary>
         <param name="data_length">a <see cref="T:System.Int32" /></param>
         <param name="data">a <see cref="T:System.Byte[]" /></param>
         <param name="copy_pixels">a <see cref="T:System.Boolean" /></param>