include: More category documentation.

Reference Issue #11847.
This commit is contained in:
Ryan C. Gordon 2025-01-20 01:37:25 -05:00
parent 642262e30e
commit 2be749b23b
No known key found for this signature in database
GPG key ID: FA148B892AB48044
2 changed files with 26 additions and 2 deletions

View file

@ -25,7 +25,19 @@
/**
* # CategoryThread
*
* SDL thread management routines.
* SDL offers cross-platform thread management functions. These are mostly
* concerned with starting threads, setting their priority, and dealing with
* their termination.
*
* In addition, there is support for Thread Local Storage (data that is unique
* to each thread, but accessed from a single key).
*
* On platforms without thread support (such as Emscripten when built without
* pthreads), these functions still exist, but things like SDL_CreateThread()
* will report failure without doing anything.
*
* If you're going to work with threads, you almost certainly need to have a
* good understanding of [CategoryMutex](CategoryMutex) as well.
*/
#include <SDL3/SDL_stdinc.h>