diff --git a/docs/window.dox b/docs/window.dox
index 7d4efae0..cc98ba09 100644
--- a/docs/window.dox
+++ b/docs/window.dox
@@ -149,30 +149,30 @@ context, but are ignored when requesting an OpenGL ES context:
 
 @subsubsection window_hints_wnd Window related hints
 
-`GLFW_RESIZABLE` specifies whether the (windowed mode) window will be resizable
+`GLFW_RESIZABLE` specifies whether the windowed mode window will be resizable
 _by the user_.  The window will still be resizable using the @ref
 glfwSetWindowSize function.  This hint is ignored for full screen windows.
 
-`GLFW_VISIBLE` specifies whether the (windowed mode) window will be initially
+`GLFW_VISIBLE` specifies whether the windowed mode window will be initially
 visible.  This hint is ignored for full screen windows.
 
-`GLFW_DECORATED` specifies whether the (windowed mode) window will have window
-decorations such as a border, a close widget, etc.  This hint is ignored for
-full screen windows.  Note that even though a window may lack a close widget, it
-is usually still possible for the user to generate close events.
+`GLFW_DECORATED` specifies whether the windowed mode window will have window
+decorations such as a border, a close widget, etc.  An undecorated window may
+still allow the user to generate close events on some platforms.  This hint is
+ignored for full screen windows.
 
-`GLFW_FOCUSED` specifies whether the (windowed mode) window will be given input
+`GLFW_FOCUSED` specifies whether the windowed mode window will be given input
 focus when created.  This hint is ignored for full screen and initially hidden
 windows.
 
-`GLFW_AUTO_ICONIFY` specifies whether the (full screen) window will
+`GLFW_AUTO_ICONIFY` specifies whether the full screen window will
 automatically iconify and restore the previous video mode on input focus loss.
 This hint is ignored for windowed mode windows.
 
-`GLFW_FLOATING` specifies whether the window will be floating above other
-regular windows, also called topmost or always-on-top.  This is intended
-primarily for debugging purposes and cannot be used to implement proper full
-screen windows.  This hint is ignored for full screen windows.
+`GLFW_FLOATING` specifies whether the windowed mode window will be floating
+above other regular windows, also called topmost or always-on-top.  This is
+intended primarily for debugging purposes and cannot be used to implement proper
+full screen windows.  This hint is ignored for full screen windows.
 
 
 @subsubsection window_hints_fb Framebuffer related hints