Mercurial > sdl-ios-xcode
changeset 4627:3b5f4b3a69e1
Documentation updates
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Thu, 29 Jul 2010 20:24:05 -0700 |
parents | 2cfd55c58cd9 |
children | fad859023468 |
files | include/SDL.h include/SDL_version.h src/SDL_error.c |
diffstat | 3 files changed, 12 insertions(+), 13 deletions(-) [+] |
line wrap: on
line diff
--- a/include/SDL.h Wed Jul 28 22:24:13 2010 -0700 +++ b/include/SDL.h Thu Jul 29 20:24:05 2010 -0700 @@ -139,16 +139,16 @@ extern DECLSPEC void SDLCALL SDL_QuitSubSystem(Uint32 flags); /** - * This function returns mask of the specified subsystems which have - * been initialized. + * This function returns a mask of the specified subsystems which have + * previously been initialized. * * If \c flags is 0, it returns a mask of all initialized subsystems. */ extern DECLSPEC Uint32 SDLCALL SDL_WasInit(Uint32 flags); /** - * This function cleans up all initialized subsystems and unloads the - * dynamically linked library. You should call it upon all exit conditions. + * This function cleans up all initialized subsystems. You should + * call it upon all exit conditions. */ extern DECLSPEC void SDLCALL SDL_Quit(void);
--- a/include/SDL_version.h Wed Jul 28 22:24:13 2010 -0700 +++ b/include/SDL_version.h Thu Jul 29 20:24:05 2010 -0700 @@ -112,12 +112,11 @@ /** * \brief Get the version of SDL that is linked against your program. - * - * If you are using a shared library (DLL) version of SDL, then it is - * possible that it will be different than the version you compiled against. * - * This is a real function; the macro SDL_VERSION() tells you what version - * of SDL you compiled against: + * If you are linking to SDL dynamically, then it is possible that the + * current version will be different than the version you compiled against. + * This function returns the current version, while SDL_VERSION() is a + * macro that tells you what version you compiled with. * * \code * SDL_version compiled; @@ -140,8 +139,9 @@ /** * \brief Get the code revision of SDL that is linked against your program. * - * This is an arbitrary string (a hash value, actually), and is only useful - * in comparing against other revisions. It is NOT an incrementing number. + * Returns an arbitrary string (a hash value) uniquely identifying the + * exact revision of the SDL library in use, and is only useful in comparing + * against other revisions. It is NOT an incrementing number. */ extern DECLSPEC const char *SDLCALL SDL_GetRevision(void);
--- a/src/SDL_error.c Wed Jul 28 22:24:13 2010 -0700 +++ b/src/SDL_error.c Thu Jul 29 20:24:05 2010 -0700 @@ -30,8 +30,7 @@ /* Routine to get the thread-specific error variable */ #if SDL_THREADS_DISABLED -/* !!! FIXME: what does this comment mean? Victim of Search and Replace? */ -/* The SDL_arraysize(The ),default (non-thread-safe) global error variable */ +/* The default (non-thread-safe) global error variable */ static SDL_error SDL_global_error; #define SDL_GetErrBuf() (&SDL_global_error) #else