Sync SDL3 wiki -> header

[ci skip]
This commit is contained in:
SDL Wiki Bot
2025-10-10 19:48:58 +00:00
parent 692c71a677
commit 4f267fc782

View File

@@ -28,8 +28,8 @@
* dynamic shared library dependencies. * dynamic shared library dependencies.
* *
* If you determine that your toolchain doesn't support dlopen notes, you can * If you determine that your toolchain doesn't support dlopen notes, you can
* disable this feature by defining `SDL_DISABLE_DLOPEN_NOTES`. You can use this * disable this feature by defining `SDL_DISABLE_DLOPEN_NOTES`. You can use
* CMake snippet to check for support: * this CMake snippet to check for support:
* *
* ```cmake * ```cmake
* set(CHECK_ELF_DLNOTES_SRC [==[ * set(CHECK_ELF_DLNOTES_SRC [==[
@@ -54,9 +54,11 @@
#define SDL_dlopennote_h #define SDL_dlopennote_h
/** /**
* Use this macro with SDL_ELF_NOTE_DLOPEN() to note that a dynamic shared library dependency is optional. * Use this macro with SDL_ELF_NOTE_DLOPEN() to note that a dynamic shared
* library dependency is optional.
* *
* Optional functionality uses the dependency, the binary will work and the dependency is only needed for full-featured installations. * Optional functionality uses the dependency, the binary will work and the
* dependency is only needed for full-featured installations.
* *
* \since This macro is available since SDL 3.4.0. * \since This macro is available since SDL 3.4.0.
* *
@@ -67,9 +69,11 @@
#define SDL_ELF_NOTE_DLOPEN_PRIORITY_SUGGESTED "suggested" #define SDL_ELF_NOTE_DLOPEN_PRIORITY_SUGGESTED "suggested"
/** /**
* Use this macro with SDL_ELF_NOTE_DLOPEN() to note that a dynamic shared library dependency is recommended. * Use this macro with SDL_ELF_NOTE_DLOPEN() to note that a dynamic shared
* library dependency is recommended.
* *
* Important functionality needs the dependency, the binary will work but in most cases the dependency should be provided. * Important functionality needs the dependency, the binary will work but in
* most cases the dependency should be provided.
* *
* \since This macro is available since SDL 3.4.0. * \since This macro is available since SDL 3.4.0.
* *
@@ -80,9 +84,11 @@
#define SDL_ELF_NOTE_DLOPEN_PRIORITY_RECOMMENDED "recommended" #define SDL_ELF_NOTE_DLOPEN_PRIORITY_RECOMMENDED "recommended"
/** /**
* Use this macro with SDL_ELF_NOTE_DLOPEN() to note that a dynamic shared library dependency is required. * Use this macro with SDL_ELF_NOTE_DLOPEN() to note that a dynamic shared
* library dependency is required.
* *
* Core functionality needs the dependency, the binary will not work if it cannot be found. * Core functionality needs the dependency, the binary will not work if it
* cannot be found.
* *
* \since This macro is available since SDL 3.4.0. * \since This macro is available since SDL 3.4.0.
* *
@@ -173,6 +179,7 @@
* ``` * ```
* *
* Or if you support multiple versions of a library, you can list them: * Or if you support multiple versions of a library, you can list them:
*
* ```c * ```c
* // Our app supports SDL1, SDL2, and SDL3 by dynamically loading them * // Our app supports SDL1, SDL2, and SDL3 by dynamically loading them
* SDL_ELF_NOTE_DLOPEN( * SDL_ELF_NOTE_DLOPEN(