eden-emu/SDL
15
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-05-31 17:07:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

main: Make the main callback return value symbols smaller (thanks, @Lzard!).

Browse source 
Reference #9901.
This commit is contained in:
Ryan C. Gordon 2024-05-27 16:03:45 -04:00
parent ef5d56de51
commit 3364aff757
No known key found for this signature in database
GPG key ID: FA148B892AB48044
8 changed files with 85 additions and 85 deletions
Download patch file Download diff file Expand all files Collapse all files

42
include/SDL3/SDL_main.h
View file

@ -224,7 +224,7 @@ typedef void (SDLCALL *SDL_AppQuit_func)(void *appstate);
*
* \since This macro is available since SDL 3.0.0.
*/
#define SDL_MAIN_CALLBACK_CONTINUE 0
#define SDL_APP_CONTINUE 0
/**
* Value that requests termination with error from the main callbacks.
@ -239,7 +239,7 @@ typedef void (SDLCALL *SDL_AppQuit_func)(void *appstate);
*
* \since This macro is available since SDL 3.0.0.
*/
#define SDL_MAIN_CALLBACK_EXIT_FAILURE -1
#define SDL_APP_FAILURE -1
/**
* Value that requests termination with success from the main callbacks.
@ -254,7 +254,7 @@ typedef void (SDLCALL *SDL_AppQuit_func)(void *appstate);
*
* \since This macro is available since SDL 3.0.0.
*/
#define SDL_MAIN_CALLBACK_EXIT_SUCCESS 1
#define SDL_APP_SUCCESS 1
/**
@ -277,12 +277,12 @@ typedef void (SDLCALL *SDL_AppQuit_func)(void *appstate);
* to use a global variable. If this isn't set, the pointer will be NULL in
* future entry points.
*
* If this function returns SDL_MAIN_CALLBACK_CONTINUE, the app will proceed
* If this function returns SDL_APP_CONTINUE, the app will proceed
* to normal operation, and will begin receiving repeated calls to
* SDL_AppIterate and SDL_AppEvent for the life of the program. If this
* function returns SDL_MAIN_CALLBACK_EXIT_FAILURE, SDL will call SDL_AppQuit
* function returns SDL_APP_FAILURE, SDL will call SDL_AppQuit
* and terminate the process with an exit code that reports an error to the
* platform. If it returns SDL_MAIN_CALLBACK_EXIT_SUCCESS, SDL calls
* platform. If it returns SDL_APP_SUCCESS, SDL calls
* SDL_AppQuit and terminates with an exit code that reports success to the
* platform.
*
@ -291,9 +291,9 @@ typedef void (SDLCALL *SDL_AppQuit_func)(void *appstate);
* \param argc The standard ANSI C main's argc; number of elements in `argv`
* \param argv The standard ANSI C main's argv; array of command line
* arguments.
* \returns SDL_MAIN_CALLBACK_EXIT_FAILURE to terminate with an error,
* SDL_MAIN_CALLBACK_EXIT_SUCCESS to terminate with success,
* SDL_MAIN_CALLBACK_CONTINUE to continue.
* \returns SDL_APP_FAILURE to terminate with an error,
* SDL_APP_SUCCESS to terminate with success,
* SDL_APP_CONTINUE to continue.
*
* \threadsafety This function is not thread safe.
*
@ -332,18 +332,18 @@ extern SDLMAIN_DECLSPEC int SDLCALL SDL_AppInit(void **appstate, int argc, char
* The `appstate` parameter is an optional pointer provided by the app during
* SDL_AppInit(). If the app never provided a pointer, this will be NULL.
*
* If this function returns SDL_MAIN_CALLBACK_CONTINUE, the app will continue
* If this function returns SDL_APP_CONTINUE, the app will continue
* normal operation, receiving repeated calls to SDL_AppIterate and
* SDL_AppEvent for the life of the program. If this function returns
* SDL_MAIN_CALLBACK_EXIT_FAILURE, SDL will call SDL_AppQuit and terminate the
* SDL_APP_FAILURE, SDL will call SDL_AppQuit and terminate the
* process with an exit code that reports an error to the platform. If it
* returns SDL_MAIN_CALLBACK_EXIT_SUCCESS, SDL calls SDL_AppQuit and
* returns SDL_APP_SUCCESS, SDL calls SDL_AppQuit and
* terminates with an exit code that reports success to the platform.
*
* \param appstate an optional pointer, provided by the app in SDL_AppInit.
* \returns SDL_MAIN_CALLBACK_EXIT_FAILURE to terminate with an error,
* SDL_MAIN_CALLBACK_EXIT_SUCCESS to terminate with success,
* SDL_MAIN_CALLBACK_CONTINUE to continue.
* \returns SDL_APP_FAILURE to terminate with an error,
* SDL_APP_SUCCESS to terminate with success,
* SDL_APP_CONTINUE to continue.
*
* \threadsafety This function is not thread safe.
*
@ -379,19 +379,19 @@ extern SDLMAIN_DECLSPEC int SDLCALL SDL_AppIterate(void *appstate);
* The `appstate` parameter is an optional pointer provided by the app during
* SDL_AppInit(). If the app never provided a pointer, this will be NULL.
*
* If this function returns SDL_MAIN_CALLBACK_CONTINUE, the app will continue
* If this function returns SDL_APP_CONTINUE, the app will continue
* normal operation, receiving repeated calls to SDL_AppIterate and
* SDL_AppEvent for the life of the program. If this function returns
* SDL_MAIN_CALLBACK_EXIT_FAILURE, SDL will call SDL_AppQuit and terminate the
* SDL_APP_FAILURE, SDL will call SDL_AppQuit and terminate the
* process with an exit code that reports an error to the platform. If it
* returns SDL_MAIN_CALLBACK_EXIT_SUCCESS, SDL calls SDL_AppQuit and
* returns SDL_APP_SUCCESS, SDL calls SDL_AppQuit and
* terminates with an exit code that reports success to the platform.
*
* \param appstate an optional pointer, provided by the app in SDL_AppInit.
* \param event the new event for the app to examine.
* \returns SDL_MAIN_CALLBACK_EXIT_FAILURE to terminate with an error,
* SDL_MAIN_CALLBACK_EXIT_SUCCESS to terminate with success,
* SDL_MAIN_CALLBACK_CONTINUE to continue.
* \returns SDL_APP_FAILURE to terminate with an error,
* SDL_APP_SUCCESS to terminate with success,
* SDL_APP_CONTINUE to continue.
*
* \threadsafety This function is not thread safe.
*