From 3e3994e202f6c20026a5d1dd97e97fcd3f67c48b Mon Sep 17 00:00:00 2001
From: "Hector E. Gomez Morales" <hectoregm@gmail.com>
Date: Thu, 2 Mar 2006 01:40:08 +0000
Subject: [PATCH] svn path=/trunk/gtk-sharp/; revision=57493

---
 doc/ChangeLog                 |  6 ++++++
 doc/en/Gdk/Pixbuf.xml         | 20 ++++++++++----------
 doc/en/Gdk/PixbufRotation.xml | 22 +++++++++++-----------
 doc/en/Gdk/PixbufSaveFunc.xml | 14 ++++++++------
 4 files changed, 35 insertions(+), 27 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 2afa30bf4..4961458f5 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2006-03-01  Hector E. Gomez Morales  <hectorgm@ciencias.unam.mx>
+
+	* en/Gdk/PixbufRotation.xml
+	* en/Gdk/Pixbuf.xml
+	* en/Gdk/PixbufSaveFunc.xml: Docs.
+
 2005-08-28  Ben Maurer  <bmaurer@ximian.com>
 
 	* Makefile.am (gtk-sharp-docs.zip gtk-sharp-docs.tree): Use
diff --git a/doc/en/Gdk/Pixbuf.xml b/doc/en/Gdk/Pixbuf.xml
index 47846e811..7f04aad2a 100644
--- a/doc/en/Gdk/Pixbuf.xml
+++ b/doc/en/Gdk/Pixbuf.xml
@@ -334,7 +334,7 @@ public class PixmapComposite
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="src">To be added.</param>
+        <param name="src">Source <see cref="T:Gdk.Image" />.</param>
         <param name="cmap">A colormap (if src does not have one set) (A <see cref="T:Gdk.Colormap" /></param>
         <param name="src_x">Source X coordinate within drawable.</param>
         <param name="src_y">Source Y coordinate within drawable.</param>
@@ -493,7 +493,7 @@ public class PixmapComposite
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="src">To be added.</param>
+        <param name="src">Destination pixbuf, or <see langword="null" /> if a new pixbuf should be created..</param>
         <param name="cmap">A colormap (if src does not have one set) (A <see cref="T:Gdk.Colormap" /></param>
         <param name="src_x">Source X coordinate within drawable.</param>
         <param name="src_y">Source Y coordinate within drawable.</param>
@@ -1804,10 +1804,10 @@ Gdk.Pixbuf pb = new Gdk.Pixbuf(buffer, 10, 10);
         <Parameter Name="angle" Type="Gdk.PixbufRotation" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="angle">a <see cref="T:System.Int32" /></param>
-        <returns>a <see cref="T:Gdk.Pixbuf" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Rotates a pixbuf by a multiple of 90 degrees, and returns the result in a new pixbuf.</summary>
+        <param name="angle">The angle to rotate by.</param>
+        <returns>A <see cref="T:Gdk.Pixbuf" />.</returns>
+        <remarks />
         <since version="Gtk# 2.6" />
       </Docs>
     </Member>
@@ -1821,10 +1821,10 @@ Gdk.Pixbuf pb = new Gdk.Pixbuf(buffer, 10, 10);
         <Parameter Name="horizontal" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="horizontal">a <see cref="T:System.Boolean" /></param>
-        <returns>a <see cref="T:Gdk.Pixbuf" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Flips a pixbuf horizontally or vertically.</summary>
+        <param name="horizontal"><see langword="true" /> to flip horizontally, <see langword="false" /> to flip vertically.</param>
+        <returns>A <see cref="T:Gdk.Pixbuf" />.</returns>
+        <remarks />
         <since version="Gtk# 2.6" />
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/PixbufRotation.xml b/doc/en/Gdk/PixbufRotation.xml
index d9bbe7370..fe0d9f70a 100644
--- a/doc/en/Gdk/PixbufRotation.xml
+++ b/doc/en/Gdk/PixbufRotation.xml
@@ -1,5 +1,5 @@
 <Type Name="PixbufRotation" FullName="Gdk.PixbufRotation">
-  <TypeSignature Language="C#" Value="public enum PixbufRotation" Maintainer="auto" />
+  <TypeSignature Language="C#" Value="public enum PixbufRotation" Maintainer="Hector E. Gomez M" />
   <AssemblyInfo>
     <AssemblyName>gdk-sharp</AssemblyName>
     <AssemblyPublicKey>[00 24 00 00 04 80 00 00 94 00 00 00 06 02 00 00 00 24 00 00 52 53 41 31 00 04 00 00 01 00 01 00 71 EB 6C 55 75 52 9C BF 72 44 F7 A6 EA 05 62 84 F9 EA E0 3B CF F2 CC 13 2C 9C 49 0A B3 09 EA B0 B5 6B CE 44 9D F5 03 D9 C0 A8 1E 52 05 85 CD BE 70 E2 FB 90 43 4B AC 04 FA 62 22 A8 00 98 B7 A1 A7 B3 AF 99 1A 41 23 24 BB 43 25 F6 B8 65 BB 64 EB F6 D1 C2 06 D5 73 2D DF BC 70 A7 38 9E E5 3E 0C 24 6E 32 79 74 1A D0 05 03 E4 98 42 E1 9B F3 7B 19 8B 40 21 26 CB 36 89 C2 EA 64 96 A4 7C B4]</AssemblyPublicKey>
@@ -7,8 +7,8 @@
   </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>
-    <remarks>To be added</remarks>
+    <summary>Possible rotations which can be passed to <see cref="M:Gdk.Pixbuf.RotateSimple" />. To make them easier to use, their numerical values are the actual degrees.</summary>
+    <remarks />
     <since version="Gtk# 2.6" />
   </Docs>
   <Base>
@@ -29,8 +29,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>No rotation.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Counterclockwise">
@@ -42,8 +42,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Rotate by 90 degrees.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Upsidedown">
@@ -55,8 +55,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Rotate by 180 degrees.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Clockwise">
@@ -68,8 +68,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Rotate by 270 degrees.</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/PixbufSaveFunc.xml b/doc/en/Gdk/PixbufSaveFunc.xml
index 16ec3f2a5..b0baf24f7 100644
--- a/doc/en/Gdk/PixbufSaveFunc.xml
+++ b/doc/en/Gdk/PixbufSaveFunc.xml
@@ -1,5 +1,5 @@
 <Type Name="PixbufSaveFunc" FullName="Gdk.PixbufSaveFunc">
-  <TypeSignature Language="C#" Maintainer="auto" Value="public delegate bool PixbufSaveFunc(string buf, ulong count);" />
+  <TypeSignature Language="C#" Maintainer="Hector E. Gomez M." Value="public delegate bool PixbufSaveFunc(string buf, ulong count);" />
   <AssemblyInfo>
     <AssemblyName>gdk-sharp</AssemblyName>
     <AssemblyPublicKey>[00 24 00 00 04 80 00 00 94 00 00 00 06 02 00 00 00 24 00 00 52 53 41 31 00 04 00 00 01 00 01 00 71 EB 6C 55 75 52 9C BF 72 44 F7 A6 EA 05 62 84 F9 EA E0 3B CF F2 CC 13 2C 9C 49 0A B3 09 EA B0 B5 6B CE 44 9D F5 03 D9 C0 A8 1E 52 05 85 CD BE 70 E2 FB 90 43 4B AC 04 FA 62 22 A8 00 98 B7 A1 A7 B3 AF 99 1A 41 23 24 BB 43 25 F6 B8 65 BB 64 EB F6 D1 C2 06 D5 73 2D DF BC 70 A7 38 9E E5 3E 0C 24 6E 32 79 74 1A D0 05 03 E4 98 42 E1 9B F3 7B 19 8B 40 21 26 CB 36 89 C2 EA 64 96 A4 7C B4]</AssemblyPublicKey>
@@ -7,11 +7,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>
-    <param name="buf">To be added.</param>
-    <param name="count">To be added.</param>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
-    <returns>To be added.</returns>
+    <param name="buf">Bytes to be written.</param>
+    <param name="count">Number of bytes in <paramref name="buf" />.</param>
+    <summary>Specifies the type of the method passed to <see cref="M:Gdk.Pixbuf.SaveToCallback" />.</summary>
+    <remarks>
+    	<para>It is called once for each block of bytes that is "written" by <see cref="M:Gdk.Pixbuf.SaveToCallback" />. If successful it should return <see langword="true" />. If an error occurs it should set an error and return <see langword="false" />, in which case <see cref="M:Gdk.Pixbuf.SaveToCallback" /> will fail with the same error.</para>
+    </remarks>
+    <returns><see langword="true" /> if successful, <see langword="false" /> if failed.</returns>
     <since version="Gtk# 2.4" />
   </Docs>
   <Base>