Переглянути джерело

Sort release notes by seemingly arbitrary criteria

Camilla Löwy 6 роки тому
батько
коміт
c0a3a9aefe
1 змінених файлів з 73 додано та 72 видалено
  1. 73 72
      docs/news.dox

+ 73 - 72
docs/news.dox

@@ -4,21 +4,6 @@
 
 
 @section news_33 Release notes for 3.3
 @section news_33 Release notes for 3.3
 
 
-@subsection news_33_focusonshow GLFW_FOCUS_ON_SHOW window hint and attribute
-
-GLFW now supports the [GLFW_FOCUS_ON_SHOW](@ref GLFW_DECORATED_hint) window hint
-and attribute for controlling input focus when calling @ref glfwShowWindow
-
-@see @ref window_hide
-
-@subsection news_33_geterror Error query
-
-GLFW now supports querying the last error code for the calling thread and its
-human-readable description with @ref glfwGetError.
-
-@see @ref error_handling
-
-
 @subsection news_33_gamepad SDL_GameControllerDB support and gamepad input
 @subsection news_33_gamepad SDL_GameControllerDB support and gamepad input
 
 
 GLFW now supports remapping of gamepads and controllers to a 360-like controller
 GLFW now supports remapping of gamepads and controllers to a 360-like controller
@@ -29,28 +14,37 @@ and the input state struct @ref GLFWgamepadstate.
 @sa @ref gamepad
 @sa @ref gamepad
 
 
 
 
-@subsection news_33_attention User attention request
+@subsection news_33_joyhats Support for joystick hats
 
 
-GLFW now supports requesting user attention to a specific window (on macOS to
-the application as a whole) with @ref glfwRequestWindowAttention.
+GLFW now supports querying the hats (or POVs or D-pads) of a joystick with @ref
+glfwGetJoystickHats.  Hats are by default also exposed as buttons, but this can
+be disabled with the @ref GLFW_JOYSTICK_HAT_BUTTONS init hint.
 
 
-@see @ref window_attention
+@see @ref joystick_hat
 
 
 
 
-@subsection news_33_maximize Window maximization callback
+@subsection news_33_contentscale Content scale queries for DPI-aware rendering
 
 
-GLFW now supports notifying the application that the window has been maximized
-@ref glfwSetWindowMaximizeCallback.
+GLFW now supports querying the window and monitor content scale, i.e. the ratio
+between the current DPI and the platform's default DPI, with @ref
+glfwGetWindowContentScale and @ref glfwGetMonitorContentScale.
 
 
-@see @ref window_maximize
+Changes of the content scale of a window can be received with the window content
+scale callback, set with @ref glfwSetWindowContentScaleCallback.
 
 
+The @ref GLFW_SCALE_TO_MONITOR window hint enables automatic resizing of a
+window by the content scale of the monitor it is placed, on platforms like
+Windows and X11 where this is necessary.
 
 
-@subsection news_33_keyscancode Platform-specific key scancode query
+@see @ref window_scale
 
 
-GLFW now supports querying the platform dependent scancode of any physical key
-with @ref glfwGetKeyScancode.
 
 
-@see @ref input_key
+@subsection news_33_moltenvk Support for Vulkan on macOS via MoltenVK
+
+GLFW now supports the `VK_MVK_macos_surface` window surface creation extension
+provided by MoltenVK in the [LunarG Vulkan SDK](https://vulkan.lunarg.com/).
+
+@see @ref vulkan_guide
 
 
 
 
 @subsection news_33_setwindowattrib Support for updating window attributes
 @subsection news_33_setwindowattrib Support for updating window attributes
@@ -64,28 +58,20 @@ windows with @ref glfwSetWindowAttrib.
 @see @ref window_attribs
 @see @ref window_attribs
 
 
 
 
-@subsection news_33_contentscale Content scale queries for DPI-aware rendering
-
-GLFW now supports querying the window and monitor content scale, i.e. the ratio
-between the current DPI and the platform's default DPI, with @ref
-glfwGetWindowContentScale and @ref glfwGetMonitorContentScale.
-
-Changes of the content scale of a window can be received with the window content
-scale callback, set with @ref glfwSetWindowContentScaleCallback.
-
-The @ref GLFW_SCALE_TO_MONITOR window hint enables automatic resizing of a
-window by the content scale of the monitor it is placed, on platforms like
-Windows and X11 where this is necessary.
+@subsection news_33_rawmotion Support for raw mouse motion
 
 
-@see @ref window_scale
+GLFW now supports raw (unscaled and unaccelerated) mouse motion in disabled
+cursor mode with the [GLFW_RAW_MOUSE_MOTION](@ref GLFW_RAW_MOUSE_MOTION) input
+mode.  Call @ref glfwRawMouseMotionSupported to check if the current machine
+supports raw mouse motion.
 
 
 
 
-@subsection news_33_workarea Support for monitor work area
+@subsection news_33_geterror Error query
 
 
-GLFW now supports querying the work area of a monitor, i.e. the area not
-occupied by task bars or global menu bars, with @ref glfwGetMonitorWorkarea.
+GLFW now supports querying the last error code for the calling thread and its
+human-readable description with @ref glfwGetError.
 
 
-@see @ref monitor_workarea
+@see @ref error_handling
 
 
 
 
 @subsection news_33_inithint Support for initialization hints
 @subsection news_33_inithint Support for initialization hints
@@ -105,13 +91,28 @@ features that are only available on a single platform.
 @see @ref window_hints_osx
 @see @ref window_hints_osx
 
 
 
 
-@subsection news_33_joyhats Support for joystick hats
+@subsection news_33_attention User attention request
 
 
-GLFW now supports querying the hats (or POVs or D-pads) of a joystick with @ref
-glfwGetJoystickHats.  Hats are by default also exposed as buttons, but this can
-be disabled with the @ref GLFW_JOYSTICK_HAT_BUTTONS init hint.
+GLFW now supports requesting user attention to a specific window (on macOS to
+the application as a whole) with @ref glfwRequestWindowAttention.
 
 
-@see @ref joystick_hat
+@see @ref window_attention
+
+
+@subsection news_33_maximize Window maximization callback
+
+GLFW now supports notifying the application that the window has been maximized
+@ref glfwSetWindowMaximizeCallback.
+
+@see @ref window_maximize
+
+
+@subsection news_33_workarea Support for monitor work area
+
+GLFW now supports querying the work area of a monitor, i.e. the area not
+occupied by task bars or global menu bars, with @ref glfwGetMonitorWorkarea.
+
+@see @ref monitor_workarea
 
 
 
 
 @subsection news_33_transparent Support for transparent windows and framebuffers
 @subsection news_33_transparent Support for transparent windows and framebuffers
@@ -127,6 +128,14 @@ window including decorations and unlike framebuffer transparency can be changed
 at any time after window creation.
 at any time after window creation.
 
 
 
 
+@subsection news_33_keyscancode Platform-specific key scancode query
+
+GLFW now supports querying the platform dependent scancode of any physical key
+with @ref glfwGetKeyScancode.
+
+@see @ref input_key
+
+
 @subsection news_33_centercursor Cursor centering window hint
 @subsection news_33_centercursor Cursor centering window hint
 
 
 GLFW now supports controlling whether the cursor is centered over newly created
 GLFW now supports controlling whether the cursor is centered over newly created
@@ -141,20 +150,26 @@ area with the [GLFW_HOVERED](@ref GLFW_HOVERED_attrib) window attribute.  This
 attribute corresponds to the [cursor enter/leave](@ref cursor_enter) event.
 attribute corresponds to the [cursor enter/leave](@ref cursor_enter) event.
 
 
 
 
-@subsection news_33_rawmotion Support for raw mouse motion
+@subsection news_33_focusonshow GLFW_FOCUS_ON_SHOW window hint and attribute
 
 
-GLFW now supports raw (unscaled and unaccelerated) mouse motion in disabled
-cursor mode with the [GLFW_RAW_MOUSE_MOTION](@ref GLFW_RAW_MOUSE_MOTION) input
-mode.  Call @ref glfwRawMouseMotionSupported to check if the current machine
-supports raw mouse motion.
+GLFW now supports the [GLFW_FOCUS_ON_SHOW](@ref GLFW_DECORATED_hint) window hint
+and attribute for controlling input focus when calling @ref glfwShowWindow
 
 
+@see @ref window_hide
 
 
-@subsection news_33_moltenvk Support for Vulkan on macOS via MoltenVK
 
 
-GLFW now supports the `VK_MVK_macos_surface` window surface creation extension
-provided by MoltenVK in the [LunarG Vulkan SDK](https://vulkan.lunarg.com/).
+@subsection news_33_userptr Monitor and joystick user pointers
 
 
-@see @ref vulkan_guide
+GLFW now supports setting and querying user pointers for connected monitors and
+joysticks with @ref glfwSetMonitorUserPointer, @ref glfwGetMonitorUserPointer,
+@ref glfwSetJoystickUserPointer and @ref glfwGetJoystickUserPointer.
+
+
+@subsection news_33_primary X11 primary selection access
+
+GLFW now supports querying and setting the X11 primary selection via the native
+access functions @ref glfwGetX11SelectionString and @ref
+glfwSetX11SelectionString.
 
 
 
 
 @subsection news_33_osmesa OSMesa backend for headless software rendering
 @subsection news_33_osmesa OSMesa backend for headless software rendering
@@ -169,20 +184,6 @@ creation API, intended for automated testing.  This backend does not provide
 input.
 input.
 
 
 
 
-@subsection news_33_userptr Monitor and joystick user pointers
-
-GLFW now supports setting and querying user pointers for connected monitors and
-joysticks with @ref glfwSetMonitorUserPointer, @ref glfwGetMonitorUserPointer,
-@ref glfwSetJoystickUserPointer and @ref glfwGetJoystickUserPointer.
-
-
-@subsection news_33_primary X11 primary selection access
-
-GLFW now supports querying and setting the X11 primary selection via the native
-access functions @ref glfwGetX11SelectionString and @ref
-glfwSetX11SelectionString.
-
-
 @subsection news_33_mir_removal Experimental Mir support has been removed
 @subsection news_33_mir_removal Experimental Mir support has been removed
 
 
 As per the release of Mir 1.0, the recommended API is now Wayland, the
 As per the release of Mir 1.0, the recommended API is now Wayland, the