diff --git a/include/SDL3/SDL_video.h b/include/SDL3/SDL_video.h index b6fb606aa7..997016fb1a 100644 --- a/include/SDL3/SDL_video.h +++ b/include/SDL3/SDL_video.h @@ -975,8 +975,8 @@ extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_CreateWindow(const char *title, int * * - `SDL_WINDOW_TOOLTIP`: The popup window is a tooltip and will not pass any * input events. - * - `SDL_WINDOW_POPUP_MENU`: The popup window is a popup menu. - * The topmost popup menu will implicitly gain the keyboard focus. + * - `SDL_WINDOW_POPUP_MENU`: The popup window is a popup menu. The topmost + * popup menu will implicitly gain the keyboard focus. * * The following flags are not relevant to popup window creation and will be * ignored: @@ -986,8 +986,8 @@ extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_CreateWindow(const char *title, int * - `SDL_WINDOW_FULLSCREEN` * - `SDL_WINDOW_BORDERLESS` * - * The following flags are incompatible with popup window creation and will cause - * it to fail: + * The following flags are incompatible with popup window creation and will + * cause it to fail: * * - `SDL_WINDOW_UTILITY` * - `SDL_WINDOW_MODAL` @@ -997,15 +997,15 @@ extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_CreateWindow(const char *title, int * window. * * Popup windows cannot be minimized, maximized, made fullscreen, raised, - * flash, be made a modal window, be the parent of a toplevel window, or grab the - * mouse and/or keyboard. Attempts to do so will fail. + * flash, be made a modal window, be the parent of a toplevel window, or grab + * the mouse and/or keyboard. Attempts to do so will fail. * * Popup windows implicitly do not have a border/decorations and do not appear * on the taskbar/dock or in lists of windows such as alt-tab menus. * - * If a parent window is hidden or destroyed, any child popup windows will be recursively - * hidden or destroyed as well. Child popup windows not explicitly hidden will be restored - * when the parent is shown. + * If a parent window is hidden or destroyed, any child popup windows will be + * recursively hidden or destroyed as well. Child popup windows not explicitly + * hidden will be restored when the parent is shown. * * \param parent the parent of the window, must not be NULL. * \param offset_x the x position of the popup window relative to the origin @@ -1100,8 +1100,8 @@ extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_CreatePopupWindow(SDL_Window *paren * surfaces. * - `SDL_PROP_WINDOW_CREATE_WAYLAND_CREATE_EGL_WINDOW_BOOLEAN` - true if the * application wants an associated `wl_egl_window` object to be created and - * attached to the window, even if the window does not have the OpenGL property - * or `SDL_WINDOW_OPENGL` flag set. + * attached to the window, even if the window does not have the OpenGL + * property or `SDL_WINDOW_OPENGL` flag set. * - `SDL_PROP_WINDOW_CREATE_WAYLAND_WL_SURFACE_POINTER` - the wl_surface * associated with the window, if you want to wrap an existing window. See * [README/wayland](README/wayland) for more information. @@ -2299,13 +2299,14 @@ extern SDL_DECLSPEC float SDLCALL SDL_GetWindowOpacity(SDL_Window *window); * reparented to the new owner. Setting the parent window to NULL unparents * the window and removes child window status. * - * If a parent window is hidden or destroyed, the operation will be recursively - * applied to child windows. Child windows hidden with the parent that did not - * have their hidden status explicitly set will be restored when the parent is shown. + * If a parent window is hidden or destroyed, the operation will be + * recursively applied to child windows. Child windows hidden with the parent + * that did not have their hidden status explicitly set will be restored when + * the parent is shown. * * Attempting to set the parent of a window that is currently in the modal - * state will fail. Use SDL_SetWindowModal() to cancel the modal status before attempting - * to change the parent. + * state will fail. Use SDL_SetWindowModal() to cancel the modal status before + * attempting to change the parent. * * Popup windows cannot change parents and attempts to do so will fail. * @@ -2492,7 +2493,8 @@ extern SDL_DECLSPEC bool SDLCALL SDL_FlashWindow(SDL_Window *window, SDL_FlashOp /** * Destroy a window. * - * Any child windows owned by the window will be recursively destroyed as well. + * Any child windows owned by the window will be recursively destroyed as + * well. * * \param window the window to destroy. *