From 8e70a94d3de79ab6b958e124979eb19dd90052c8 Mon Sep 17 00:00:00 2001
From: the_fiddler <the_fiddler@ebc5dd9b-fb1d-0410-b6f8-d24c324e9604>
Date: Thu, 25 Jun 2009 11:16:45 +0000
Subject: [PATCH] Enabled xml documentation in debug builds. Fixed a few XML
 documentation warnings.

---
 Build/Prebuild.xml          | 26 ++++++++++++++------------
 Documentation/Changelog.txt |  1 +
 Source/OpenTK/GLControl.cs  |  4 ++--
 Source/OpenTK/GameWindow.cs | 12 ++++++------
 4 files changed, 23 insertions(+), 20 deletions(-)

diff --git a/Build/Prebuild.xml b/Build/Prebuild.xml
index 211ada74..438d14fb 100644
--- a/Build/Prebuild.xml
+++ b/Build/Prebuild.xml
@@ -34,13 +34,13 @@
 
       <Configuration name="Debug">
         <Options>
-          <OutputPath>../../Binaries/Debug/Exe</OutputPath>
+          <OutputPath>../../Binaries/Debug</OutputPath>
         </Options>
       </Configuration>
 
       <Configuration name="Release">
         <Options>
-          <OutputPath>../../Binaries/Release/Exe</OutputPath>
+          <OutputPath>../../Binaries/Release</OutputPath>
         </Options>
       </Configuration>
 
@@ -56,13 +56,13 @@
 
       <Configuration name="Debug">
         <Options>
-          <OutputPath>../../Binaries/Debug/Exe</OutputPath>
+          <OutputPath>../../Binaries/Debug</OutputPath>
         </Options>
       </Configuration>
 
       <Configuration name="Release">
         <Options>
-          <OutputPath>../../Binaries/Release/Exe</OutputPath>
+          <OutputPath>../../Binaries/Release</OutputPath>
         </Options>
       </Configuration>
 
@@ -84,14 +84,15 @@
 
       <Configuration name="Debug">
         <Options>
-          <OutputPath>../../Binaries/Debug/Libraries</OutputPath>
-          <AllowUnsafe>true</AllowUnsafe>
+          <OutputPath>../../Binaries/Debug</OutputPath>
+          <AllowUnsafe>true</AllowUnsafe>
+          <XmlDocFile>OpenTK.xml</XmlDocFile>
         </Options>
       </Configuration>
 
       <Configuration name="Release">
         <Options>
-          <OutputPath>../../Binaries/Release/Libraries</OutputPath>
+          <OutputPath>../../Binaries/Release</OutputPath>
           <AllowUnsafe>true</AllowUnsafe>
           <XmlDocFile>OpenTK.xml</XmlDocFile>
         </Options>
@@ -114,14 +115,15 @@
 
       <Configuration name="Debug">
         <Options>
-          <OutputPath>../../Binaries/Debug/Libraries</OutputPath>
-          <AllowUnsafe>true</AllowUnsafe>
+          <OutputPath>../../Binaries/Debug</OutputPath>
+          <AllowUnsafe>true</AllowUnsafe>
+          <XmlDocFile>OpenTK.Utilities.xml</XmlDocFile>
         </Options>
       </Configuration>
 
       <Configuration name="Release">
         <Options>
-          <OutputPath>../../Binaries/Release/Libraries</OutputPath>
+          <OutputPath>../../Binaries/Release</OutputPath>
           <AllowUnsafe>true</AllowUnsafe>
           <XmlDocFile>OpenTK.Utilities.xml</XmlDocFile>
         </Options>
@@ -143,14 +145,14 @@
 
       <Configuration name="Debug">
         <Options>
-          <OutputPath>../../Binaries/Debug/Examples</OutputPath>
+          <OutputPath>../../Binaries/Debug</OutputPath>
           <AllowUnsafe>true</AllowUnsafe>
         </Options>
       </Configuration>
 
       <Configuration name="Release">
         <Options>
-          <OutputPath>../../Binaries/Release/Examples</OutputPath>
+          <OutputPath>../../Binaries/Release</OutputPath>
           <AllowUnsafe>true</AllowUnsafe>
         </Options>
       </Configuration>
diff --git a/Documentation/Changelog.txt b/Documentation/Changelog.txt
index e1f361f2..bb7b7d16 100644
--- a/Documentation/Changelog.txt
+++ b/Documentation/Changelog.txt
@@ -4,6 +4,7 @@
  OpenTK 0.9.9 -> 0.9.9-1
 -------------------------
 + OpenTK
+    + Enabled documentation generation in debug builds.
     + Compute
         + Bitfields are now mapped to 'long' instead of 'int'.
 
diff --git a/Source/OpenTK/GLControl.cs b/Source/OpenTK/GLControl.cs
index 12066bc2..0349bb43 100644
--- a/Source/OpenTK/GLControl.cs
+++ b/Source/OpenTK/GLControl.cs
@@ -238,7 +238,7 @@ namespace OpenTK
         /// <summary>
         /// Destroys the GraphicsContext attached to this GLControl.
         /// </summary>
-        /// <exception cref="NullReferenceException">Occurs when no GraphicsContext is attached.</exception>
+        /// <exception cref="System.NullReferenceException">Occurs when no GraphicsContext is attached.</exception>
         public void DestroyContext()
         {
             Context.Dispose();
@@ -332,7 +332,7 @@ namespace OpenTK
 
         /// <summary>Grabs a screenshot of the frontbuffer contents.</summary>
         /// <returns>A System.Drawing.Bitmap, containing the contents of the frontbuffer.</returns>
-        /// <exception cref="GraphicsContextException">
+        /// <exception cref="OpenTK.Graphics.GraphicsContextException">
         /// Occurs when no OpenTK.Graphics.GraphicsContext is current in the calling thread.
         /// </exception>
         public Bitmap GrabScreenshot()
diff --git a/Source/OpenTK/GameWindow.cs b/Source/OpenTK/GameWindow.cs
index bd855e1b..47bb9330 100644
--- a/Source/OpenTK/GameWindow.cs
+++ b/Source/OpenTK/GameWindow.cs
@@ -1149,7 +1149,7 @@ namespace OpenTK
         #region Location
         
         /// <summary>
-        /// Gets or sets a <see cref="System.Drawing.Point"> structure that contains the location of this window on the desktop.
+        /// Gets or sets a <see cref="System.Drawing.Point"/> structure that contains the location of this window on the desktop.
         /// </summary>
         public Point Location
         {
@@ -1174,7 +1174,7 @@ namespace OpenTK
         #region Size
         
         /// <summary>
-        /// Gets or sets a <see cref="System.Drawing.Size"> structure that contains the external size of this window.
+        /// Gets or sets a <see cref="System.Drawing.Size"/> structure that contains the external size of this window.
         /// </summary>
         public Size Size
         {
@@ -1401,14 +1401,14 @@ namespace OpenTK
         /// <returns>
         /// The point transformed to screen coordinates.
         /// </returns>
-        public System.Drawing.Point PointToScreen(System.Drawing.Point p)
+        public System.Drawing.Point PointToScreen(System.Drawing.Point point)
         {
             // Here we use the fact that PointToClient just translates the point, and PointToScreen
             // should perform the inverse operation.
             System.Drawing.Point trans = PointToClient(System.Drawing.Point.Empty);
-            p.X -= trans.X;
-            p.Y -= trans.Y;
-            return p;
+            point.X -= trans.X;
+            point.Y -= trans.Y;
+            return point;
         }
 
         #endregion