FS#162 - Add a function to retrieve the system specific handle of a window

git-svn-id: https://sfml.svn.sourceforge.net/svnroot/sfml/branches/sfml2@1530 4e206d99-4929-0410-ac5d-dfc041789085

include/SFML/Graphics/Shader.hpp

@@ -279,7 +279,7 @@ public :
     void Bind() const;
 
     ////////////////////////////////////////////////////////////
-    /// \brief Bind the shader (deactivate it)
+    /// \brief Unbind the shader (deactivate it)
     ///
     /// This function is normally for internal use only, unless
     /// you want to use the shader with a custom OpenGL rendering

include/SFML/Graphics/Sprite.hpp

@@ -277,9 +277,9 @@ private :
 /// 
 /// // Create a sprite
 /// sf::Sprite sprite;
-/// text.SetImage(image);
-/// text.SetSubRect(sf::IntRect(10, 10, 50, 30));
-/// text.Resize(100, 60);
+/// sprite.SetImage(image);
+/// sprite.SetSubRect(sf::IntRect(10, 10, 50, 30));
+/// sprite.Resize(100, 60);
 ///
 /// // Display it
 /// window.Draw(sprite); // window is a sf::RenderWindow

include/SFML/Graphics/View.hpp

@@ -144,13 +144,6 @@ public :
     /// \brief Reset the view to the given rectangle
     ///
     /// Note that this function resets the rotation angle to 0.
-    /// It is a function provided for convenience, equivalent to the
-    /// following calls:
-    /// \code
-    /// view.SetCenter(rectangle.GetCenter());
-    /// view.SetSize(rectangle.GetSize());
-    /// view.SetRotation(0);
-    /// \endcode
     ///
     /// \param rectangle Rectangle defining the zone to display
     ///

include/SFML/System/Utf.hpp

@@ -409,7 +409,7 @@ public :
 };
 
 ////////////////////////////////////////////////////////////
-/// \brief Specialization of the Utf template for UTF-16
+/// \brief Specialization of the Utf template for UTF-32
 ///
 ////////////////////////////////////////////////////////////
 template <>

include/SFML/Window/Window.hpp

@@ -433,6 +433,20 @@ public :
     ////////////////////////////////////////////////////////////
     void SetJoystickThreshold(float threshold);
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Get the OS-specific handle of the window
+    ///
+    /// The type of the returned handle is sf::WindowHandle,
+    /// which is a typedef to the handle type defined by the OS.
+    /// You shouldn't need to use this function, unless you have
+    /// very specific stuff to implement that SFML doesn't support,
+    /// or implement a temporary workaround until a bug is fixed.
+    ///
+    /// \return System handle of the window
+    ///
+    ////////////////////////////////////////////////////////////
+    WindowHandle GetSystemHandle() const;
+
 private :
 
     ////////////////////////////////////////////////////////////