Update docs

1 files changed, 39 insertions, 0 deletions

diff --git a/gdk/gdkcursor.c b/gdk/gdkcursor.c
index ae8b3a643d..b854c6cd2c 100644
--- a/gdk/gdkcursor.c
+++ b/gdk/gdkcursor.c
@@ -225,6 +225,7 @@ gdk_cursor_get_cursor_type (GdkCursor *cursor)
  * @cursor_type: cursor to create
  *
  * Creates a new cursor from the set of builtin cursors.
+ *
  * Some useful ones are:
  * - ![](right_ptr.png) #GDK_RIGHT_PTR (right-facing arrow)
  * - ![](crosshair.png) #GDK_CROSSHAIR (crosshair)
@@ -266,6 +267,44 @@ gdk_cursor_new_for_display (GdkDisplay    *display,
  * Creates a new cursor by looking up @name in the current cursor
  * theme.
  *
+ * A recommended set of cursor names that will work across different
+ * platforms can be found in the CSS specification:
+ * - "none"
+ * - ![](default_cursor.png) "default"
+ * - ![](help_cursor.png) "help"
+ * - ![](pointer_cursor.png) "pointer"
+ * - ![](progress_cursor.png) "progress"
+ * - ![](wait_cursor.png) "wait"
+ * - ![](cell_cursor.png) "cell"
+ * - ![](crosshair_cursor.png) "crosshair"
+ * - ![](text_cursor.png) "text"
+ * - ![](vertical_text_cursor.png) "vertical-text"
+ * - ![](alias_cursor.png) "alias"
+ * - ![](copy_cursor.png) "copy"
+ * - ![](move_cursor.png) "move"
+ * - ![](no_drop_cursor.png) "no-drop"
+ * - ![](not_allowed_cursor.png) "not-allowed"
+ * - ![](grab_cursor.png) "grab"
+ * - ![](grabbing_cursor.png) "grabbing"
+ * - ![](all_scroll_cursor.png) "all-scroll"
+ * - ![](col_resize_cursor.png) "col-resize"
+ * - ![](row_resize_cursor.png) "row-resize"
+ * - ![](n_resize_cursor.png) "n-resize"
+ * - ![](e_resize_cursor.png) "e-resize"
+ * - ![](s_resize_cursor.png) "s-resize"
+ * - ![](w_resize_cursor.png) "w-resize"
+ * - ![](ne_resize_cursor.png) "ne-resize"
+ * - ![](nw_resize_cursor.png) "nw-resize"
+ * - ![](sw_resize_cursor.png) "sw-resize"
+ * - ![](se_resize_cursor.png) "se-resize"
+ * - ![](ew_resize_cursor.png) "ew-resize"
+ * - ![](ns_resize_cursor.png) "ns-resize"
+ * - ![](nesw_resize_cursor.png) "nesw-resize"
+ * - ![](nwse_resize_cursor.png) "nwse-resize"
+ * - ![](zoom_in_cursor.png) "zoom-in"
+ * - ![](zoom_out_cursor.png) "zoom-out"
+ *
+ *
  * Returns: (nullable): a new #GdkCursor, or %NULL if there is no
  *   cursor with the given name
  *