# HG changeset patch # User Sam Lantinga # Date 1284526649 25200 # Node ID 511948f4919e1b3f00d68a0af88464af70cf5a04 # Parent e725a6a60c32e1a40b8f16cf3e013dc21a296c28 Fixed documentation diff -r e725a6a60c32 -r 511948f4919e include/SDL_video.h --- a/include/SDL_video.h Wed Sep 15 00:28:19 2010 -0400 +++ b/include/SDL_video.h Tue Sep 14 21:57:29 2010 -0700 @@ -568,7 +568,7 @@ extern DECLSPEC SDL_Window * SDLCALL SDL_CreateWindowFrom(const void *data); /** - * \brief Get the numeric ID of the window, for logging purposes. + * \brief Get the numeric ID of a window, for logging purposes. */ extern DECLSPEC Uint32 SDLCALL SDL_GetWindowID(SDL_Window * window); @@ -583,7 +583,7 @@ extern DECLSPEC Uint32 SDLCALL SDL_GetWindowFlags(SDL_Window * window); /** - * \brief Set the title of the window, in UTF-8 format. + * \brief Set the title of a window, in UTF-8 format. * * \sa SDL_GetWindowTitle() */ @@ -591,16 +591,16 @@ const char *title); /** - * \brief Get the title of the window, in UTF-8 format. + * \brief Get the title of a window, in UTF-8 format. * * \sa SDL_SetWindowTitle() */ extern DECLSPEC const char *SDLCALL SDL_GetWindowTitle(SDL_Window * window); /** - * \brief Set the icon of the window. + * \brief Set the icon of a window. * - * \param icon The icon for the window. + * \param icon The icon for a window. */ extern DECLSPEC void SDLCALL SDL_SetWindowIcon(SDL_Window * window, SDL_Surface * icon); @@ -614,14 +614,14 @@ void *userdata); /** - * \brief Retrieve the data pointer associated with the window. + * \brief Retrieve the data pointer associated with a window. * * \sa SDL_SetWindowData() */ extern DECLSPEC void *SDLCALL SDL_GetWindowData(SDL_Window * window); /** - * \brief Set the position of the window. + * \brief Set the position of a window. * * \param window The window to reposition. * \param x The x coordinate of the window, ::SDL_WINDOWPOS_CENTERED, or @@ -637,7 +637,7 @@ int x, int y); /** - * \brief Get the position of the window. + * \brief Get the position of a window. * * \sa SDL_SetWindowPosition() */ @@ -645,7 +645,7 @@ int *x, int *y); /** - * \brief Set the size of the window's client area. + * \brief Set the size of a window's client area. * * \note You can't change the size of a fullscreen window, it automatically * matches the size of the display mode. @@ -656,7 +656,7 @@ int h); /** - * \brief Get the size of the window's client area. + * \brief Get the size of a window's client area. * * \sa SDL_SetWindowSize() */ @@ -664,33 +664,33 @@ int *h); /** - * \brief Show the window. + * \brief Show a window. * * \sa SDL_HideWindow() */ extern DECLSPEC void SDLCALL SDL_ShowWindow(SDL_Window * window); /** - * \brief Hide the window. + * \brief Hide a window. * * \sa SDL_ShowWindow() */ extern DECLSPEC void SDLCALL SDL_HideWindow(SDL_Window * window); /** - * \brief Raise the window above other windows and set the input focus. + * \brief Raise a window above other windows and set the input focus. */ extern DECLSPEC void SDLCALL SDL_RaiseWindow(SDL_Window * window); /** - * \brief Make the window as large as possible. + * \brief Make a window as large as possible. * * \sa SDL_RestoreWindow() */ extern DECLSPEC void SDLCALL SDL_MaximizeWindow(SDL_Window * window); /** - * \brief Minimize the window to an iconic representation. + * \brief Minimize a window to an iconic representation. * * \sa SDL_RestoreWindow() */ @@ -705,7 +705,7 @@ extern DECLSPEC void SDLCALL SDL_RestoreWindow(SDL_Window * window); /** - * \brief Set the window's fullscreen state. + * \brief Set a window's fullscreen state. * * \return 0 on success, or -1 if setting the display mode failed. * @@ -716,7 +716,7 @@ int fullscreen); /** - * \brief Set the window's input grab mode. + * \brief Set a window's input grab mode. * * \param mode This is 1 to grab input, and 0 to release input. * @@ -726,7 +726,7 @@ int mode); /** - * \brief Get the window's input grab mode. + * \brief Get a window's input grab mode. * * \return This returns 1 if input is grabbed, and 0 otherwise. * @@ -1430,7 +1430,7 @@ extern DECLSPEC int SDLCALL SDL_GL_GetSwapInterval(void); /** - * \brief Swap the OpenGL buffers for the window, if double-buffering is + * \brief Swap the OpenGL buffers for a window, if double-buffering is * supported. */ extern DECLSPEC void SDLCALL SDL_GL_SwapWindow(SDL_Window * window);