From 321af03ff95a25af5186542235f45bd346c9c473 Mon Sep 17 00:00:00 2001 From: Alfred Reynolds Date: Thu, 3 Jul 2014 10:22:26 -0700 Subject: [PATCH] add a comment to SDL_InitSubSystem explaining its refcounting behavior --- include/SDL.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/include/SDL.h b/include/SDL.h index a9077095fea10..848b16646f489 100644 --- a/include/SDL.h +++ b/include/SDL.h @@ -130,6 +130,12 @@ extern DECLSPEC int SDLCALL SDL_Init(Uint32 flags); /** * This function initializes specific SDL subsystems + * + * Subsystem initialization is ref-counted, you must call + * SDL_QuitSubSystem for each SDL_InitSubSystem to correctly + * shutdown a subsystem manually (or call SDL_Quit to force shutdown). + * If a subsystem is already loaded then this call will + * increase the ref-count and return. */ extern DECLSPEC int SDLCALL SDL_InitSubSystem(Uint32 flags);