From 43dba6d2a56752d84f412f0f0afdf6ac12da3e7e Mon Sep 17 00:00:00 2001
From: Miguel de Icaza <miguel@gnome.org>
Date: Sat, 4 Dec 2010 18:01:42 -0500
Subject: Add part3 of the Google GCI 2010 contributions

---
 .../Mono.Cairo/Documentation/en/Cairo/LineCap.xml  |  4 +-
 .../Mono.Cairo/Documentation/en/Cairo/LineJoin.xml | 12 +++---
 .../Documentation/en/Cairo/LinearGradient.xml      |  8 ++--
 .../Mono.Cairo/Documentation/en/Cairo/Matrix.xml   | 44 +++++++++++-----------
 .../Documentation/en/Cairo/NativeMethods.xml       |  6 +--
 .../Mono.Cairo/Documentation/en/Cairo/Operator.xml | 34 ++++++++---------
 .../Documentation/en/Cairo/PSSurface.xml           | 38 +++++++++----------
 .../Mono.Cairo/Documentation/en/Cairo/Path.xml     | 16 ++++----
 .../Documentation/en/Cairo/PdfSurface.xml          | 24 ++++++------
 .../Mono.Cairo/Documentation/en/Cairo/Point.xml    |  6 +--
 .../Mono.Cairo/Documentation/en/Cairo/PointD.xml   |  6 +--
 11 files changed, 99 insertions(+), 99 deletions(-)

(limited to 'mcs')

diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineCap.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineCap.xml
index 01945d8b616..a8b18eef7db 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineCap.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineCap.xml
@@ -10,7 +10,7 @@
   </Base>
   <Docs>
     <summary>Defines the various line ending styles.</summary>
-    <remarks>To be added.</remarks>
+    <remarks />
   </Docs>
   <Members>
     <Member MemberName="Butt">
@@ -57,4 +57,4 @@
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineJoin.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineJoin.xml
index b5aa4a582d0..601688f59ab 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineJoin.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/LineJoin.xml
@@ -9,8 +9,8 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Defines the various line join styles</summary>
+    <remarks />
   </Docs>
   <Members>
     <Member MemberName="Bevel">
@@ -20,7 +20,7 @@
         <ReturnType>Cairo.LineJoin</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>beveled join</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -34,7 +34,7 @@
         <ReturnType>Cairo.LineJoin</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>miter join</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -48,7 +48,7 @@
         <ReturnType>Cairo.LineJoin</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>rounded join</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -56,4 +56,4 @@
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/LinearGradient.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/LinearGradient.xml
index 3de7d1f6aac..ae080e5e4c4 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/LinearGradient.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/LinearGradient.xml
@@ -67,10 +67,10 @@ pat.Destroy ();
         <ReturnType>Cairo.PointD[]</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets the gradient endpoints for a linear gradient</summary>
+        <value>A Array of <see cref="t:Cairo.PointD" /> with the Start- and Endpoint</value>
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Matrix.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Matrix.xml
index 26a6487df42..4f38bfbf6fd 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Matrix.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Matrix.xml
@@ -101,7 +101,7 @@ if (cs == Cairo.Status.Success) {
         <param name="x0">x0 component of the affine transformation.</param>
         <param name="y0">y0 component of the affine transformation.</param>
         <summary>Create a new matrix, initialized with the specified values.</summary>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -116,9 +116,9 @@ if (cs == Cairo.Status.Success) {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns a clone of the matrix</summary>
+        <returns>The clone matrix as a <see cref="t:System.Object" /></returns>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -139,10 +139,10 @@ if (cs == Cairo.Status.Success) {
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="o">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="o">The matrix to test the equality with</param>
+        <summary>Tests the equality of this matrix and another one</summary>
+        <returns>True if the two matrices are equal, otherwise false</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -157,9 +157,9 @@ if (cs == Cairo.Status.Success) {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns a hash representing the matrix</summary>
+        <returns>A hash as an <see cref="t:System.Int32" /> representing the matrix</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Init">
@@ -187,7 +187,7 @@ if (cs == Cairo.Status.Success) {
 
 
 <list type="bullet"><item><term>x_new = xx * x + xy * y + x0;</term></item><item><term>y_new = yx * x + yy * y + y0;</term></item></list></summary>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -203,7 +203,7 @@ if (cs == Cairo.Status.Success) {
       <Parameters />
       <Docs>
         <summary>Initializes the matrix to the identity.</summary>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -301,7 +301,7 @@ if (cs == Cairo.Status.Success) {
       <Docs>
         <summary>Determine if a given matrix is the Identity.</summary>
         <returns>Returns true if this matrix is equivalent to the identity.</returns>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -320,7 +320,7 @@ if (cs == Cairo.Status.Success) {
       <Docs>
         <param name="b">The affine transformation matrix to multiply by.</param>
         <summary>Multiplies this Matrix by b. The effect is to apply b's transformation to this matrix, or in other words, to transform this matrix by b.</summary>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -342,7 +342,7 @@ if (cs == Cairo.Status.Success) {
         <param name="b">The matrix to multiply by.</param>
         <summary>Multiplies the affine transformations in a and b together and returns the result in result. The result is an affine transformation which is equivalent to separately applying the transformations a and b in order.</summary>
         <returns>The result of multiplying a and b.</returns>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -364,7 +364,7 @@ if (cs == Cairo.Status.Success) {
         <param name="rhs">The second Matrix to compare.</param>
         <summary>Determines whether two matrices have the same value.</summary>
         <returns>Returns true if all members are equal.</returns>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -386,7 +386,7 @@ if (cs == Cairo.Status.Success) {
         <param name="rhs">The second Matrix to compare.</param>
         <summary>Determines whether two matrices do not share the same value.</summary>
         <returns>Returns true if any members are not equal.</returns>
-        <remarks>To be added.</remarks>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -446,9 +446,9 @@ if (cs == Cairo.Status.Success) {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns the matrix as a string</summary>
+        <returns>A string describing the matrix</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="TransformDistance">
@@ -611,4 +611,4 @@ if (cs == Cairo.Status.Success) {
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/NativeMethods.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/NativeMethods.xml
index a8e515877f8..1b5c559777d 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/NativeMethods.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/NativeMethods.xml
@@ -10,8 +10,8 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Contains references to the native cairo methods</summary>
+    <remarks />
   </Docs>
   <Members />
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Operator.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Operator.xml
index ac894b423c6..bdfa8cb0a31 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Operator.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Operator.xml
@@ -9,8 +9,8 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Contains the Cairo Operators</summary>
+    <remarks />
   </Docs>
   <Members>
     <Member MemberName="Add">
@@ -20,7 +20,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Merges the overlapping colors to a new one</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -34,7 +34,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>This operator leaves the first object mostly intact, but mixes both objects in the overlapping area. The second object object is not drawn except there.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -48,7 +48,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Where the second object is drawn, the first is completely removed. Anywhere else it is left intact. The second object itself is not drawn.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -62,7 +62,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Leaves the first object untouched, the second is discarded completely.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -76,7 +76,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Same as the ATOP operator, but as if the order of the drawing operations had been reversed.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -90,7 +90,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>This works like the IN operator, but with the second object "below" the first.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -104,7 +104,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The second object is used to reduce the visibility of the first in the overlapping area. The second object is not drawn itself.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -118,7 +118,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The result is similar to the OVER operator. Except that the "order" of the objects is reversed, so the second is drawn below the first.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -132,7 +132,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The first object is removed completely, the second is only drawn where the first was.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -146,7 +146,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The first object is removed completely, the second is only drawn where the first not was.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -160,7 +160,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The result is the same as if you held two semi-transparent slides on top of each other.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -174,7 +174,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Merges the overlapping colors to a new one</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -188,7 +188,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The second object is drawn as if nothing else were below. The first object is only left intact outside the second.</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -202,7 +202,7 @@
         <ReturnType>Cairo.Operator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Merges the overlapping colors to a new one with XOR</summary>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -210,4 +210,4 @@
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/PSSurface.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/PSSurface.xml
index f000de70fd8..9b5b0417636 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/PSSurface.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/PSSurface.xml
@@ -10,8 +10,8 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>The PostScript surface is used to render cairo graphics to Adobe PostScript files.</summary>
+    <remarks />
     <since version="cairo 1.2" />
   </Docs>
   <Members>
@@ -24,11 +24,11 @@
         <Parameter Name="height" Type="System.Double" />
       </Parameters>
       <Docs>
-        <param name="filename">To be added.</param>
-        <param name="width">To be added.</param>
-        <param name="height">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="filename">Filename for the PDF output as <see cref="t:System.String" /></param>
+        <param name="width">width of the surface, in points as <see cref="t:System.Double" /> (1 point == 1/72.0 inch)</param>
+        <param name="height">height of the surface, in points as <see cref="t:System.Double" /> (1 point == 1/72.0 inch)</param>
+        <summary>Creates a PostScript surface of the specified size in points to be written to filename.</summary>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -43,8 +43,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Begins the setup of the page</summary>
+        <remarks>Note that it is only necessary to call <see cref="M:Cairo.PSSurface.BeginPageSetup" /> for the first page of any surface.</remarks>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -59,8 +59,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Begins the setup</summary>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -77,9 +77,9 @@
         <Parameter Name="comment" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="comment">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="comment">The comment as a <see cref="t:System.String" /></param>
+        <summary>Emits a comment into the PostScript output</summary>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -97,10 +97,10 @@
         <Parameter Name="height" Type="System.Double" />
       </Parameters>
       <Docs>
-        <param name="width">To be added.</param>
-        <param name="height">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="width">The new surface width in points as <see cref="t:System.Double" /> (1 point == 1/72.0 inch)</param>
+        <param name="height">The new surface height in points as <see cref="t:System.Double" /> (1 point == 1/72.0 inch)</param>
+        <summary>Changes the size of the PostScript surface for the current (and subsequent) pages.</summary>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -108,4 +108,4 @@
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Path.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Path.xml
index 9fc97a4975c..9e30b73dd7d 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Path.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Path.xml
@@ -14,8 +14,8 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>The Cairo Path Class</summary>
+    <remarks />
   </Docs>
   <Members>
     <Member MemberName="Dispose">
@@ -32,9 +32,9 @@
         <Parameter Name="disposing" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <param name="disposing">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="disposing">Defines if called from finalization thread</param>
+        <summary>Immediately releases all memory associated with Path</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -49,8 +49,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Finalizes the path</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="System.IDisposable.Dispose">
@@ -70,4 +70,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/PdfSurface.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/PdfSurface.xml
index 8e3be344056..a367f724bad 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/PdfSurface.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/PdfSurface.xml
@@ -10,8 +10,8 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>The PDF surface is used to render cairo graphics to Adobe PDF files.</summary>
+    <remarks />
     <since version="cairo 1.2" />
   </Docs>
   <Members>
@@ -24,11 +24,11 @@
         <Parameter Name="height" Type="System.Double" />
       </Parameters>
       <Docs>
-        <param name="filename">To be added.</param>
-        <param name="width">To be added.</param>
-        <param name="height">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="filename">Filename for the PDF output as <see cref="t:System.String" /></param>
+        <param name="width">width of the surface, in points as <see cref="t:System.Double" /> (1 point == 1/72.0 inch)</param>
+        <param name="height">height of the surface, in points <see cref="t:System.Double" /> (1 point == 1/72.0 inch)</param>
+        <summary>Creates a PDF surface of the specified size in points to be written to filename.</summary>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -46,10 +46,10 @@
         <Parameter Name="height" Type="System.Double" />
       </Parameters>
       <Docs>
-        <param name="width">To be added.</param>
-        <param name="height">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="width">new surface width, in points (1 point == 1/72.0 inch)</param>
+        <param name="height">new surface height, in points (1 point == 1/72.0 inch)</param>
+        <summary>Changes the size of the PDF surface for the current (and subsequent) pages.</summary>
+        <remarks />
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -57,4 +57,4 @@
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Point.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Point.xml
index 76f4e2d4535..16eca1a9057 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/Point.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/Point.xml
@@ -40,7 +40,7 @@
       </ReturnValue>
       <Docs>
         <summary>Access to the X coordinate.</summary>
-        <value>To be added.</value>
+        <value>The X coordinate</value>
         <remarks>
         </remarks>
       </Docs>
@@ -57,7 +57,7 @@
       </ReturnValue>
       <Docs>
         <summary>Access to the Y coordinate.</summary>
-        <value>To be added.</value>
+        <value>The Y coordinate</value>
         <remarks>
         </remarks>
       </Docs>
@@ -67,4 +67,4 @@
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/mcs/class/Mono.Cairo/Documentation/en/Cairo/PointD.xml b/mcs/class/Mono.Cairo/Documentation/en/Cairo/PointD.xml
index 8704861f210..ca73bc30615 100644
--- a/mcs/class/Mono.Cairo/Documentation/en/Cairo/PointD.xml
+++ b/mcs/class/Mono.Cairo/Documentation/en/Cairo/PointD.xml
@@ -46,7 +46,7 @@ gr.Rectangle ( new PointD (0, 0), 1, 1);
       </ReturnValue>
       <Docs>
         <summary>Access to the X coordinate.</summary>
-        <value>To be added.</value>
+        <value>The X coordinate</value>
         <remarks>
         </remarks>
       </Docs>
@@ -63,7 +63,7 @@ gr.Rectangle ( new PointD (0, 0), 1, 1);
       </ReturnValue>
       <Docs>
         <summary>Access to the Y coordinate.</summary>
-        <value>To be added.</value>
+        <value>The Y coordinate</value>
         <remarks>
         </remarks>
       </Docs>
@@ -73,4 +73,4 @@ gr.Rectangle ( new PointD (0, 0), 1, 1);
       </AssemblyInfo>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
-- 
cgit v1.2.3