Documentation work.
diff --git a/docs/monitor.dox b/docs/monitor.dox
index 354820c..28e3ffb 100644
--- a/docs/monitor.dox
+++ b/docs/monitor.dox
@@ -112,7 +112,9 @@
@subsection monitor_size Physical size
The physical size in millimetres of a monitor, or an estimation of it, can be
-retrieved with @ref glfwGetMonitorPhysicalSize.
+retrieved with @ref glfwGetMonitorPhysicalSize. This has no relation to its
+current _resolution_, i.e. the width and height of its current
+[video mode](@ref monitor_modes).
@code
int widthMM, heightMM;
diff --git a/docs/window.dox b/docs/window.dox
index 816bf22..3823b0c 100644
--- a/docs/window.dox
+++ b/docs/window.dox
@@ -213,8 +213,8 @@
@subsubsection window_hints_mtr Monitor related hints
`GLFW_REFRESH_RATE` specifies the desired refresh rate for full screen windows.
-If set to zero, the highest available refresh rate will be used. This hint is
-ignored for windowed mode windows.
+If set to `GLFW_DONT_CARE`, the highest available refresh rate will be used.
+This hint is ignored for windowed mode windows.
@subsubsection window_hints_ctx Context related hints
diff --git a/include/GLFW/glfw3.h b/include/GLFW/glfw3.h
index 64ebcc7..e3eb461 100644
--- a/include/GLFW/glfw3.h
+++ b/include/GLFW/glfw3.h
@@ -1149,7 +1149,7 @@
* @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it
* yourself. It is guaranteed to be valid only until the monitor configuration
- * changes.
+ * changes or the library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -1252,7 +1252,8 @@
*
* @par Pointer Lifetime
* The returned string is allocated and freed by GLFW. You should not free it
- * yourself. It is valid until the specified monitor is disconnected.
+ * yourself. It is valid until the specified monitor is disconnected or the
+ * library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -1307,8 +1308,8 @@
*
* @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it
- * yourself. It is valid until the specified monitor is disconnected or this
- * function is called again for that monitor.
+ * yourself. It is valid until the specified monitor is disconnected, this
+ * function is called again for that monitor or the library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -1339,7 +1340,8 @@
*
* @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it
- * yourself. It is valid until the specified monitor is disconnected.
+ * yourself. It is valid until the specified monitor is disconnected or the
+ * library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -1385,7 +1387,8 @@
* @par Pointer Lifetime
* The returned structure and its arrays are allocated and freed by GLFW. You
* should not free them yourself. They are valid until the specified monitor
- * is disconnected or this function is called again for that monitor.
+ * is disconnected, this function is called again for that monitor or the
+ * library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -1448,7 +1451,7 @@
* This function sets hints for the next call to @ref glfwCreateWindow. The
* hints, once set, retain their values until changed by a call to @ref
* glfwWindowHint or @ref glfwDefaultWindowHints, or until the library is
- * terminated with @ref glfwTerminate.
+ * terminated.
*
* @param[in] target The [window hint](@ref window_hints) to set.
* @param[in] hint The new value of the window hint.
@@ -2920,8 +2923,8 @@
*
* @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it
- * yourself. It is valid until the specified joystick is disconnected or this
- * function is called again for that joystick.
+ * yourself. It is valid until the specified joystick is disconnected, this
+ * function is called again for that joystick or the library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -2951,8 +2954,8 @@
*
* @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it
- * yourself. It is valid until the specified joystick is disconnected or this
- * function is called again for that joystick.
+ * yourself. It is valid until the specified joystick is disconnected, this
+ * function is called again for that joystick or the library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -2981,8 +2984,8 @@
*
* @par Pointer Lifetime
* The returned string is allocated and freed by GLFW. You should not free it
- * yourself. It is valid until the specified joystick is disconnected or this
- * function is called again for that joystick.
+ * yourself. It is valid until the specified joystick is disconnected, this
+ * function is called again for that joystick or the library is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -3032,7 +3035,8 @@
* @par Pointer Lifetime
* The returned string is allocated and freed by GLFW. You should not free it
* yourself. It is valid until the next call to @ref
- * glfwGetClipboardString or @ref glfwSetClipboardString.
+ * glfwGetClipboardString or @ref glfwSetClipboardString, or until the library
+ * is terminated.
*
* @par Thread Safety
* This function may only be called from the main thread.
@@ -3257,7 +3261,8 @@
* between contexts.
*
* @par Pointer Lifetime
- * The returned function pointer is valid until the context is destroyed.
+ * The returned function pointer is valid until the context is destroyed or the
+ * library is terminated.
*
* @par Thread Safety
* This function may be called from any thread.
