diff --git a/doc/ChangeLog b/doc/ChangeLog
index 199a386bc..4177af65a 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2004-05-31  Mike Kestner  <mkestner@ximian.com>
+
+	* en/Gdk/Rectangle.xml : docs for newly changed Isect and Union.
+
 2004-05-28  Mike Kestner  <mkestner@ximian.com>
 
 	* Makefile.am : fix disthook
diff --git a/doc/en/Gdk/Rectangle.xml b/doc/en/Gdk/Rectangle.xml
index 1e195d506..16adda32a 100644
--- a/doc/en/Gdk/Rectangle.xml
+++ b/doc/en/Gdk/Rectangle.xml
@@ -47,41 +47,6 @@
         <remarks>To be added</remarks>
       </Docs>
     </Member>
-    <Member MemberName="Intersect">
-      <MemberSignature Language="C#" Value="public bool Intersect (Gdk.Rectangle src2, Gdk.Rectangle dest);" />
-      <MemberType>Method</MemberType>
-      <ReturnValue>
-        <ReturnType>System.Boolean</ReturnType>
-      </ReturnValue>
-      <Parameters>
-        <Parameter Name="src2" Type="Gdk.Rectangle" />
-        <Parameter Name="dest" Type="Gdk.Rectangle" />
-      </Parameters>
-      <Docs>
-        <summary>To be added</summary>
-        <param name="src2">To be added: an object of type 'Gdk.Rectangle'</param>
-        <param name="dest">To be added: an object of type 'Gdk.Rectangle'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
-      </Docs>
-    </Member>
-    <Member MemberName="Union">
-      <MemberSignature Language="C#" Value="public void Union (Gdk.Rectangle src2, Gdk.Rectangle dest);" />
-      <MemberType>Method</MemberType>
-      <ReturnValue>
-        <ReturnType>System.Void</ReturnType>
-      </ReturnValue>
-      <Parameters>
-        <Parameter Name="src2" Type="Gdk.Rectangle" />
-        <Parameter Name="dest" Type="Gdk.Rectangle" />
-      </Parameters>
-      <Docs>
-        <summary>To be added</summary>
-        <param name="src2">To be added: an object of type 'Gdk.Rectangle'</param>
-        <param name="dest">To be added: an object of type 'Gdk.Rectangle'</param>
-        <remarks>To be added</remarks>
-      </Docs>
-    </Member>
     <Member MemberName=".ctor">
       <MemberSignature Language="C#" Value="public Rectangle (int x, int y, int width, int height);" />
       <MemberType>Constructor</MemberType>
@@ -180,5 +145,39 @@
         <remarks>To be added</remarks>
       </Docs>
     </Member>
+    <Member MemberName="Union">
+      <MemberSignature Language="C#" Value="public Gdk.Rectangle Union (Gdk.Rectangle src2);" />
+      <MemberType>Method</MemberType>
+      <ReturnValue>
+        <ReturnType>Gdk.Rectangle</ReturnType>
+      </ReturnValue>
+      <Parameters>
+        <Parameter Name="src2" Type="Gdk.Rectangle" />
+      </Parameters>
+      <Docs>
+        <summary>Obtains the union of a this <see cref="T:Gdk.Rectangle" /> and another.</summary>
+        <param name="src2">a <see cref="T:Gdk.Rectangle" /></param>
+        <returns>a <see cref="T:Gdk.Rectangle" /> representing the union of the two <see cref="T:Gdk.Rectangle" /> objects.</returns>
+        <remarks>The result is the smallest <see cref="T:Gdk.Rectangle" /> that contains both <see cref="T:Gdk.Rectangle" /> objects within its boundaries.</remarks>
+      </Docs>
+    </Member>
+    <Member MemberName="Intersect">
+      <MemberSignature Language="C#" Value="public bool Intersect (Gdk.Rectangle src2, out Gdk.Rectangle dest);" />
+      <MemberType>Method</MemberType>
+      <ReturnValue>
+        <ReturnType>System.Boolean</ReturnType>
+      </ReturnValue>
+      <Parameters>
+        <Parameter Name="src2" Type="Gdk.Rectangle" />
+        <Parameter Name="dest" Type="Gdk.Rectangle&amp;" RefType="out" />
+      </Parameters>
+      <Docs>
+        <summary>Obtains the intersection of a this <see cref="T:Gdk.Rectangle" /> and another.</summary>
+        <param name="src2">a <see cref="T:Gdk.Rectangle" /></param>
+        <param name="dest">a <see cref="T:Gdk.Rectangle" /> representing the intersection of this <see cref="T:Gdk.Rectangle" /> and the src2 <see cref="T:Gdk.Rectangle" /></param>
+        <returns>Returns true if the two <see cref="T:Gdk.Rectangle" /> objects intersect.</returns>
+        <remarks>The result is the rectangular region occupied by both source rectanlges.</remarks>
+      </Docs>
+    </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>