Slightly adapted window focus documentation

include/SFML/Window/Window.hpp

@@ -417,28 +417,27 @@ public:
     ///        foreground window
     ///
     /// At any given time, only one window may have the input focus
-    /// to receive input events such as keystrokes or mouse
-    /// events.
+    /// to receive input events such as keystrokes or mouse events.
     /// If a window requests focus, it only hints to the operating
     /// system, that it would like to be focused. The operating system
-    /// is free to deny the request. For example under Windows OS
-    /// windows are not allowed to steal focus. But the user
-    /// will be notified through a flashing taskbar button.
+    /// is free to deny the request.
     /// This is not to be confused with setActive().
     ///
     /// \return True if operation was successful, false otherwise
+    /// \see hasFocus
     ///
     ////////////////////////////////////////////////////////////
     bool requestFocus();
 
     ////////////////////////////////////////////////////////////
-    /// \brief Determine whether the window has the input focus
+    /// \brief Check whether the window has the input focus
     ///
     /// At any given time, only one window may have the input focus
     /// to receive input events such as keystrokes or most mouse
     /// events.
     ///
     /// \return True if window has focus, false otherwise
+    /// \see requestFocus
     ///
     ////////////////////////////////////////////////////////////
     bool hasFocus() const;

src/SFML/Window/OSX/WindowImplCocoa.hpp

@@ -330,7 +330,7 @@ public:
     virtual bool requestFocus();
 
     ////////////////////////////////////////////////////////////
-    /// \brief Determine whether the window has the input focus
+    /// \brief Check whether the window has the input focus
     ///
     /// \return True if window has focus, false otherwise
     ///

src/SFML/Window/OSX/WindowImplDelegateProtocol.h

@@ -176,7 +176,7 @@ namespace sf {
 -(BOOL)requestFocus;
 
 ////////////////////////////////////////////////////////////
-/// \brief Determine whether the window has the input focus
+/// \brief Check whether the window has the input focus
 ///
 /// \return True if window has focus, false otherwise
 ///

src/SFML/Window/Unix/WindowImplX11.hpp

@@ -164,7 +164,7 @@ public:
     virtual bool requestFocus();
 
     ////////////////////////////////////////////////////////////
-    /// \brief Determine whether the window has the input focus
+    /// \brief Check whether the window has the input focus
     ///
     /// \return True if window has focus, false otherwise
     ///

src/SFML/Window/Win32/WindowImplWin32.hpp

@@ -163,7 +163,7 @@ public:
     virtual bool requestFocus();
 
     ////////////////////////////////////////////////////////////
-    /// \brief Determine whether the window has the input focus
+    /// \brief Check whether the window has the input focus
     ///
     /// \return True if window has focus, false otherwise
     ///

src/SFML/Window/WindowImpl.hpp

@@ -204,7 +204,7 @@ public:
     virtual bool requestFocus() = 0;
 
     ////////////////////////////////////////////////////////////
-    /// \brief Determine whether the window has the input focus
+    /// \brief Check whether the window has the input focus
     ///
     /// \return True if window has focus, false otherwise
     ///