From 50332a8186afa6fa910d593ea97e01a8b86ba1c9 Mon Sep 17 00:00:00 2001
From: binary1248 <binary1248@hotmail.com>
Date: Mon, 7 Oct 2013 08:34:23 +0200
Subject: [PATCH] Additional comments regarding sleep implementation.

---
 src/SFML/System/Unix/SleepImpl.cpp  | 8 ++++++--
 src/SFML/System/Win32/SleepImpl.cpp | 8 ++++----
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/SFML/System/Unix/SleepImpl.cpp b/src/SFML/System/Unix/SleepImpl.cpp
index acec6731..9dbbde74 100644
--- a/src/SFML/System/Unix/SleepImpl.cpp
+++ b/src/SFML/System/Unix/SleepImpl.cpp
@@ -39,12 +39,16 @@ void sleepImpl(Time time)
 {
     Uint64 usecs = time.asMicroseconds();
 
-    // construct the time to wait
+    // Construct the time to wait
     timespec ti;
     ti.tv_nsec = (usecs % 1000000) * 1000;
     ti.tv_sec = usecs / 1000000;
 
-    // wait...
+    // Wait...
+    // If nanosleep returns -1, we check errno. If it is EINTR
+    // nanosleep was interrupted and has set ti to the remaining
+    // duration. We continue sleeping until the complete duration
+    // has passed. We stop sleeping if it was due to an error.
     while ((nanosleep(&ti, &ti) == -1) && (errno == EINTR))
     {
     }
diff --git a/src/SFML/System/Win32/SleepImpl.cpp b/src/SFML/System/Win32/SleepImpl.cpp
index 2a88db41..e3c88cb4 100644
--- a/src/SFML/System/Win32/SleepImpl.cpp
+++ b/src/SFML/System/Win32/SleepImpl.cpp
@@ -36,17 +36,17 @@ namespace priv
 ////////////////////////////////////////////////////////////
 void sleepImpl(Time time)
 {
-    // get the supported timer resolutions on this system
+    // Get the supported timer resolutions on this system
     TIMECAPS tc;
     timeGetDevCaps(&tc, sizeof(TIMECAPS));
 
-    // set the timer resolution to the minimum for the Sleep call
+    // Set the timer resolution to the minimum for the Sleep call
     timeBeginPeriod(tc.wPeriodMin);
 
-    // wait...
+    // Wait...
     ::Sleep(time.asMilliseconds());
 
-    // reset the timer resolution back to the system default
+    // Reset the timer resolution back to the system default
     timeEndPeriod(tc.wPeriodMin);
 }