diff --git a/doc/ChangeLog b/doc/ChangeLog
index 7b62814a3..ee6224be4 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,14 @@
+2004-09-25 Shane Landrum <epicene@pobox.com>
+
+	* en/Gdk/Drawable.xml
+	* en/Gdk/Pixbuf.xml
+	* en/Gdk/PixbufAlphaMode.xml
+	* en/Gdk/PixbufAniAnim.xml
+	* en/Gdk/PixbufAniAnimIter.xml
+	* en/Gdk/PixbufAnimation.xml
+	* en/Gdk/PixbufAnimationIter.xml: Docs for pixbufs and animations.
+	A first pass; see FIXME marks for some API that may need adjustment.
+	
 2004-09-23 Mike Kestner <mkestner@ximian.com>
 
 	* en/Gtk/Widget.xml : docs for new OnSetScrollAdjustments VM.
diff --git a/doc/en/Gdk/Drawable.xml b/doc/en/Gdk/Drawable.xml
index dc325dda6..a4682a24a 100644
--- a/doc/en/Gdk/Drawable.xml
+++ b/doc/en/Gdk/Drawable.xml
@@ -39,11 +39,11 @@
         <Parameter Name="npoints" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="points">To be added: an object of type 'Gdk.Point'</param>
-        <param name="npoints">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <summary>Draws a number of points using the given graphics context.</summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/></param>
+        <param name="points">An array of  <see cref="T:Gdk.Point"/> objects.</param>
+        <param name="npoints">A <see cref="T:System.Int32"/></param>
+        <remarks>NOTE: Drawable.custom needs to be fixed to implement this properly.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DrawLayoutWithColors">
@@ -61,14 +61,18 @@
         <Parameter Name="background" Type="Gdk.Color" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
-        <param name="layout">To be added: an object of type 'Pango.Layout'</param>
-        <param name="foreground">To be added: an object of type 'Gdk.Color'</param>
-        <param name="background">To be added: an object of type 'Gdk.Color'</param>
-        <remarks>To be added</remarks>
+        <summary>Render a <see cref="T:Pango.Layout"/> onto the Drawable
+	  object, overriding the layout's normal colors with 
+	  <paramref name="foreground"/> and/or <paramref name="background"/>. 
+	  <paramref name="foreground"/> and <paramref name="background"/> 
+	  need not be allocated.</summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/>, the graphics context to use</param>
+        <param name="x">A <see cref="T:System.Int32"/>, the X position of the left of the layout (in pixels)</param>
+        <param name="y">A <see cref="T:System.Int32"/>, the Y position of the top of the layout (in pixels)</param>
+        <param name="layout">A <see cref="T:Pango.Layout"/>, the layout to render</param>
+        <param name="foreground">A <see cref="T:Gdk.Color"/>, the foreground color</param>
+        <param name="background">A <see cref="T:Gdk.Color"/>, the background color</param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawLayoutLine">
@@ -84,12 +88,13 @@
         <Parameter Name="line" Type="Pango.LayoutLine" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
-        <param name="line">To be added: an object of type 'Pango.LayoutLine'</param>
-        <remarks>To be added</remarks>
+        <summary>Render a <see cref="T:Pango.LayoutLine"/> onto the Drawable
+	  object.</summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/>, the graphics context to use</param>
+        <param name="x">A <see cref="T:System.Int32"/>, the X position of the start of string (in pixels)</param>
+        <param name="y">A <see cref="T:System.Int32"/>, the Y position of the baseline (in pixels)</param>
+        <param name="line">A <see cref="T:Pango.LayoutLine"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawLayoutLineWithColors">
@@ -107,14 +112,18 @@
         <Parameter Name="background" Type="Gdk.Color" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
-        <param name="line">To be added: an object of type 'Pango.LayoutLine'</param>
-        <param name="foreground">To be added: an object of type 'Gdk.Color'</param>
-        <param name="background">To be added: an object of type 'Gdk.Color'</param>
-        <remarks>To be added</remarks>
+        <summary>Render a <see cref="T:Pango.LayoutLine"/> onto the Drawable
+	  object, overriding the layout's normal colors with 
+	  <paramref name="foreground"/> and/or <paramref name="background"/>. 
+	  <paramref name="foreground"/> and <paramref name="background"/> 
+	  need not be allocated.</summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/>, the graphics context to use</param>
+        <param name="x">A <see cref="T:System.Int32"/>, the X position of the start of string (in pixels)</param>
+        <param name="y">A <see cref="T:System.Int32"/>, the Y position of the baseline (in pixels)</param>
+        <param name="layout">A <see cref="T:Pango.LayoutLine"/>, a line of text to render</param>
+        <param name="foreground">A <see cref="T:Gdk.Color"/>, the foreground color</param>
+        <param name="background">A <see cref="T:Gdk.Color"/>, the background color</param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawLayout">
@@ -131,10 +140,10 @@
       </Parameters>
       <Docs>
         <summary>Render a <see cref="T:Pango.Layout" /> onto a <see cref="T:Gdk.Drawable" /></summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
-        <param name="layout">To be added: an object of type 'Pango.Layout'</param>
+        <param name="gc">A <see cref="T:Gdk.GC"/></param>
+        <param name="x">A <see cref="T:System.Int32"/></param>
+        <param name="y">A <see cref="T:System.Int32"/></param>
+        <param name="layout">A <see cref="T:Pango.Layout"/></param>
         <remarks>If you are using Gtk, the usual way to obtain a <see cref="T:Pango.Layout" /> is <see cref="M:Gtk.Widget.CreatePangoLayout()" />.</remarks>
       </Docs>
     </Member>
@@ -149,10 +158,18 @@
         <Parameter Name="height" Type="System.Int32&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="width">To be added: an object of type 'int&amp;'</param>
-        <param name="height">To be added: an object of type 'int&amp;'</param>
-        <remarks>To be added</remarks>
+        <summary>Fills <paramref name="width"/> and <paramref name="height"/> 
+	  with the size of the Drawable. <paramref name="width"/> or 
+	  <paramref name="height"/> can be <see langword="null"/> if you 
+	  only want the other one.
+	</summary>
+        <param name="width">A <see cref="T:System.Int32&amp;"/></param>
+        <param name="height">A <see cref="T:System.Int32&amp;"/></param>
+        <remarks>
+	  On the X11 platform, if this Drawable object is also a <see cref="T:Gdk.Window"/>, the returned
+	  size is the size reported in the most-recently-processed configure
+	  event, rather than the current size on the X server.
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName="DrawSegments">
@@ -167,11 +184,11 @@
         <Parameter Name="nsegs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="segs">To be added: an object of type 'Gdk.Segment'</param>
-        <param name="nsegs">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <summary>Draws a number of unconnected lines.</summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/></param>
+        <param name="segs">A <see cref="T:Gdk.Segment"/>, a list of segments to draw.</param>
+        <param name="nsegs">A <see cref="T:System.Int32"/>, the number of segments.</param>
+        <remarks>TODO: Drawable.custom needs to be edited to make segs an array of Gdk.Segment objects.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DrawGlyphs">
@@ -188,13 +205,21 @@
         <Parameter Name="glyphs" Type="Pango.GlyphString" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="font">To be added: an object of type 'Pango.Font'</param>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
-        <param name="glyphs">To be added: an object of type 'Pango.GlyphString'</param>
-        <remarks>To be added</remarks>
+        <summary>
+	  <p>This is a low-level function; 99% of text rendering should be done
+	  using <see cref="M:Gdk.Drawable.DrawLayout"/> instead.</p>
+	  <p>A glyph is a character in a font. This function draws a sequence of
+	    glyphs.  To obtain a sequence of glyphs you have to understand a
+	    lot about internationalized text handling, which you don't want to
+	    understand; thus, use <see cref="M:Gdk.Drawable.DrawLayout"/> instead of this function,
+	    <see cref="M:Gdk.Drawable.DrawLayout"/> handles the details.</p>
+	  </summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/></param>
+        <param name="font">A <see cref="T:Pango.Font"/></param>
+        <param name="x">A <see cref="T:System.Int32"/></param>
+        <param name="y">A <see cref="T:System.Int32"/></param>
+        <param name="glyphs">A <see cref="T:Pango.GlyphString"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GetImage">
@@ -210,13 +235,54 @@
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'Gdk.Image'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+	  <p>
+	    A <see cref="T:Gdk.Image"/> stores client-side image data (pixels). In contrast,
+	    <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>
+	    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; 
+	    therefore, in
+	    most cases you should use <see cref="M:Gdk.Pixbuf.GetFromDrawable"/>
+	    instead of 
+	    this lower-level function. A <see cref="T:Gdk.Pixbuf"/> contains 
+	    image data in a canonicalized RGB format, rather than a 
+	    display-dependent format. Of course, there's a convenience vs. 
+	    speed tradeoff here, so you'll want to think about what makes 
+	    sense for your application.
+	</p>
+      </summary>
+        <param name="x">A <see cref="T:System.Int32"/>, X coordinate of the upper left corner of the region to get as a drawable</param>
+        <param name="y">A <see cref="T:System.Int32"/>, Y coordinate of the upper left corner of the region to get as a drawable.</param>
+        <param name="width">A <see cref="T:System.Int32"/>, width of the rectangle</param>
+        <param name="height">A <see cref="T:System.Int32"/>, height of the rectangle.</param>
+        <returns>A <see cref="T:Gdk.Image"/> containing the contents of this Drawable object.</returns>
+        <remarks>
+	  <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>
+	    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>
+	    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>
+	    If the source drawable is a #GdkWindow and partially offscreen
+	    or obscured, then the obscured portions of the returned image
+	    will contain undefined data.
+	  </p>
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName="DrawDrawable">
@@ -236,16 +302,33 @@
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="src">To be added: an object of type 'Gdk.Drawable'</param>
-        <param name="xsrc">To be added: an object of type 'int'</param>
-        <param name="ysrc">To be added: an object of type 'int'</param>
-        <param name="xdest">To be added: an object of type 'int'</param>
-        <param name="ydest">To be added: an object of type 'int'</param>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <summary>
+	    Copies the <paramref name="width"/>x<paramref name="height"/> region of <paramref name="src"/> at coordinates (<paramref name="xsrc"/>,
+	    <paramref name="ysrc"/>) to coordinates (<paramref name="xdest"/>, <paramref name="ydest"/>) in <paramref name="drawable"/>.
+	    <paramref name="width"/> and/or <paramref name="height"/> may be given as -1, in which case the entire
+	    <paramref name="src"/> drawable will be copied.
+	    Most fields in <paramref name="gc"/> are not used for this operation, but notably the
+	clip mask or clip region will be honored.
+	</summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/></param>
+        <param name="src">A <see cref="T:Gdk.Drawable"/>, the source Drawable. </param>
+        <param name="xsrc">A <see cref="T:System.Int32"/></param>
+        <param name="ysrc">A <see cref="T:System.Int32"/></param>
+        <param name="xdest">A <see cref="T:System.Int32"/></param>
+        <param name="ydest">A <see cref="T:System.Int32"/></param>
+        <param name="width">A <see cref="T:System.Int32"/></param>
+        <param name="height">A <see cref="T:System.Int32"/></param>
+        <remarks>
+	  The source and destination drawables must have the same visual and
+	  colormap, or errors will result. (On X11, failure to match
+	  visual/colormap results in a BadMatch error from the X server.)
+	  A common cause of this problem is an attempt to draw a bitmap to
+	  a color drawable. The way to draw a bitmap is to set the
+	  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>
       </Docs>
     </Member>
     <Member MemberName="DrawImage">
@@ -266,14 +349,14 @@
       </Parameters>
       <Docs>
         <summary>Draws a <see cref="T:Gdk.Image" /> onto a drawable.</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="image">To be added: an object of type 'Gdk.Image'</param>
-        <param name="xsrc">To be added: an object of type 'int'</param>
-        <param name="ysrc">To be added: an object of type 'int'</param>
-        <param name="xdest">To be added: an object of type 'int'</param>
-        <param name="ydest">To be added: an object of type 'int'</param>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
+        <param name="gc">A <see cref="T:Gdk.GC"/></param>
+        <param name="image">A <see cref="T:Gdk.Image"/></param>
+        <param name="xsrc">A <see cref="T:System.Int32"/></param>
+        <param name="ysrc">A <see cref="T:System.Int32"/></param>
+        <param name="xdest">A <see cref="T:System.Int32"/></param>
+        <param name="ydest">A <see cref="T:System.Int32"/></param>
+        <param name="width">A <see cref="T:System.Int32"/></param>
+        <param name="height">A <see cref="T:System.Int32"/></param>
         <remarks>The depth of the <see cref="T:Gdk.Image" /> must match the depth of the <see cref="T:Gdk.Drawable" />.</remarks>
       </Docs>
     </Member>
@@ -289,11 +372,11 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gc">To be added: an object of type 'Gdk.GC'</param>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <summary>Draws a point at (<paramref name="x"/>,<paramref name="y"/>).</summary>
+        <param name="gc">A <see cref="T:Gdk.GC"/></param>
+        <param name="x">A <see cref="T:System.Int32"/></param>
+        <param name="y">A <see cref="T:System.Int32"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -333,10 +416,17 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Colormap'</param>
-        <returns>To be added: an object of type 'Gdk.Colormap'</returns>
-        <remarks>To be added</remarks>
+        <summary>The color map for this Drawable. You only need to set
+	  the color map if the drawable-creating function did not have a
+	  way to determine the colormap, and you then use drawable operations
+	  that require a colormap. The colormap for all drawables and
+	  graphics contexts you intend to use together should match. i.e.
+	  when using a #GdkGC to draw to a drawable, or copying one drawable
+	  to another, the colormaps should match.
+	</summary>
+        <param name="value">A <see cref="T:Gdk.Colormap"/></param>
+        <returns>A <see cref="T:Gdk.Colormap"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="VisibleRegion">
@@ -347,8 +437,8 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Region'</returns>
-        <remarks>To be added</remarks>
+        <returns>A <see cref="T:Gdk.Region"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ClipRegion">
@@ -359,8 +449,8 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Region'</returns>
-        <remarks>To be added</remarks>
+        <returns>A <see cref="T:Gdk.Region"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Visual">
@@ -371,8 +461,8 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Visual'</returns>
-        <remarks>To be added</remarks>
+        <returns>A <see cref="T:Gdk.Visual"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Depth">
@@ -383,8 +473,8 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'int'</returns>
-        <remarks>To be added</remarks>
+        <returns>A <see cref="T:System.Int32"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Screen">
@@ -396,7 +486,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:Gdk.Screen" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Display">
@@ -408,7 +498,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:Gdk.Display" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawLines">
@@ -425,7 +515,7 @@
         <summary>To be added</summary>
         <param name="gc">a <see cref="T:Gdk.GC" /></param>
         <param name="points">a <see cref="T:Gdk.Point[]" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawPolygon">
@@ -486,7 +576,7 @@
         <param name="y1_">a <see cref="T:System.Int32" /></param>
         <param name="x2_">a <see cref="T:System.Int32" /></param>
         <param name="y2_">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawArc">
@@ -515,7 +605,7 @@
         <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>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawPixbuf">
@@ -550,7 +640,7 @@
         <param name="dither">a <see cref="T:Gdk.RgbDither" /></param>
         <param name="x_dither">a <see cref="T:System.Int32" /></param>
         <param name="y_dither">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawRectangle">
@@ -613,7 +703,7 @@
       <Docs>
         <summary>This is a constructor used by derivative types of Drawable. This is not typically used by C# code.</summary>
         <returns>a <see cref="T:Gdk.Drawable" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawRgbImage">
@@ -642,7 +732,7 @@
         <param name="dith">a <see cref="T:System.Int32" /></param>
         <param name="rgb_buf">a <see cref="T:System.Byte" /></param>
         <param name="rowstride">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawRgb32ImageDithalign">
@@ -675,7 +765,7 @@
         <param name="rowstride">a <see cref="T:System.Int32" /></param>
         <param name="xdith">a <see cref="T:System.Int32" /></param>
         <param name="ydith">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawIndexedImage">
@@ -706,7 +796,7 @@
         <param name="buf">a <see cref="T:System.Byte" /></param>
         <param name="rowstride">a <see cref="T:System.Int32" /></param>
         <param name="cmap">a <see cref="T:Gdk.RgbCmap" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawRgb32Image">
@@ -735,7 +825,7 @@
         <param name="dith">a <see cref="T:System.Int32" /></param>
         <param name="buf">a <see cref="T:System.Byte" /></param>
         <param name="rowstride">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawGrayImage">
@@ -764,7 +854,7 @@
         <param name="dith">a <see cref="T:System.Int32" /></param>
         <param name="buf">a <see cref="T:System.Byte" /></param>
         <param name="rowstride">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawRgbImageDithalign">
@@ -797,7 +887,7 @@
         <param name="rowstride">a <see cref="T:System.Int32" /></param>
         <param name="xdith">a <see cref="T:System.Int32" /></param>
         <param name="ydith">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawPolygon">
@@ -821,4 +911,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gdk/Pixbuf.xml b/doc/en/Gdk/Pixbuf.xml
index 5a091a5e4..c85016216 100644
--- a/doc/en/Gdk/Pixbuf.xml
+++ b/doc/en/Gdk/Pixbuf.xml
@@ -817,20 +817,26 @@
         <Parameter Name="y_dither" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="drawable">To be added: an object of type 'Gdk.Drawable'</param>
-        <param name="src_x">To be added: an object of type 'int'</param>
-        <param name="src_y">To be added: an object of type 'int'</param>
-        <param name="dest_x">To be added: an object of type 'int'</param>
-        <param name="dest_y">To be added: an object of type 'int'</param>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
-        <param name="alpha_mode">To be added: an object of type 'Gdk.PixbufAlphaMode'</param>
-        <param name="alpha_threshold">To be added: an object of type 'int'</param>
-        <param name="dither">To be added: an object of type 'Gdk.RgbDither'</param>
-        <param name="x_dither">To be added: an object of type 'int'</param>
-        <param name="y_dither">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <summary>Obsolete; do not use. Use <see cref="M:Gdk.Drawable.DrawPixbuf"/> instead.</summary>
+        <param name="drawable">A <see cref="T:Gdk.Drawable"/></param>
+        <param name="src_x">A <see cref="T:System.Int32"/></param>
+        <param name="src_y">A <see cref="T:System.Int32"/></param>
+        <param name="dest_x">A <see cref="T:System.Int32"/></param>
+        <param name="dest_y">A <see cref="T:System.Int32"/></param>
+        <param name="width">A <see cref="T:System.Int32"/></param>
+        <param name="height">A <see cref="T:System.Int32"/></param>
+        <param name="alpha_mode">A <see cref="T:Gdk.PixbufAlphaMode"/></param>
+        <param name="alpha_threshold">A <see cref="T:System.Int32"/></param>
+        <param name="dither">A <see cref="T:Gdk.RgbDither"/></param>
+        <param name="x_dither">A <see cref="T:System.Int32"/></param>
+        <param name="y_dither">A <see cref="T:System.Int32"/></param>
+        <remarks>Renders a rectangular portion of a pixbuf to a drawable.  The destination
+	  drawable must have a colormap. All windows have a colormap, however, pixmaps
+	  only have colormap by default if they were created with a non-NULL window argument.
+	  Otherwise a colormap must be set on them with <see cref="P:Gdk.Drawable.Colormap"/>.
+	  On older X servers, rendering pixbufs with an alpha channel involves round trips
+	  to the X server, and may be somewhat slow.
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -1076,17 +1082,17 @@
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="src">To be added: an object of type 'Gdk.Drawable'</param>
-        <param name="cmap">To be added: an object of type 'Gdk.Colormap'</param>
-        <param name="src_x">To be added: an object of type 'int'</param>
-        <param name="src_y">To be added: an object of type 'int'</param>
-        <param name="dest_x">To be added: an object of type 'int'</param>
-        <param name="dest_y">To be added: an object of type 'int'</param>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'Gdk.Pixbuf'</returns>
-        <remarks>To be added</remarks>
+        <summary>Generates a new Pixbuf object from a <see cref="T:Gdk.Drawable"/>.</summary>
+        <param name="src">A <see cref="T:Gdk.Drawable"/></param>
+        <param name="cmap">A <see cref="T:Gdk.Colormap"/></param>
+        <param name="src_x">A <see cref="T:System.Int32"/></param>
+        <param name="src_y">A <see cref="T:System.Int32"/></param>
+        <param name="dest_x">A <see cref="T:System.Int32"/></param>
+        <param name="dest_y">A <see cref="T:System.Int32"/></param>
+        <param name="width">A <see cref="T:System.Int32"/></param>
+        <param name="height">A <see cref="T:System.Int32"/></param>
+        <returns>A <see cref="T:Gdk.Pixbuf"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1103,16 +1109,16 @@
         <Parameter Name="destroy_fn" Type="Gdk.PixbufDestroyNotify" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="data">To be added: an object of type 'byte []'</param>
-        <param name="has_alpha">To be added: an object of type 'bool'</param>
-        <param name="bits_per_sample">To be added: an object of type 'int'</param>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
-        <param name="rowstride">To be added: an object of type 'int'</param>
-        <param name="destroy_fn">To be added: an object of type 'Gdk.PixbufDestroyNotify'</param>
-        <returns>To be added: an object of type 'Gdk.Pixbuf'</returns>
-        <remarks>To be added</remarks>
+        <summary>Public constructor.</summary>
+        <param name="data">A <see cref="T:byte []"/>, the raw data</param>
+        <param name="has_alpha">A <see cref="T:System.Boolean"/>, true if this pixbuf has an alpha layer.</param>
+        <param name="bits_per_sample">A <see cref="T:System.Int32"/></param>
+        <param name="width">A <see cref="T:System.Int32"/>, image width</param>
+        <param name="height">A <see cref="T:System.Int32"/>, image height</param>
+        <param name="rowstride">A <see cref="T:System.Int32"/></param>
+        <param name="destroy_fn">A <see cref="T:Gdk.PixbufDestroyNotify"/></param>
+        <returns>A <see cref="T:Gdk.Pixbuf"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1125,10 +1131,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="data">To be added: an object of type 'byte []'</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>
+        <param name="data">A <see cref="T:System.Byte []"/></param>
+        <param name="copy_pixels">A <see cref="T:System.Boolean"/></param>
+        <returns>A <see cref="T:Gdk.Pixbuf"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1159,7 +1165,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1175,7 +1181,7 @@
         <param name="assembly">a <see cref="T:System.Reflection.Assembly" /></param>
         <param name="resource">a <see cref="T:System.String" /></param>
         <returns>a <see cref="T:Gdk.Pixbuf" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="LoadFromResource">
@@ -1191,7 +1197,7 @@
         <summary>To be added</summary>
         <param name="resource">a <see cref="T:System.String" /></param>
         <returns>a <see cref="T:Gdk.Pixbuf" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1202,10 +1208,10 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Makes a new Pixbuf object from a <see cref="T:System.IO.Stream"/>.</summary>
         <param name="stream">a <see cref="T:System.IO.Stream" /></param>
         <returns>a <see cref="T:Gdk.Pixbuf" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1223,7 +1229,10 @@
         <Parameter Name="destroy_fn" Type="Gdk.PixbufDestroyNotify" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Public constructor; creates a new <see cref="T:Gdk.Pixbuf"/>
+	  and allocates a buffer for it. Note that the buffer is not cleared;
+	  you will have to fill it completely yourself.
+	</summary>
         <param name="data">a <see cref="T:System.Byte[]" /></param>
         <param name="colorspace">a <see cref="T:Gdk.Colorspace" /></param>
         <param name="has_alpha">a <see cref="T:System.Boolean" /></param>
@@ -1232,8 +1241,10 @@
         <param name="height">a <see cref="T:System.Int32" /></param>
         <param name="rowstride">a <see cref="T:System.Int32" /></param>
         <param name="destroy_fn">a <see cref="T:Gdk.PixbufDestroyNotify" /></param>
-        <returns>a <see cref="T:Gdk.Pixbuf" /></returns>
-        <remarks>To be added</remarks>
+        <returns>a <see cref="T:Gdk.Pixbuf" /> with a reference count of 1, or 
+	  null if not enough memory could be allocated for the image buffer.
+	</returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1262,10 +1273,10 @@
         <Parameter Name="data" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Public constructor.</summary>
         <param name="data">a <see cref="T:System.String[]" /></param>
         <returns>a <see cref="T:Gdk.Pixbuf" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -1305,7 +1316,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:Gdk.PixbufFormat[]" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Pixels">
@@ -1318,7 +1329,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.IntPtr" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Savev">
@@ -1339,8 +1350,8 @@
         <param name="type">The file type to save (one of "ani", "bmp", "gif", "ico", "jpeg", "pcx", "png", "pnm", "ras", "tga", "tiff" "wbmp", "xpm" or "xbm")</param>
         <param name="option_keys">Options that are passed to the save module.</param>
         <param name="option_values">Values for each key</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <returns>A <see cref="T:System.Boolean"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Save">
@@ -1358,7 +1369,7 @@
         <param name="filename">a <see cref="T:System.String" /></param>
         <param name="type">a <see cref="T:System.String" /></param>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="RenderThresholdAlpha">
@@ -1377,7 +1388,7 @@
       </Parameters>
       <Docs>
         <summary>Render pixbuf alpha channel as a bi-level clip mask to a <see cref="T:Gdk.Bitmap" /></summary>
-        <param name="bitmap">The destination object of type 'Gdk.Bitmap'</param>
+        <param name="bitmap">The destination object of type "Gdk.Bitmap"/></param>
         <param name="src_x">Source X coordinate.</param>
         <param name="src_y">Source Y coordinate.</param>
         <param name="dest_x">Destination X coordinate.
@@ -1385,7 +1396,7 @@
         <param name="dest_y">Destination Y coordinate.</param>
         <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 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>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="RenderPixmapAndMask">
@@ -1400,11 +1411,27 @@
         <Parameter Name="alpha_threshold" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>
+	  Creates a pixmap and a mask bitmap which are returned in the 
+	  <paramref name="pixmap_return"/> and <paramref name="mask_return"/> 
+	  arguments, respectively, and renders a pixbuf and its
+	  corresponding thresholded alpha mask to them.  This is merely a convenience
+	  function; applications that need to render pixbufs with dither offsets or to
+	  given drawables should use <see cref="M:Gdk.Pixbuf.RenderToDrawableAlpha"/>
+	  or <see cref="M:Gdk.Pixbuf.RenderToDrawable"/> and
+	  <see cref="M:Gdk.Pixbuf.RenderThresholdAlpha"/>.
+	</summary>
         <param name="pixmap_return">a <see cref="T:Gdk.Pixmap" /></param>
         <param name="mask_return">a <see cref="T:Gdk.Bitmap" /></param>
-        <param name="alpha_threshold">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <param name="alpha_threshold">a <see cref="T:System.Int32" />, threshold value for opacity.</param>
+        <remarks>
+	  The pixmap that is created is created for the colormap returned
+	  by <see cref="M:Gdk.Rgb.GetColormap"/>. You normally will want to instead use
+	  the actual colormap for a widget, and use
+	  <see cref="M:Gdk.Pixbuf.RenderPixmapAndMaskForColormap"/>,
+	  If the pixbuf does not have an alpha channel, then *<paramref name="mask_return"/> will be set
+	  to <see langword="null"/>.
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName="RenderPixmapAndMaskForColormap">
@@ -1420,12 +1447,28 @@
         <Parameter Name="alpha_threshold" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>
+	    Creates a pixmap and a mask bitmap which are returned in the 
+	    <paramref name="pixmap_return"/> and <paramref name="mask_return"/> 
+	    arguments, respectively, and renders a pixbuf and its
+	    corresponding thresholded alpha mask to them.  
+	    This is merely a convenience
+	    function; applications that need to render pixbufs with dither offsets or to
+	    given drawables should use <see cref="M:Gdk.Pixbuf.RenderToDrawableAlpha"/>
+	    or <see cref="M:Gdk.Pixbuf.RenderToDrawable"/> and
+	    <see cref="M:Gdk.Pixbuf.RenderThresholdAlpha"/>.
+	</summary>
         <param name="colormap">a <see cref="T:Gdk.Colormap" /></param>
         <param name="pixmap_return">a <see cref="T:Gdk.Pixmap" /></param>
         <param name="mask_return">a <see cref="T:Gdk.Bitmap" /></param>
         <param name="alpha_threshold">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks>
+	    The pixmap that is created uses the <see cref="T:Gdk.Colormap"/> specified by <paramref name="colormap"/>.
+	    This colormap must match the colormap of the window where the pixmap
+	    will eventually be used or an error will result.
+	    If the pixbuf does not have an alpha channel, then *<paramref name="mask_return"/> will be set
+	    to <see langword="null"/>.
+	  </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/PixbufAlphaMode.xml b/doc/en/Gdk/PixbufAlphaMode.xml
index 91995c8d5..9dd5597d1 100644
--- a/doc/en/Gdk/PixbufAlphaMode.xml
+++ b/doc/en/Gdk/PixbufAlphaMode.xml
@@ -10,8 +10,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>Do not use.</summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -69,4 +69,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gdk/PixbufAniAnim.xml b/doc/en/Gdk/PixbufAniAnim.xml
index 2870b962a..21a0461be 100644
--- a/doc/en/Gdk/PixbufAniAnim.xml
+++ b/doc/en/Gdk/PixbufAniAnim.xml
@@ -10,8 +10,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>Represents an ANI format animation internally. Do not use.</summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>Gdk.PixbufAnimation</BaseTypeName>
@@ -35,7 +35,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -46,10 +46,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
+        <summary>Constructor for use by internal code. Do not use.</summary>
+        <param name="raw">a <see cref="T:System.IntPtr" />, pointer to underlying C data</param>
         <returns>a <see cref="T:Gdk.PixbufAniAnim" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -85,10 +85,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Protected constructor.</summary>
         <returns>a <see cref="T:Gdk.PixbufAniAnim" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gdk/PixbufAniAnimIter.xml b/doc/en/Gdk/PixbufAniAnimIter.xml
index 24da2d486..8f2dd18ad 100644
--- a/doc/en/Gdk/PixbufAniAnimIter.xml
+++ b/doc/en/Gdk/PixbufAniAnimIter.xml
@@ -10,8 +10,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>Iterator for pointing to a particular frame of an ANI animation. Mostly internal; not for general developer use.</summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>Gdk.PixbufAnimationIter</BaseTypeName>
@@ -35,7 +35,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -46,10 +46,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
+        <summary>Constructor for internal use.</summary>
+        <param name="raw">a <see cref="T:System.IntPtr" />, pointer to the underlying C object</param>
         <returns>a <see cref="T:Gdk.PixbufAniAnimIter" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -85,10 +85,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Protected constructor.</summary>
         <returns>a <see cref="T:Gdk.PixbufAniAnimIter" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gdk/PixbufAnimation.xml b/doc/en/Gdk/PixbufAnimation.xml
index 705818a67..a0ee5e9b9 100644
--- a/doc/en/Gdk/PixbufAnimation.xml
+++ b/doc/en/Gdk/PixbufAnimation.xml
@@ -10,8 +10,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>A base class for animations that are rendered using <see cref="T:Gdk.Pixbuf"/></summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Object</BaseTypeName>
@@ -36,10 +36,51 @@
         <Parameter Name="start_time" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="start_time">To be added: an object of type 'IntPtr'</param>
-        <returns>To be added: an object of type 'Gdk.PixbufAnimationIter'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+	  Get an iterator for displaying an animation. The iterator provides
+	  the frames that should be displayed at a given time.
+	  It should be freed after use with g_object_unref().
+	</summary>
+        <param name="start_time">A <see cref="T:IntPtr"/></param>
+        <returns>A <see cref="T:Gdk.PixbufAnimationIter"/> to move over the animation</returns>
+        <remarks>
+	  <p>
+	    <paramref name="start_time"/> would normally come from 
+	    g_get_current_time() (FIXME: this function isn't bound into C#; 
+	    this needs a look), and
+	    marks the beginning of animation playback. After creating an
+	  iterator, you should immediately display the pixbuf returned by
+	    <see cref="P:Gdk.PixbufAnimationIter.Pixbuf"/>. Then, you should install a
+	    timeout (with g_timeout_add() (FIXME)) or by some other mechanism ensure
+	    that you'll update the image after
+	    <see cref="P:Gdk.PixbufAnimation.DelayTime"/> milliseconds. Each time
+	    the image is updated, you should reinstall the timeout with the new,
+	    possibly-changed delay time.
+	  </p><p>
+	  As a shortcut, if <paramref name="start_time"/> is <see langword="null"/>, the result of
+	  g_get_current_time() will be used automatically.
+	    </p><p>
+	  To update the image (i.e. possibly change the result of
+	  gdk_pixbuf_animation_iter_get_pixbuf() to a new frame of the animation),
+	  call gdk_pixbuf_animation_iter_advance().
+	    </p><p>
+
+	  If you're using <see cref="T:Gdk.PixbufLoader"/>, in addition 
+	  to updating the image
+	  after the delay time, you should also update it whenever you
+	  receive the area_updated signal and
+	  <see cref="M:Gdk.PixbufAnimationIter.OnCurrentlyLoadingFrame"/> returns
+	  true. In this case, the frame currently being fed into the loader
+	  has received new data, so needs to be refreshed. The delay time for
+	  a frame may also be modified after an 
+	  <see cref="E:Gdk.PixbufLoader.AreaUpdated"/> signal, for
+	  example if the delay time for a frame is encoded in the data after
+	  the frame itself. So your timeout should be reinstalled after any
+	  <see cref="E:Gdk.PixbufLoader.AreaUpdated"/> signal.
+	    </p><p>
+	    A delay time of -1 is possible, indicating "infinite."
+	  </p>
+	  </remarks>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -78,11 +119,19 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="filename">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Gdk.PixbufAnimation'</returns>
-        <remarks>To be added</remarks>
-      </Docs>
+        <summary>Public constructor; creates a new animation by 
+	  loading it from a file.  The file format is
+	  detected automatically.  If the file's format does not support 
+	  multi-frame images, then an animation with a single frame will 
+	  be created. Possible errors are in the 
+	  <see cref="T:Gdk.PixbufError"/> and <see cref="T:Gdk.Error"/> domains.
+	</summary>
+        <param name="filename">A <see cref="T:System.String"/>, the filename to load into this object.</param>
+        <returns>A <see cref="T:Gdk.PixbufAnimation"/> with a reference count 
+	  of 1, or <see langword="null"/> if an error occurred.
+	</returns>
+        <remarks/>
+       </Docs>
     </Member>
     <Member MemberName="Width">
       <MemberSignature Language="C#" Value="public int Width { get; };" />
@@ -91,9 +140,9 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'int'</returns>
-        <remarks>To be added</remarks>
+        <summary>The width of the animation.</summary>
+        <returns>A <see cref="T:System.Int32"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="StaticImage">
@@ -103,9 +152,10 @@
         <ReturnType>Gdk.Pixbuf</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Pixbuf'</returns>
-        <remarks>To be added</remarks>
+        <summary>Gets the image if this animation is actually a static, 
+	  unanimaged file.</summary>
+        <returns>A <see cref="T:Gdk.Pixbuf"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Height">
@@ -115,9 +165,9 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'int'</returns>
-        <remarks>To be added</remarks>
+        <summary>The height of the animation.</summary>
+        <returns>A <see cref="T:System.Int32"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="IsStaticImage">
@@ -128,9 +178,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>
+	  If you load a file with <see cref="M:Gdk.PixbufAnimation.ctor"/> 
+	  and it turns out to be a plain, unanimated image, then this 
+	  function will return
+	  TRUE. Use <see cref="P:Gdk.PixbufAnimation.StaticImage"/> to
+	  retrieve the image.
+	</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -161,4 +217,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gdk/PixbufAnimationIter.xml b/doc/en/Gdk/PixbufAnimationIter.xml
index d65f11f77..2b1f89f19 100644
--- a/doc/en/Gdk/PixbufAnimationIter.xml
+++ b/doc/en/Gdk/PixbufAnimationIter.xml
@@ -10,8 +10,10 @@
   </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>
+      An iterator used by <see cref="T:Gdk.PixbufAnimation"/> for displaying animations by stepping through frames.
+    </summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Object</BaseTypeName>
@@ -36,10 +38,34 @@
         <Parameter Name="current_time" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="current_time">To be added: an object of type 'IntPtr'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+	  Possibly advances an animation to a new frame. Chooses the frame based
+	  on the start time passed to 
+	  <see cref="M:Gdk.PixbufAnimation.GetIter"/>.
+	</summary>
+        <param name="current_time">A <see cref="T:IntPtr"/>, pointer to a C time object</param>
+        <returns>A <see cref="T:System.Boolean"/>, true if the image may need updating.</returns>
+        <remarks>
+	  <p>
+	    <paramref name="current_time"/> would normally come from g_get_current_time(), and
+	    must be greater than or equal to the time passed to
+	    <see cref="M:Gdk.PixbufAnimation.GetIter"/>, and must increase or remain
+	    unchanged each time this method is
+	    called. That is, you can't go backward in time; animations only
+	    play forward.
+	  </p><p>
+	    As a shortcut, pass <see langword="null"/> for the current time and g_get_current_time()
+	    will be invoked on your behalf. So you only need to explicitly pass
+	    <paramref name="current_time"/> if you're doing something odd like playing the animation
+	    at double speed.
+	  </p><p>
+	    If this method returns false, there's no need to update the animation
+	    display, assuming the display had been rendered prior to advancing;
+	    if true, you need to call 
+	    <see cref="P:Gdk.PixbufAnimationIter.Pixbuf"/> and update the
+	    display with the new pixbuf.
+	  </p>
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName="OnCurrentlyLoadingFrame">
@@ -50,9 +76,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+	  Used to determine how to respond to the 
+	  <see cref="E:Gdk.PixbufLoader.AreaUpdated"/> signal
+	  when loading an animation. 
+	  <see cref="E:Gdk.PixbufLoader.AreaUpdated"/> is emitted
+	  for an area of the frame currently streaming into the loader. So if
+	  you're on the currently loading frame, you need to redraw the 
+	  screen for the updated area.
+	</summary>
+        <returns>A <see cref="T:System.Boolean"/>, true if the frame we're on is partially loaded, or the last frame</returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -90,9 +124,16 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'int'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+	  Gets the number of milliseconds the current pixbuf should be displayed,
+	  or -1 if the current pixbuf should be displayed forever. 
+	</summary>
+        <returns>A <see cref="T:System.Int32"/>,  delay time in milliseconds (thousandths of a second)</returns>
+        <remarks>
+	  g_timeout_add() (FIXME: this doesn't seem to be bound)
+	  conveniently takes a timeout in milliseconds, so you can use a timeout
+	  to schedule the next update.
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName="Pixbuf">
@@ -102,9 +143,20 @@
         <ReturnType>Gdk.Pixbuf</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Pixbuf'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+	  Gets the current pixbuf which should be displayed; the pixbuf will
+	  be the same size as the animation itself
+	  (<see cref="M:Gdk.PixbufAnimation.GetWidth"/>, <see cref="M:Gdk.PixbufAnimation.GetHeight"/>). This pixbuf should be displayed
+	  for <see cref="P:Gdk.PixbufAnimation.DelayTime"/> milliseconds. The caller
+	  of this function does not own a reference to the returned pixbuf;
+	  the returned pixbuf will become invalid when the iterator advances
+	  to the next frame, which may happen anytime you call
+	  <see cref="M:Gdk.PixbufAnimationIter.Advance"/>. Copy the pixbuf to keep it
+	  (don't just add a reference), as it may get recycled as you advance
+	  the iterator.
+	</summary>
+        <returns>A <see cref="T:Gdk.Pixbuf"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -140,10 +192,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Protected constructor.</summary>
         <returns>a <see cref="T:Gdk.PixbufAnimationIter" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>