add docs

Author: yunline

docs/reST/ref/sdl2_video.rst

@@ -146,6 +146,16 @@
       Gets or sets whether the window is borderless.
 
       .. note:: You can't change the border state of a fullscreen window.
+   
+   .. attribute:: always_on_top
+
+      | :sl:`Get or set whether the window is always on top`
+      | :sg:`always_on_top -> bool`
+
+      Get or set whether the window is always on top.
+
+      .. note:: Setting the always-on-top mode requires SDL2.0.16+.
+
    .. attribute:: id
 
       | :sl:`Get the unique window ID (**read-only**)`

src_c/doc/sdl2_video_doc.h

@@ -10,6 +10,7 @@
 #define DOC_SDL2_VIDEO_WINDOW_TITLE "title -> str\nGet or set the window title"
 #define DOC_SDL2_VIDEO_WINDOW_RESIZABLE "resizable -> bool\nGet or set whether the window is resizable"
 #define DOC_SDL2_VIDEO_WINDOW_BORDERLESS "borderless -> bool\nGet or set whether the window is borderless"
+#define DOC_SDL2_VIDEO_WINDOW_ALWAYSONTOP "always_on_top -> bool\nGet or set whether the window is always on top"
 #define DOC_SDL2_VIDEO_WINDOW_ID "id -> int\nGet the unique window ID (**read-only**)"
 #define DOC_SDL2_VIDEO_WINDOW_SIZE "size -> (int, int)\nGet or set the window size in pixels"
 #define DOC_SDL2_VIDEO_WINDOW_POSITION "position -> (int, int) or WINDOWPOS_CENTERED or WINDOWPOS_UNDEFINED\nGet or set the window position in screen coordinates"

src_c/window.c

@@ -747,7 +747,8 @@ static PyGetSetDef _window_getset[] = {
     {"borderless", (getter)window_get_borderless,
      (setter)window_set_borderless, DOC_SDL2_VIDEO_WINDOW_BORDERLESS, NULL},
     {"always_on_top", (getter)window_get_always_on_top,
-     (setter)window_set_always_on_top, "doc", NULL},
+     (setter)window_set_always_on_top, DOC_SDL2_VIDEO_WINDOW_ALWAYSONTOP,
+     NULL},
     {"relative_mouse", (getter)mouse_get_relative_mode,
      (setter)mouse_set_relative_mode, DOC_SDL2_VIDEO_WINDOW_RELATIVEMOUSE,
      NULL},