2
0
Эх сурвалжийг харах

Sort release notes by seemingly arbitrary criteria

Camilla Löwy 6 жил өмнө
parent
commit
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
 
-@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
 
 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
 
 
-@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
@@ -64,28 +58,20 @@ windows with @ref glfwSetWindowAttrib.
 @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
@@ -105,13 +91,28 @@ features that are only available on a single platform.
 @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
@@ -127,6 +128,14 @@ window including decorations and unlike framebuffer transparency can be changed
 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
 
 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.
 
 
-@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
@@ -169,20 +184,6 @@ creation API, intended for automated testing.  This backend does not provide
 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
 
 As per the release of Mir 1.0, the recommended API is now Wayland, the