diff --git a/docs/Doxyfile.in b/docs/Doxyfile.in index 067619c7..27c4b3f6 100644 --- a/docs/Doxyfile.in +++ b/docs/Doxyfile.in @@ -278,13 +278,7 @@ ALIASES = "thread_safety=@par Thread safety^^" \ "analysis=@par Analysis^^" \ "reentrancy=@par Reentrancy^^" \ "errors=@par Errors^^" \ - "callback_signature=@par Callback signature^^" \ - "glfw3=__GLFW 3:__" \ - "x11=__X11:__" \ - "wayland=__Wayland:__" \ - "win32=__Windows:__" \ - "macos=__macOS:__" \ - "linux=__Linux:__" + "callback_signature=@par Callback signature^^" # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources # only. Doxygen will then generate output that is more tailored for C. For diff --git a/docs/intro.md b/docs/intro.md index f2060c33..e09989e0 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -63,7 +63,7 @@ before the application exits. Modern systems are very good at freeing resources allocated by programs that exit, but GLFW sometimes has to change global system settings and these might not be restored without termination. -@macos When the library is initialized the main menu and dock icon are created. +__macOS:__ When the library is initialized the main menu and dock icon are created. These are not desirable for a command-line only program. The creation of the main menu and dock icon can be disabled with the @ref GLFW_COCOA_MENUBAR init hint. diff --git a/docs/monitor.md b/docs/monitor.md index df5fda9a..8e01a8f2 100644 --- a/docs/monitor.md +++ b/docs/monitor.md @@ -255,7 +255,7 @@ hardware gamma correction, which today is typically an approximation of sRGB gamma. This means that setting a perfectly linear ramp, or gamma 1.0, will produce the default (usually sRGB-like) behavior. -@note @wayland An application cannot read or modify the monitor gamma ramp. The -@ref glfwGetGammaRamp, @ref glfwSetGammaRamp and @ref glfwSetGamma functions +@note __Wayland:__ An application cannot read or modify the monitor gamma ramp. +The @ref glfwGetGammaRamp, @ref glfwSetGammaRamp and @ref glfwSetGamma functions emit @ref GLFW_FEATURE_UNAVAILABLE. diff --git a/docs/vulkan.md b/docs/vulkan.md index cb67302f..48fa79fd 100644 --- a/docs/vulkan.md +++ b/docs/vulkan.md @@ -35,7 +35,7 @@ By default, GLFW will load the Vulkan loader dynamically at runtime via its stan `vulkan-1.dll` on Windows, `libvulkan.so.1` on Linux and other Unix-like systems and `libvulkan.1.dylib` on macOS. -@macos GLFW will also look up and search the `Frameworks` subdirectory of your +__macOS:__ GLFW will also look up and search the `Frameworks` subdirectory of your application bundle. If your code is using a Vulkan loader with a different name or in a non-standard location @@ -47,7 +47,7 @@ entry point retrieval. This prevents GLFW from dynamically loading the Vulkan l glfwInitVulkanLoader(vkGetInstanceProcAddr); ``` -@macos To make your application be redistributable you will need to set up the application +__macOS:__ To make your application be redistributable you will need to set up the application bundle according to the LunarG SDK documentation. This is explained in more detail in the [SDK documentation for macOS](https://vulkan.lunarg.com/doc/sdk/latest/mac/getting_started.html). @@ -186,7 +186,7 @@ check whether any extensions you wish to enable are already in the returned array, as it is an error to specify an extension more than once in the `VkInstanceCreateInfo` struct. -@macos MoltenVK is (as of July 2022) not yet a fully conformant implementation +__macOS:__ MoltenVK is (as of July 2022) not yet a fully conformant implementation of Vulkan. As of Vulkan SDK 1.3.216.0, this means you must also enable the `VK_KHR_portability_enumeration` instance extension and set the `VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR` bit in the instance creation diff --git a/docs/window.md b/docs/window.md index dd6d8a2a..2140f097 100644 --- a/docs/window.md +++ b/docs/window.md @@ -363,10 +363,10 @@ which API was used to create the current context may fail if you change this hint. This can be resolved by having it load functions via @ref glfwGetProcAddress. -@note @wayland The EGL API _is_ the native context creation API, so this hint +@note __Wayland:__ The EGL API _is_ the native context creation API, so this hint will have no effect. -@note @x11 On some Linux systems, creating contexts via both the native and EGL +@note __X11:__ On some Linux systems, creating contexts via both the native and EGL APIs in a single process will cause the application to segfault. Stick to one API or the other on Linux for now. @@ -400,7 +400,7 @@ requested. Additionally, OpenGL ES 1.x cannot be returned if 2.0 or later was requested, and vice versa. This is because OpenGL ES 3.x is backward compatible with 2.0, but OpenGL ES 2.0 is not backward compatible with 1.x. -@note @macos The OS only supports core profile contexts for OpenGL versions 3.2 +@note __macOS:__ The OS only supports core profile contexts for OpenGL versions 3.2 and later. Before creating an OpenGL context of version 3.2 or later you must set the [GLFW_OPENGL_PROFILE](@ref GLFW_OPENGL_PROFILE_hint) hint accordingly. OpenGL 3.0 and 3.1 contexts are not supported at all on macOS. @@ -893,7 +893,7 @@ int xpos, ypos; glfwGetWindowPos(window, &xpos, &ypos); ``` -@note @wayland An applications cannot know the positions of its windows or +@note __Wayland:__ An applications cannot know the positions of its windows or whether one has been moved. The @ref GLFW_POSITION_X and @ref GLFW_POSITION_Y window hints are ignored. The @ref glfwGetWindowPos and @ref glfwSetWindowPos functions emit @ref GLFW_FEATURE_UNAVAILABLE. The window position callback will @@ -1044,7 +1044,7 @@ You can also get the current iconification state with @ref glfwGetWindowAttrib. int iconified = glfwGetWindowAttrib(window, GLFW_ICONIFIED); ``` -@note @wayland An application cannot know if any of its windows have been +@note __Wayland:__ An application cannot know if any of its windows have been iconified or restore one from iconification. The @ref glfwRestoreWindow function can only restore windows from maximization and the iconify callback will not be called. The [GLFW_ICONIFIED](@ref GLFW_ICONIFIED_attrib) attribute diff --git a/include/GLFW/glfw3.h b/include/GLFW/glfw3.h index b0ce7f66..3ce1c019 100644 --- a/include/GLFW/glfw3.h +++ b/include/GLFW/glfw3.h @@ -1228,13 +1228,13 @@ extern "C" { * The top-left to bottom-right diagonal resize/move shape. This is usually * a diagonal double-headed arrow. * - * @note @macos This shape is provided by a private system API and may fail + * @note __macOS:__ This shape is provided by a private system API and may fail * with @ref GLFW_CURSOR_UNAVAILABLE in the future. * - * @note @wayland This shape is provided by a newer standard not supported by + * @note __Wayland:__ This shape is provided by a newer standard not supported by * all cursor themes. * - * @note @x11 This shape is provided by a newer standard not supported by all + * @note __X11:__ This shape is provided by a newer standard not supported by all * cursor themes. */ #define GLFW_RESIZE_NWSE_CURSOR 0x00036007 @@ -1243,13 +1243,13 @@ extern "C" { * The top-right to bottom-left diagonal resize/move shape. This is usually * a diagonal double-headed arrow. * - * @note @macos This shape is provided by a private system API and may fail + * @note __macOS:__ This shape is provided by a private system API and may fail * with @ref GLFW_CURSOR_UNAVAILABLE in the future. * - * @note @wayland This shape is provided by a newer standard not supported by + * @note __Wayland:__ This shape is provided by a newer standard not supported by * all cursor themes. * - * @note @x11 This shape is provided by a newer standard not supported by all + * @note __X11:__ This shape is provided by a newer standard not supported by all * cursor themes. */ #define GLFW_RESIZE_NESW_CURSOR 0x00036008 @@ -1264,10 +1264,10 @@ extern "C" { * The operation-not-allowed shape. This is usually a circle with a diagonal * line through it. * - * @note @wayland This shape is provided by a newer standard not supported by + * @note __Wayland:__ This shape is provided by a newer standard not supported by * all cursor themes. * - * @note @x11 This shape is provided by a newer standard not supported by all + * @note __X11:__ This shape is provided by a newer standard not supported by all * cursor themes. */ #define GLFW_NOT_ALLOWED_CURSOR 0x0003600A @@ -1629,7 +1629,7 @@ typedef void (* GLFWwindowposfun)(GLFWwindow* window, int xpos, int ypos); * @sa @ref glfwSetWindowSizeCallback * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -1649,7 +1649,7 @@ typedef void (* GLFWwindowsizefun)(GLFWwindow* window, int width, int height); * @sa @ref glfwSetWindowCloseCallback * * @since Added in version 2.5. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -1669,7 +1669,7 @@ typedef void (* GLFWwindowclosefun)(GLFWwindow* window); * @sa @ref glfwSetWindowRefreshCallback * * @since Added in version 2.5. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -1800,7 +1800,7 @@ typedef void (* GLFWwindowcontentscalefun)(GLFWwindow* window, float xscale, flo * @sa @ref glfwSetMouseButtonCallback * * @since Added in version 1.0. - * @glfw3 Added window handle and modifier mask parameters. + * __GLFW 3:__ Added window handle and modifier mask parameters. * * @ingroup input */ @@ -1891,7 +1891,7 @@ typedef void (* GLFWscrollfun)(GLFWwindow* window, double xoffset, double yoffse * @sa @ref glfwSetKeyCallback * * @since Added in version 1.0. - * @glfw3 Added window handle, scancode and modifier mask parameters. + * __GLFW 3:__ Added window handle, scancode and modifier mask parameters. * * @ingroup input */ @@ -1912,7 +1912,7 @@ typedef void (* GLFWkeyfun)(GLFWwindow* window, int key, int scancode, int actio * @sa @ref glfwSetCharCallback * * @since Added in version 2.4. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup input */ @@ -2020,7 +2020,7 @@ typedef void (* GLFWjoystickfun)(int jid, int event); * @sa @ref glfwGetVideoModes * * @since Added in version 1.0. - * @glfw3 Added refresh rate member. + * __GLFW 3:__ Added refresh rate member. * * @ingroup monitor */ @@ -2083,7 +2083,7 @@ typedef struct GLFWgammaramp * @sa @ref window_icon * * @since Added in version 2.1. - * @glfw3 Removed format and bytes-per-pixel members. + * __GLFW 3:__ Removed format and bytes-per-pixel members. * * @ingroup window */ @@ -2183,12 +2183,12 @@ typedef struct GLFWallocator * @errors Possible errors include @ref GLFW_PLATFORM_UNAVAILABLE and @ref * GLFW_PLATFORM_ERROR. * - * @remark @macos This function will change the current directory of the + * @remark __macOS:__ This function will change the current directory of the * application to the `Contents/Resources` subdirectory of the application's * bundle, if present. This can be disabled with the @ref * GLFW_COCOA_CHDIR_RESOURCES init hint. * - * @remark @macos This function will create the main menu and dock icon for the + * @remark __macOS:__ This function will create the main menu and dock icon for the * application. If GLFW finds a `MainMenu.nib` it is loaded and assumed to * contain a menu bar. Otherwise a minimal menu bar is created manually with * common commands like Hide, Quit and About. The About entry opens a minimal @@ -2203,7 +2203,7 @@ typedef struct GLFWallocator * to something other than `wayland` or `x11`, the regular detection mechanism * will be used instead. * - * @remark @x11 This function will set the `LC_CTYPE` category of the + * @remark __X11:__ This function will set the `LC_CTYPE` category of the * application locale according to the current environment if that category is * still "C". This is because the "C" locale breaks Unicode text input. * @@ -2679,7 +2679,7 @@ GLFWAPI void glfwGetMonitorWorkarea(GLFWmonitor* monitor, int* xpos, int* ypos, * * @errors Possible errors include @ref GLFW_NOT_INITIALIZED. * - * @remark @win32 On Windows 8 and earlier the physical size is calculated from + * @remark __Win32:__ On Windows 8 and earlier the physical size is calculated from * the current resolution and system DPI instead of querying the monitor EDID data. * * @thread_safety This function must only be called from the main thread. @@ -2713,7 +2713,7 @@ GLFWAPI void glfwGetMonitorPhysicalSize(GLFWmonitor* monitor, int* widthMM, int* * @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref * GLFW_PLATFORM_ERROR. * - * @remark @wayland Fractional scaling information is not yet available for + * @remark __Wayland:__ Fractional scaling information is not yet available for * monitors, so this function only returns integer content scales. * * @thread_safety This function must only be called from the main thread. @@ -2861,7 +2861,7 @@ GLFWAPI GLFWmonitorfun glfwSetMonitorCallback(GLFWmonitorfun callback); * @sa @ref glfwGetVideoMode * * @since Added in version 1.0. - * @glfw3 Changed to return an array of modes for a specific monitor. + * __GLFW 3:__ Changed to return an array of modes for a specific monitor. * * @ingroup monitor */ @@ -2915,7 +2915,7 @@ GLFWAPI const GLFWvidmode* glfwGetVideoMode(GLFWmonitor* monitor); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref GLFW_INVALID_VALUE, * @ref GLFW_PLATFORM_ERROR and @ref GLFW_FEATURE_UNAVAILABLE (see remarks). * - * @remark @wayland Monitor gamma is a privileged protocol, so this function + * @remark __Wayland:__ Monitor gamma is a privileged protocol, so this function * cannot be implemented and emits @ref GLFW_FEATURE_UNAVAILABLE. * * @thread_safety This function must only be called from the main thread. @@ -2939,7 +2939,7 @@ GLFWAPI void glfwSetGamma(GLFWmonitor* monitor, float gamma); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref GLFW_PLATFORM_ERROR * and @ref GLFW_FEATURE_UNAVAILABLE (see remarks). * - * @remark @wayland Monitor gamma is a privileged protocol, so this function + * @remark __Wayland:__ Monitor gamma is a privileged protocol, so this function * cannot be implemented and emits @ref GLFW_FEATURE_UNAVAILABLE while * returning `NULL`. * @@ -2981,9 +2981,9 @@ GLFWAPI const GLFWgammaramp* glfwGetGammaRamp(GLFWmonitor* monitor); * @remark The size of the specified gamma ramp should match the size of the * current ramp for that monitor. * - * @remark @win32 The gamma ramp size must be 256. + * @remark __Win32:__ The gamma ramp size must be 256. * - * @remark @wayland Monitor gamma is a privileged protocol, so this function + * @remark __Wayland:__ Monitor gamma is a privileged protocol, so this function * cannot be implemented and emits @ref GLFW_FEATURE_UNAVAILABLE. * * @pointer_lifetime The specified gamma ramp is copied before this function @@ -3159,32 +3159,32 @@ GLFWAPI void glfwWindowHintString(int hint, const char* value); * GLFW_VERSION_UNAVAILABLE, @ref GLFW_FORMAT_UNAVAILABLE, @ref * GLFW_NO_WINDOW_CONTEXT and @ref GLFW_PLATFORM_ERROR. * - * @remark @win32 Window creation will fail if the Microsoft GDI software + * @remark __Win32:__ Window creation will fail if the Microsoft GDI software * OpenGL implementation is the only one available. * - * @remark @win32 If the executable has an icon resource named `GLFW_ICON,` it + * @remark __Win32:__ If the executable has an icon resource named `GLFW_ICON,` it * will be set as the initial icon for the window. If no such icon is present, * the `IDI_APPLICATION` icon will be used instead. To set a different icon, * see @ref glfwSetWindowIcon. * - * @remark @win32 The context to share resources with must not be current on + * @remark __Win32:__ The context to share resources with must not be current on * any other thread. * - * @remark @macos The OS only supports core profile contexts for OpenGL + * @remark __macOS:__ The OS only supports core profile contexts for OpenGL * versions 3.2 and later. Before creating an OpenGL context of version 3.2 or * later you must set the [GLFW_OPENGL_PROFILE](@ref GLFW_OPENGL_PROFILE_hint) * hint accordingly. OpenGL 3.0 and 3.1 contexts are not supported at all * on macOS. * - * @remark @macos The GLFW window has no icon, as it is not a document + * @remark __macOS:__ The GLFW window has no icon, as it is not a document * window, but the dock icon will be the same as the application bundle's icon. * For more information on bundles, see the * [Bundle Programming Guide][bundle-guide] in the Mac Developer Library. * * [bundle-guide]: https://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/ * - * @remark @macos The window frame will not be rendered at full resolution on - * Retina displays unless the + * @remark __macOS:__ The window frame will not be rendered at full resolution + * on Retina displays unless the * [GLFW_SCALE_FRAMEBUFFER](@ref GLFW_SCALE_FRAMEBUFFER_hint) * hint is `GLFW_TRUE` and the `NSHighResolutionCapable` key is enabled in the * application bundle's `Info.plist`. For more information, see @@ -3195,11 +3195,11 @@ GLFWAPI void glfwWindowHintString(int hint, const char* value); * * [hidpi-guide]: https://developer.apple.com/library/mac/documentation/GraphicsAnimation/Conceptual/HighResolutionOSX/Explained/Explained.html * - * @remark @macos When activating frame autosaving with + * @remark __macOS:__ When activating frame autosaving with * [GLFW_COCOA_FRAME_NAME](@ref GLFW_COCOA_FRAME_NAME_hint), the specified * window size and position may be overridden by previously saved values. * - * @remark @wayland GLFW uses [libdecor][] where available to create its window + * @remark __Wayland:__ GLFW uses [libdecor][] where available to create its window * decorations. This in turn uses server-side XDG decorations where available * and provides high quality client-side decorations on compositors like GNOME. * If both XDG decorations and libdecor are unavailable, GLFW falls back to @@ -3208,15 +3208,15 @@ GLFWAPI void glfwWindowHintString(int hint, const char* value); * * [libdecor]: https://gitlab.freedesktop.org/libdecor/libdecor * - * @remark @x11 Some window managers will not respect the placement of + * @remark __X11:__ Some window managers will not respect the placement of * initially hidden windows. * - * @remark @x11 Due to the asynchronous nature of X11, it may take a moment for + * @remark __X11:__ Due to the asynchronous nature of X11, it may take a moment for * a window to reach its requested state. This means you may not be able to * query the final size, position or other attributes directly after window * creation. * - * @remark @x11 The class part of the `WM_CLASS` window property will by + * @remark __X11:__ The class part of the `WM_CLASS` window property will by * default be set to the window title passed to this function. The instance * part will use the contents of the `RESOURCE_NAME` environment variable, if * present and not empty, or fall back to the window title. Set the @@ -3349,7 +3349,7 @@ GLFWAPI const char* glfwGetWindowTitle(GLFWwindow* window); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref * GLFW_PLATFORM_ERROR. * - * @remark @macos The window title will not be updated until the next time you + * @remark __macOS:__ The window title will not be updated until the next time you * process events. * * @thread_safety This function must only be called from the main thread. @@ -3358,7 +3358,7 @@ GLFWAPI const char* glfwGetWindowTitle(GLFWwindow* window); * @sa @ref glfwGetWindowTitle * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -3392,14 +3392,14 @@ GLFWAPI void glfwSetWindowTitle(GLFWwindow* window, const char* title); * @pointer_lifetime The specified image data is copied before this function * returns. * - * @remark @macos Regular windows do not have icons on macOS. This function + * @remark __macOS:__ Regular windows do not have icons on macOS. This function * will emit @ref GLFW_FEATURE_UNAVAILABLE. The dock icon will be the same as * the application bundle's icon. For more information on bundles, see the * [Bundle Programming Guide][bundle-guide] in the Mac Developer Library. * * [bundle-guide]: https://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/ * - * @remark @wayland There is no existing protocol to change an icon, the + * @remark __Wayland:__ There is no existing protocol to change an icon, the * window will thus inherit the one defined in the application's desktop file. * This function will emit @ref GLFW_FEATURE_UNAVAILABLE. * @@ -3430,7 +3430,7 @@ GLFWAPI void glfwSetWindowIcon(GLFWwindow* window, int count, const GLFWimage* i * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref * GLFW_PLATFORM_ERROR and @ref GLFW_FEATURE_UNAVAILABLE (see remarks). * - * @remark @wayland Window positions are not currently part of any common + * @remark __Wayland:__ Window positions are not currently part of any common * Wayland protocol, so this function cannot be implemented and will emit @ref * GLFW_FEATURE_UNAVAILABLE. * @@ -3464,7 +3464,7 @@ GLFWAPI void glfwGetWindowPos(GLFWwindow* window, int* xpos, int* ypos); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref * GLFW_PLATFORM_ERROR and @ref GLFW_FEATURE_UNAVAILABLE (see remarks). * - * @remark @wayland Window positions are not currently part of any common + * @remark __Wayland:__ Window positions are not currently part of any common * Wayland protocol, so this function cannot be implemented and will emit @ref * GLFW_FEATURE_UNAVAILABLE. * @@ -3474,7 +3474,7 @@ GLFWAPI void glfwGetWindowPos(GLFWwindow* window, int* xpos, int* ypos); * @sa @ref glfwGetWindowPos * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -3504,7 +3504,7 @@ GLFWAPI void glfwSetWindowPos(GLFWwindow* window, int xpos, int ypos); * @sa @ref glfwSetWindowSize * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -3539,7 +3539,7 @@ GLFWAPI void glfwGetWindowSize(GLFWwindow* window, int* width, int* height); * @remark If you set size limits and an aspect ratio that conflict, the * results are undefined. * - * @remark @wayland The size limits will not be applied until the window is + * @remark __Wayland:__ The size limits will not be applied until the window is * actually resized, either by the user or by the compositor. * * @thread_safety This function must only be called from the main thread. @@ -3582,7 +3582,7 @@ GLFWAPI void glfwSetWindowSizeLimits(GLFWwindow* window, int minwidth, int minhe * @remark If you set size limits and an aspect ratio that conflict, the * results are undefined. * - * @remark @wayland The aspect ratio will not be applied until the window is + * @remark __Wayland:__ The aspect ratio will not be applied until the window is * actually resized, either by the user or by the compositor. * * @thread_safety This function must only be called from the main thread. @@ -3628,7 +3628,7 @@ GLFWAPI void glfwSetWindowAspectRatio(GLFWwindow* window, int numer, int denom); * @sa @ref glfwSetWindowMonitor * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -3778,7 +3778,7 @@ GLFWAPI float glfwGetWindowOpacity(GLFWwindow* window); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref * GLFW_PLATFORM_ERROR and @ref GLFW_FEATURE_UNAVAILABLE (see remarks). * - * @remark @wayland There is no way to set an opacity factor for a window. + * @remark __Wayland:__ There is no way to set an opacity factor for a window. * This function will emit @ref GLFW_FEATURE_UNAVAILABLE. * * @thread_safety This function must only be called from the main thread. @@ -3814,7 +3814,7 @@ GLFWAPI void glfwSetWindowOpacity(GLFWwindow* window, float opacity); * @sa @ref glfwMaximizeWindow * * @since Added in version 2.1. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -3834,9 +3834,9 @@ GLFWAPI void glfwIconifyWindow(GLFWwindow* window); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref * GLFW_PLATFORM_ERROR. * - * @remark @wayland Restoring a window from maximization is not currently part - * of any common Wayland protocol, so this function can only restore windows - * from maximization. + * @remark __Wayland:__ Restoring a window from maximization is not currently + * part of any common Wayland protocol, so this function can only restore + * windows from maximization. * * @thread_safety This function must only be called from the main thread. * @@ -3845,7 +3845,7 @@ GLFWAPI void glfwIconifyWindow(GLFWwindow* window); * @sa @ref glfwMaximizeWindow * * @since Added in version 2.1. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -3892,7 +3892,7 @@ GLFWAPI void glfwMaximizeWindow(GLFWwindow* window); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref * GLFW_PLATFORM_ERROR. * - * @remark @wayland Because Wayland wants every frame of the desktop to be + * @remark __Wayland:__ Because Wayland wants every frame of the desktop to be * complete, this function does not immediately make the window visible. * Instead it will become visible the next time the window framebuffer is * updated after this call. @@ -3955,7 +3955,7 @@ GLFWAPI void glfwHideWindow(GLFWwindow* window); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref * GLFW_PLATFORM_ERROR. * - * @remark @wayland The compositor will likely ignore focus requests unless + * @remark __Wayland:__ The compositor will likely ignore focus requests unless * another window created by the same application already has input focus. * * @thread_safety This function must only be called from the main thread. @@ -3983,7 +3983,7 @@ GLFWAPI void glfwFocusWindow(GLFWwindow* window); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref * GLFW_PLATFORM_ERROR. * - * @remark @macos Attention is requested to the application as a whole, not the + * @remark __macOS:__ Attention is requested to the application as a whole, not the * specific window. * * @thread_safety This function must only be called from the main thread. @@ -4058,7 +4058,7 @@ GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* window); * affected by any resizing or mode switching, although you may need to update * your viewport if the framebuffer size has changed. * - * @remark @wayland Window positions are not currently part of any common + * @remark __Wayland:__ Window positions are not currently part of any common * Wayland protocol. The window position arguments are ignored. * * @thread_safety This function must only be called from the main thread. @@ -4096,7 +4096,7 @@ GLFWAPI void glfwSetWindowMonitor(GLFWwindow* window, GLFWmonitor* monitor, int * errors. However, this function should not fail as long as it is passed * valid arguments and the library has been [initialized](@ref intro_init). * - * @remark @wayland Checking whether a window is iconified is not currently + * @remark __Wayland:__ Checking whether a window is iconified is not currently * part of any common Wayland protocol, so the @ref GLFW_ICONIFIED attribute * cannot be implemented and is always `GLFW_FALSE`. * @@ -4140,7 +4140,7 @@ GLFWAPI int glfwGetWindowAttrib(GLFWwindow* window, int attrib); * @remark Calling @ref glfwGetWindowAttrib will always return the latest * value, even if that value is ignored by the current mode of the window. * - * @remark @wayland The [GLFW_FLOATING](@ref GLFW_FLOATING_attrib) window attribute is + * @remark __Wayland:__ The [GLFW_FLOATING](@ref GLFW_FLOATING_attrib) window attribute is * not supported. Setting this will emit @ref GLFW_FEATURE_UNAVAILABLE. * * @thread_safety This function must only be called from the main thread. @@ -4220,7 +4220,7 @@ GLFWAPI void* glfwGetWindowUserPointer(GLFWwindow* window); * * @errors Possible errors include @ref GLFW_NOT_INITIALIZED. * - * @remark @wayland This callback will not be called. The Wayland protocol + * @remark __Wayland:__ This callback will not be called. The Wayland protocol * provides no way to be notified of when a window is moved. * * @thread_safety This function must only be called from the main thread. @@ -4259,7 +4259,7 @@ GLFWAPI GLFWwindowposfun glfwSetWindowPosCallback(GLFWwindow* window, GLFWwindow * @sa @ref window_size * * @since Added in version 1.0. - * @glfw3 Added window handle parameter and return value. + * __GLFW 3:__ Added window handle parameter and return value. * * @ingroup window */ @@ -4291,7 +4291,7 @@ GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwind * * @errors Possible errors include @ref GLFW_NOT_INITIALIZED. * - * @remark @macos Selecting Quit from the application menu will trigger the + * @remark __macOS:__ Selecting Quit from the application menu will trigger the * close callback for all windows. * * @thread_safety This function must only be called from the main thread. @@ -4299,7 +4299,7 @@ GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwind * @sa @ref window_close * * @since Added in version 2.5. - * @glfw3 Added window handle parameter and return value. + * __GLFW 3:__ Added window handle parameter and return value. * * @ingroup window */ @@ -4335,7 +4335,7 @@ GLFWAPI GLFWwindowclosefun glfwSetWindowCloseCallback(GLFWwindow* window, GLFWwi * @sa @ref window_refresh * * @since Added in version 2.5. - * @glfw3 Added window handle parameter and return value. + * __GLFW 3:__ Added window handle parameter and return value. * * @ingroup window */ @@ -4396,7 +4396,7 @@ GLFWAPI GLFWwindowfocusfun glfwSetWindowFocusCallback(GLFWwindow* window, GLFWwi * * @errors Possible errors include @ref GLFW_NOT_INITIALIZED. * - * @remark @wayland This callback will not be called. The Wayland protocol + * @remark __Wayland:__ This callback will not be called. The Wayland protocol * provides no way to be notified of when a window is iconified, and no way to * check whether a window is currently iconified. * @@ -4905,7 +4905,7 @@ GLFWAPI int glfwGetKeyScancode(int key); * @sa @ref input_key * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup input */ @@ -4937,7 +4937,7 @@ GLFWAPI int glfwGetKey(GLFWwindow* window, int key); * @sa @ref input_mouse_button * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup input */ @@ -5007,7 +5007,7 @@ GLFWAPI void glfwGetCursorPos(GLFWwindow* window, double* xpos, double* ypos); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref * GLFW_PLATFORM_ERROR and @ref GLFW_FEATURE_UNAVAILABLE (see remarks). * - * @remark @wayland This function will only work when the cursor mode is + * @remark __Wayland:__ This function will only work when the cursor mode is * `GLFW_CURSOR_DISABLED`, otherwise it will emit @ref GLFW_FEATURE_UNAVAILABLE. * * @thread_safety This function must only be called from the main thread. @@ -5205,7 +5205,7 @@ GLFWAPI void glfwSetCursor(GLFWwindow* window, GLFWcursor* cursor); * @sa @ref input_key * * @since Added in version 1.0. - * @glfw3 Added window handle parameter and return value. + * __GLFW 3:__ Added window handle parameter and return value. * * @ingroup input */ @@ -5248,7 +5248,7 @@ GLFWAPI GLFWkeyfun glfwSetKeyCallback(GLFWwindow* window, GLFWkeyfun callback); * @sa @ref input_char * * @since Added in version 2.4. - * @glfw3 Added window handle parameter and return value. + * __GLFW 3:__ Added window handle parameter and return value. * * @ingroup input */ @@ -5332,7 +5332,7 @@ GLFWAPI GLFWcharmodsfun glfwSetCharModsCallback(GLFWwindow* window, GLFWcharmods * @sa @ref input_mouse_button * * @since Added in version 1.0. - * @glfw3 Added window handle parameter and return value. + * __GLFW 3:__ Added window handle parameter and return value. * * @ingroup input */ @@ -5562,7 +5562,7 @@ GLFWAPI const float* glfwGetJoystickAxes(int jid, int* count); * @sa @ref joystick_button * * @since Added in version 2.2. - * @glfw3 Changed to return a dynamic array. + * __GLFW 3:__ Changed to return a dynamic array. * * @ingroup input */ @@ -5926,7 +5926,7 @@ GLFWAPI int glfwGetGamepadState(int jid, GLFWgamepadstate* state); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref * GLFW_PLATFORM_ERROR. * - * @remark @win32 The clipboard on Windows has a single global lock for reading and + * @remark __Win32:__ The clipboard on Windows has a single global lock for reading and * writing. GLFW tries to acquire it a few times, which is almost always enough. If it * cannot acquire the lock then this function emits @ref GLFW_PLATFORM_ERROR and returns. * It is safe to try this multiple times. @@ -5959,7 +5959,7 @@ GLFWAPI void glfwSetClipboardString(GLFWwindow* window, const char* string); * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref * GLFW_FORMAT_UNAVAILABLE and @ref GLFW_PLATFORM_ERROR. * - * @remark @win32 The clipboard on Windows has a single global lock for reading and + * @remark __Win32:__ The clipboard on Windows has a single global lock for reading and * writing. GLFW tries to acquire it a few times, which is almost always enough. If it * cannot acquire the lock then this function emits @ref GLFW_PLATFORM_ERROR and returns. * It is safe to try this multiple times. @@ -6176,7 +6176,7 @@ GLFWAPI GLFWwindow* glfwGetCurrentContext(void); * @sa @ref glfwSwapInterval * * @since Added in version 1.0. - * @glfw3 Added window handle parameter. + * __GLFW 3:__ Added window handle parameter. * * @ingroup window */ @@ -6443,7 +6443,7 @@ GLFWAPI GLFWvkproc glfwGetInstanceProcAddress(VkInstance instance, const char* p * @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref * GLFW_API_UNAVAILABLE and @ref GLFW_PLATFORM_ERROR. * - * @remark @macos This function currently always returns `GLFW_TRUE`, as the + * @remark __macOS:__ This function currently always returns `GLFW_TRUE`, as the * `VK_MVK_macos_surface` and `VK_EXT_metal_surface` extensions do not provide * a `vkGetPhysicalDevice*PresentationSupport` type function. * @@ -6501,15 +6501,15 @@ GLFWAPI int glfwGetPhysicalDevicePresentationSupport(VkInstance instance, VkPhys * @ref glfwVulkanSupported and @ref glfwGetRequiredInstanceExtensions should * eliminate almost all occurrences of these errors. * - * @remark @macos GLFW prefers the `VK_EXT_metal_surface` extension, with the + * @remark __macOS:__ GLFW prefers the `VK_EXT_metal_surface` extension, with the * `VK_MVK_macos_surface` extension as a fallback. The name of the selected * extension, if any, is included in the array returned by @ref * glfwGetRequiredInstanceExtensions. * - * @remark @macos This function creates and sets a `CAMetalLayer` instance for + * @remark __macOS:__ This function creates and sets a `CAMetalLayer` instance for * the window content view, which is required for MoltenVK to function. * - * @remark @x11 By default GLFW prefers the `VK_KHR_xcb_surface` extension, + * @remark __X11:__ By default GLFW prefers the `VK_KHR_xcb_surface` extension, * with the `VK_KHR_xlib_surface` extension as a fallback. You can make * `VK_KHR_xlib_surface` the preferred extension by setting the * [GLFW_X11_XCB_VULKAN_SURFACE](@ref GLFW_X11_XCB_VULKAN_SURFACE_hint) init