diff --git a/include/GLFW/glfw3.h b/include/GLFW/glfw3.h
index b2e7ee4a..b5d00cd7 100644
--- a/include/GLFW/glfw3.h
+++ b/include/GLFW/glfw3.h
@@ -1718,6 +1718,9 @@ GLFWAPI void glfwSetWindowShouldClose(GLFWwindow* window, int value);
  *  @param[in] window The window whose title to change.
  *  @param[in] title The UTF-8 encoded window title.
  *
+ *  @remarks __OS X:__ The window title will not be updated until the next time
+ *  you process events.
+ *
  *  @par Thread Safety
  *  This function may only be called from the main thread.
  *