SDL_revision: Added documentation.

This commit is contained in:
Ryan C. Gordon 2024-04-09 18:02:30 -04:00
parent f687e0732a
commit a15a46340f
No known key found for this signature in database
GPG Key ID: FA148B892AB48044

View File

@ -28,7 +28,21 @@
#ifndef SDL_revision_h_
#define SDL_revision_h_
#ifdef SDL_VENDOR_INFO
#ifdef SDL_WIKI_DOCUMENTATION_SECTION
/**
* This macro is a string describing the source at a particular point in development.
*
* This string is often generated from revision control's state at build time.
*
* This string can be quite complex and does not follow any standard.
* For example, it might be something like "SDL-prerelease-3.1.1-47-gf687e0732".
* It might also be user-defined at build time, so it's best to treat it as
* a clue in debugging forensics and not something the app will parse in any way.
*
* \since This macro is available since SDL 3.0.0.
*/
#define SDL_REVISION "Some arbitrary string decided at SDL build time"
#elif defined(SDL_VENDOR_INFO)
#define SDL_REVISION SDL_VENDOR_INFO
#else
#define SDL_REVISION ""