Convert Doxygen headings to Markdown

docs/news.md

@@ -1,13 +1,13 @@
-@page news Release notes
+# Release notes {#news}
 
 @tableofcontents
 
 
-@section news_34 Release notes for version 3.4
+## Release notes for version 3.4 {#news_34}
 
-@subsection features_34 New features in version 3.4
+### New features in version 3.4 {#features_34}
 
-@subsubsection runtime_platform_34 Runtime platform selection
+#### Runtime platform selection {#runtime_platform_34}
 
 GLFW now supports being compiled for multiple backends and selecting between
 them at runtime with the @ref GLFW_PLATFORM init hint.  After initialization the
@@ -15,7 +15,7 @@ selected platform can be queried with @ref glfwGetPlatform.  You can check if
 support for a given platform is compiled in with @ref glfwPlatformSupported.
 
 
-@subsubsection standard_cursors_34 More standard cursors
+#### More standard cursors {#standard_cursors_34}
 
 GLFW now provides the standard cursor shapes @ref GLFW_RESIZE_NWSE_CURSOR and
 @ref GLFW_RESIZE_NESW_CURSOR for diagonal resizing, @ref GLFW_RESIZE_ALL_CURSOR
@@ -33,7 +33,7 @@ are still available.
 For more information see @ref cursor_standard.
 
 
-@subsubsection mouse_passthrough_34 Mouse event passthrough
+#### Mouse event passthrough {#mouse_passthrough_34}
 
 GLFW now provides the [GLFW_MOUSE_PASSTHROUGH](@ref GLFW_MOUSE_PASSTHROUGH_hint)
 window hint for making a window transparent to mouse input, lettings events pass
@@ -41,7 +41,7 @@ to whatever window is behind it.  This can also be changed after window
 creation with the matching [window attribute](@ref GLFW_MOUSE_PASSTHROUGH_attrib).
 
 
-@subsubsection wayland_libdecor_34 Wayland libdecor decorations
+#### Wayland libdecor decorations {#wayland_libdecor_34}
 
 GLFW now supports improved fallback window decorations via
 [libdecor](https://gitlab.freedesktop.org/libdecor/libdecor).
@@ -51,13 +51,13 @@ Support for libdecor can be toggled before GLFW is initialized with the
 enabled by default.
 
 
-@subsubsection wayland_app_id_34 Wayland app_id specification
+#### Wayland app_id specification {#wayland_app_id_34}
 
 GLFW now supports specifying the app_id for a Wayland window using the
 [GLFW_WAYLAND_APP_ID](@ref GLFW_WAYLAND_APP_ID_hint) window hint string.
 
 
-@subsubsection features_34_angle_backend Support for ANGLE rendering backend selection
+#### Support for ANGLE rendering backend selection {#features_34_angle_backend}
 
 GLFW now provides the
 [GLFW_ANGLE_PLATFORM_TYPE](@ref GLFW_ANGLE_PLATFORM_TYPE_hint) init hint for
@@ -66,7 +66,7 @@ requesting a specific rendering backend when using
 contexts.
 
 
-@subsubsection captured_cursor_34 Captured cursor mode
+#### Captured cursor mode {#captured_cursor_34}
 
 GLFW now supports confining the cursor to the window content area with the @ref
 GLFW_CURSOR_CAPTURED cursor mode.
@@ -74,7 +74,7 @@ GLFW_CURSOR_CAPTURED cursor mode.
 For more information see @ref cursor_mode.
 
 
-@subsubsection features_34_init_allocator Support for custom memory allocator
+#### Support for custom memory allocator {#features_34_init_allocator}
 
 GLFW now supports plugging a custom memory allocator at initialization with @ref
 glfwInitAllocator.  The allocator is a struct of type @ref GLFWallocator with
@@ -84,7 +84,7 @@ function pointers corresponding to the standard library functions `malloc`,
 For more information see @ref init_allocator.
 
 
-@subsubsection features_34_position_hint Window hints for initial position
+#### Window hints for initial position {#features_34_position_hint}
 
 GLFW now provides the @ref GLFW_POSITION_X and @ref GLFW_POSITION_Y window hints for
 specifying the initial position of the window.  This removes the need to create a hidden
@@ -92,7 +92,7 @@ window, move it and then show it.  The default value of these hints is
 `GLFW_ANY_POSITION`, which selects the previous behavior.
 
 
-@subsubsection features_34_win32_keymenu Support for keyboard access to Windows window menu
+#### Support for keyboard access to Windows window menu {#features_34_win32_keymenu}
 
 GLFW now provides the
 [GLFW_WIN32_KEYBOARD_MENU](@ref GLFW_WIN32_KEYBOARD_MENU_hint) window hint for
@@ -101,16 +101,16 @@ Alt-and-then-Space shortcuts.  This may be useful for more GUI-oriented
 applications.
 
 
-@subsubsection features_34_win32_showdefault Support for applying STARTUPINFO show command
+#### Support for applying STARTUPINFO show command {#features_34_win32_showdefault}
 
 GLFW now provides the [GLFW_WIN32_SHOWDEFAULT](@ref GLFW_WIN32_SHOWDEFAULT_hint) window
 hint for applying the show command in the program's `STARTUPINFO` when showing the window
 for the first time.  This may be useful for the main window of a windowed-mode tool.
 
 
-@subsection caveats Caveats for version 3.4
+### Caveats for version 3.4 {#caveats}
 
-@subsubsection native_34 Multiple sets of native access functions
+#### Multiple sets of native access functions {#native_34}
 
 Because GLFW now supports runtime selection of platform (window system), a library binary
 may export native access functions for multiple platforms.  Starting with version 3.4 you
@@ -119,14 +119,14 @@ functions for it.  After initialization, you can query the selected platform wit
 glfwGetPlatform.
 
 
-@subsubsection version_string_34 Version string format has been changed
+#### Version string format has been changed {#version_string_34}
 
 Because GLFW now supports runtime selection of platform (window system), the version
 string returned by @ref glfwGetVersionString has been expanded.  It now contains the names
 of all APIs for all the platforms that the library binary supports.
 
 
-@subsubsection joysticks_34 Joystick support is initialized on demand
+#### Joystick support is initialized on demand {#joysticks_34}
 
 The joystick part of GLFW is now initialized when first used, primarily to work
 around faulty Windows drivers that cause DirectInput to take up to several
@@ -141,7 +141,7 @@ To work around this, call any joystick function before waiting for events, for
 example by setting a [joystick callback](@ref joystick_event).
 
 
-@subsubsection wayland_alpha_34 Framebuffer may lack alpha channel on older Wayland systems
+#### Framebuffer may lack alpha channel on older Wayland systems {#wayland_alpha_34}
 
 On Wayland, when creating an EGL context on a machine lacking the new
 `EGL_EXT_present_opaque` extension, the @ref GLFW_ALPHA_BITS window hint will be
@@ -154,7 +154,7 @@ If you want a per-pixel transparent window, see the
 hint.
 
 
-@subsubsection standalone_34 Tests and examples are disabled when built as a subproject
+#### Tests and examples are disabled when built as a subproject {#standalone_34}
 
 GLFW now does not build the tests and examples when it is added as
 a subdirectory of another CMake project.  To enable these, set the @ref
@@ -168,37 +168,37 @@ add_subdirectory(path/to/glfw)
 @endcode
 
 
-@subsubsection initmenu_34 macOS main menu now created at initialization
+#### macOS main menu now created at initialization {#initmenu_34}
 
 GLFW now creates the main menu and completes the initialization of NSApplication
 during initialization.  Programs that do not want a main menu can disable it
 with the [GLFW_COCOA_MENUBAR](@ref GLFW_COCOA_MENUBAR_hint) init hint.
 
 
-@subsubsection corevideo_34 CoreVideo dependency has been removed
+#### CoreVideo dependency has been removed {#corevideo_34}
 
 GLFW no longer depends on the CoreVideo framework on macOS and it no longer
 needs to be specified during compilation or linking.
 
 
-@subsubsection caveat_fbtransparency_34 Framebuffer transparency requires DWM transparency
+#### Framebuffer transparency requires DWM transparency {#caveat_fbtransparency_34}
 
 GLFW no longer supports framebuffer transparency enabled via @ref
 GLFW_TRANSPARENT_FRAMEBUFFER on Windows 7 if DWM transparency is off
 (the Transparency setting under Personalization > Window Color).
 
 
-@subsubsection emptyevents_34 Empty events on X11 no longer round-trip to server
+#### Empty events on X11 no longer round-trip to server {#emptyevents_34}
 
 Events posted with @ref glfwPostEmptyEvent now use a separate unnamed pipe
 instead of sending an X11 client event to the helper window.
 
 
-@subsection deprecations_34 Deprecations in version 3.4
+### Deprecations in version 3.4 {#deprecations_34}
 
-@subsection removals_34 Removals in 3.4
+### Removals in 3.4 {#removals_34}
 
-@subsubsection vulkan_static_34 GLFW_VULKAN_STATIC CMake option has been removed
+#### GLFW_VULKAN_STATIC CMake option has been removed {#vulkan_static_34}
 
 This option was used to compile GLFW directly linked with the Vulkan loader, instead of
 using dynamic loading to get hold of `vkGetInstanceProcAddr` at initialization.  This is
@@ -209,7 +209,7 @@ have no effect.  The call to @ref glfwInitVulkanLoader can be conditionally enab
 your code by checking the @ref GLFW_VERSION_MAJOR and @ref GLFW_VERSION_MINOR macros.
 
 
-@subsubsection osmesa_option_34 GLFW_USE_OSMESA CMake option has been removed
+#### GLFW_USE_OSMESA CMake option has been removed {#osmesa_option_34}
 
 This option was used to compile GLFW for the Null platform.  The Null platform is now
 always supported.  To produce a library binary that only supports this platform, the way
@@ -221,16 +221,16 @@ You can set all of them to false and the ones that don't apply for the target OS
 ignored.
 
 
-@subsubsection wl_shell_34 Support for the wl_shell protocol has been removed
+#### Support for the wl_shell protocol has been removed {#wl_shell_34}
 
 Support for the wl_shell protocol has been removed and GLFW now only supports
 the XDG-Shell protocol.  If your Wayland compositor does not support XDG-Shell
 then GLFW will fail to initialize.
 
 
-@subsection symbols_34 New symbols in version 3.4
+### New symbols in version 3.4 {#symbols_34}
 
-@subsubsection functions_34 New functions in version 3.4
+#### New functions in version 3.4 {#functions_34}
 
  - @ref glfwInitAllocator
  - @ref glfwGetPlatform
@@ -238,7 +238,7 @@ then GLFW will fail to initialize.
  - @ref glfwInitVulkanLoader
 
 
-@subsubsection types_34 New types in version 3.4
+#### New types in version 3.4 {#types_34}
 
  - @ref GLFWallocator
  - @ref GLFWallocatefun
@@ -246,7 +246,7 @@ then GLFW will fail to initialize.
  - @ref GLFWdeallocatefun
 
 
-@subsubsection constants_34 New constants in version 3.4
+#### New constants in version 3.4 {#constants_34}
 
  - @ref GLFW_PLATFORM
  - @ref GLFW_ANY_PLATFORM
@@ -289,7 +289,7 @@ then GLFW will fail to initialize.
  - @ref GLFW_WAYLAND_DISABLE_LIBDECOR
 
 
-@section news_archive Release notes for earlier versions
+## Release notes for earlier versions {#news_archive}
 
 - [Release notes for 3.3](https://www.glfw.org/docs/3.3/news.html)
 - [Release notes for 3.2](https://www.glfw.org/docs/3.2/news.html)