From: Matthias Clasen Date: Thu, 28 Nov 2002 00:33:17 +0000 (+0000) Subject: Document 2.2 API additions. X-Git-Url: http://pileus.org/git/?p=~andy%2Fgtk;a=commitdiff_plain;h=7cb3f99fc794c2dc8ccc858845e3f2539e713a6c Document 2.2 API additions. --- diff --git a/ChangeLog b/ChangeLog index 2c330cf2a..0a4f4c531 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,52 @@ +2002-11-28 Matthias Clasen + + * gdk/gdkdisplay.c: + * gdk/gdkdisplaymanager.c: + * gdk/gdk.c: + * gdk/gdkdraw.c: + * gdk/gdkevents.c: + * gdk/gdkrgb.c: + * gdk/gdkscreen.c: + * gdk/gdkwindow.c: + * gdk/x11/gdkcolor-x11.c: + * gdk/x11/gdkcursor-x11.c: + * gdk/x11/gdkdisplay-x11.c: + * gdk/x11/gdkdnd-x11.c: + * gdk/x11/gdkevents-x11.c: + * gdk/x11/gdkfont-x11.c: + * gdk/x11/gdkgc-x11.c: + * gdk/x11/gdkinput.c: + * gdk/x11/gdkkeys-x11.c: + * gdk/x11/gdkpango-x11.c: + * gdk/x11/gdkpixmap-x11.c: + * gdk/x11/gdkproperty-x11.c: + * gdk/x11/gdkscreen-x11.c: + * gdk/x11/gdkselection-x11.c: + * gdk/x11/gdkvisual-x11.c: + * gdk/x11/gdkwindow-x11.c: + * gdk/x11/gdkxid.c: + * gtk/gtkclipboard.c: + * gtk/gtkcolorsel.c: + * gtk/gtkiconfactory.c: + * gtk/gtkinvisible.c: + * gtk/gtkliststore.c: + * gtk/gtkmenu.c: + * gtk/gtkmenushell.c: + * gtk/gtknotebook.c: + * gtk/gtkplug.c: + * gtk/gtkselection.c: + * gtk/gtksettings.c: + * gtk/gtktreemodel.c: + * gtk/gtktreemodelsort.c: + * gtk/gtktreeselection.c: + * gtk/gtktreestore.c: + * gtk/gtktreeview.c: + * gtk/gtktreeviewcolumn.c: + * gtk/gtkwidget.c: + * gtk/gtkwindow.c: Document 2.2 API additions. I'm not + going to list all individual functions here; if you want to see + the list, grep for "Since: 2.2". + Tue Nov 26 13:07:56 2002 HideToshi Tajima * modules/input/gtkimcontextxim.c @@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor 2002-11-25 Matthias Clasen - * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. + * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. Mon Nov 25 19:10:54 2002 Soeren Sandmann diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 2c330cf2a..0a4f4c531 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,52 @@ +2002-11-28 Matthias Clasen + + * gdk/gdkdisplay.c: + * gdk/gdkdisplaymanager.c: + * gdk/gdk.c: + * gdk/gdkdraw.c: + * gdk/gdkevents.c: + * gdk/gdkrgb.c: + * gdk/gdkscreen.c: + * gdk/gdkwindow.c: + * gdk/x11/gdkcolor-x11.c: + * gdk/x11/gdkcursor-x11.c: + * gdk/x11/gdkdisplay-x11.c: + * gdk/x11/gdkdnd-x11.c: + * gdk/x11/gdkevents-x11.c: + * gdk/x11/gdkfont-x11.c: + * gdk/x11/gdkgc-x11.c: + * gdk/x11/gdkinput.c: + * gdk/x11/gdkkeys-x11.c: + * gdk/x11/gdkpango-x11.c: + * gdk/x11/gdkpixmap-x11.c: + * gdk/x11/gdkproperty-x11.c: + * gdk/x11/gdkscreen-x11.c: + * gdk/x11/gdkselection-x11.c: + * gdk/x11/gdkvisual-x11.c: + * gdk/x11/gdkwindow-x11.c: + * gdk/x11/gdkxid.c: + * gtk/gtkclipboard.c: + * gtk/gtkcolorsel.c: + * gtk/gtkiconfactory.c: + * gtk/gtkinvisible.c: + * gtk/gtkliststore.c: + * gtk/gtkmenu.c: + * gtk/gtkmenushell.c: + * gtk/gtknotebook.c: + * gtk/gtkplug.c: + * gtk/gtkselection.c: + * gtk/gtksettings.c: + * gtk/gtktreemodel.c: + * gtk/gtktreemodelsort.c: + * gtk/gtktreeselection.c: + * gtk/gtktreestore.c: + * gtk/gtktreeview.c: + * gtk/gtktreeviewcolumn.c: + * gtk/gtkwidget.c: + * gtk/gtkwindow.c: Document 2.2 API additions. I'm not + going to list all individual functions here; if you want to see + the list, grep for "Since: 2.2". + Tue Nov 26 13:07:56 2002 HideToshi Tajima * modules/input/gtkimcontextxim.c @@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor 2002-11-25 Matthias Clasen - * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. + * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. Mon Nov 25 19:10:54 2002 Soeren Sandmann diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 2c330cf2a..0a4f4c531 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,52 @@ +2002-11-28 Matthias Clasen + + * gdk/gdkdisplay.c: + * gdk/gdkdisplaymanager.c: + * gdk/gdk.c: + * gdk/gdkdraw.c: + * gdk/gdkevents.c: + * gdk/gdkrgb.c: + * gdk/gdkscreen.c: + * gdk/gdkwindow.c: + * gdk/x11/gdkcolor-x11.c: + * gdk/x11/gdkcursor-x11.c: + * gdk/x11/gdkdisplay-x11.c: + * gdk/x11/gdkdnd-x11.c: + * gdk/x11/gdkevents-x11.c: + * gdk/x11/gdkfont-x11.c: + * gdk/x11/gdkgc-x11.c: + * gdk/x11/gdkinput.c: + * gdk/x11/gdkkeys-x11.c: + * gdk/x11/gdkpango-x11.c: + * gdk/x11/gdkpixmap-x11.c: + * gdk/x11/gdkproperty-x11.c: + * gdk/x11/gdkscreen-x11.c: + * gdk/x11/gdkselection-x11.c: + * gdk/x11/gdkvisual-x11.c: + * gdk/x11/gdkwindow-x11.c: + * gdk/x11/gdkxid.c: + * gtk/gtkclipboard.c: + * gtk/gtkcolorsel.c: + * gtk/gtkiconfactory.c: + * gtk/gtkinvisible.c: + * gtk/gtkliststore.c: + * gtk/gtkmenu.c: + * gtk/gtkmenushell.c: + * gtk/gtknotebook.c: + * gtk/gtkplug.c: + * gtk/gtkselection.c: + * gtk/gtksettings.c: + * gtk/gtktreemodel.c: + * gtk/gtktreemodelsort.c: + * gtk/gtktreeselection.c: + * gtk/gtktreestore.c: + * gtk/gtktreeview.c: + * gtk/gtktreeviewcolumn.c: + * gtk/gtkwidget.c: + * gtk/gtkwindow.c: Document 2.2 API additions. I'm not + going to list all individual functions here; if you want to see + the list, grep for "Since: 2.2". + Tue Nov 26 13:07:56 2002 HideToshi Tajima * modules/input/gtkimcontextxim.c @@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor 2002-11-25 Matthias Clasen - * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. + * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. Mon Nov 25 19:10:54 2002 Soeren Sandmann diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 2c330cf2a..0a4f4c531 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,52 @@ +2002-11-28 Matthias Clasen + + * gdk/gdkdisplay.c: + * gdk/gdkdisplaymanager.c: + * gdk/gdk.c: + * gdk/gdkdraw.c: + * gdk/gdkevents.c: + * gdk/gdkrgb.c: + * gdk/gdkscreen.c: + * gdk/gdkwindow.c: + * gdk/x11/gdkcolor-x11.c: + * gdk/x11/gdkcursor-x11.c: + * gdk/x11/gdkdisplay-x11.c: + * gdk/x11/gdkdnd-x11.c: + * gdk/x11/gdkevents-x11.c: + * gdk/x11/gdkfont-x11.c: + * gdk/x11/gdkgc-x11.c: + * gdk/x11/gdkinput.c: + * gdk/x11/gdkkeys-x11.c: + * gdk/x11/gdkpango-x11.c: + * gdk/x11/gdkpixmap-x11.c: + * gdk/x11/gdkproperty-x11.c: + * gdk/x11/gdkscreen-x11.c: + * gdk/x11/gdkselection-x11.c: + * gdk/x11/gdkvisual-x11.c: + * gdk/x11/gdkwindow-x11.c: + * gdk/x11/gdkxid.c: + * gtk/gtkclipboard.c: + * gtk/gtkcolorsel.c: + * gtk/gtkiconfactory.c: + * gtk/gtkinvisible.c: + * gtk/gtkliststore.c: + * gtk/gtkmenu.c: + * gtk/gtkmenushell.c: + * gtk/gtknotebook.c: + * gtk/gtkplug.c: + * gtk/gtkselection.c: + * gtk/gtksettings.c: + * gtk/gtktreemodel.c: + * gtk/gtktreemodelsort.c: + * gtk/gtktreeselection.c: + * gtk/gtktreestore.c: + * gtk/gtktreeview.c: + * gtk/gtktreeviewcolumn.c: + * gtk/gtkwidget.c: + * gtk/gtkwindow.c: Document 2.2 API additions. I'm not + going to list all individual functions here; if you want to see + the list, grep for "Since: 2.2". + Tue Nov 26 13:07:56 2002 HideToshi Tajima * modules/input/gtkimcontextxim.c @@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor 2002-11-25 Matthias Clasen - * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. + * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. Mon Nov 25 19:10:54 2002 Soeren Sandmann diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 2c330cf2a..0a4f4c531 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,52 @@ +2002-11-28 Matthias Clasen + + * gdk/gdkdisplay.c: + * gdk/gdkdisplaymanager.c: + * gdk/gdk.c: + * gdk/gdkdraw.c: + * gdk/gdkevents.c: + * gdk/gdkrgb.c: + * gdk/gdkscreen.c: + * gdk/gdkwindow.c: + * gdk/x11/gdkcolor-x11.c: + * gdk/x11/gdkcursor-x11.c: + * gdk/x11/gdkdisplay-x11.c: + * gdk/x11/gdkdnd-x11.c: + * gdk/x11/gdkevents-x11.c: + * gdk/x11/gdkfont-x11.c: + * gdk/x11/gdkgc-x11.c: + * gdk/x11/gdkinput.c: + * gdk/x11/gdkkeys-x11.c: + * gdk/x11/gdkpango-x11.c: + * gdk/x11/gdkpixmap-x11.c: + * gdk/x11/gdkproperty-x11.c: + * gdk/x11/gdkscreen-x11.c: + * gdk/x11/gdkselection-x11.c: + * gdk/x11/gdkvisual-x11.c: + * gdk/x11/gdkwindow-x11.c: + * gdk/x11/gdkxid.c: + * gtk/gtkclipboard.c: + * gtk/gtkcolorsel.c: + * gtk/gtkiconfactory.c: + * gtk/gtkinvisible.c: + * gtk/gtkliststore.c: + * gtk/gtkmenu.c: + * gtk/gtkmenushell.c: + * gtk/gtknotebook.c: + * gtk/gtkplug.c: + * gtk/gtkselection.c: + * gtk/gtksettings.c: + * gtk/gtktreemodel.c: + * gtk/gtktreemodelsort.c: + * gtk/gtktreeselection.c: + * gtk/gtktreestore.c: + * gtk/gtktreeview.c: + * gtk/gtktreeviewcolumn.c: + * gtk/gtkwidget.c: + * gtk/gtkwindow.c: Document 2.2 API additions. I'm not + going to list all individual functions here; if you want to see + the list, grep for "Since: 2.2". + Tue Nov 26 13:07:56 2002 HideToshi Tajima * modules/input/gtkimcontextxim.c @@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor 2002-11-25 Matthias Clasen - * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. + * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. Mon Nov 25 19:10:54 2002 Soeren Sandmann diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 2c330cf2a..0a4f4c531 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,52 @@ +2002-11-28 Matthias Clasen + + * gdk/gdkdisplay.c: + * gdk/gdkdisplaymanager.c: + * gdk/gdk.c: + * gdk/gdkdraw.c: + * gdk/gdkevents.c: + * gdk/gdkrgb.c: + * gdk/gdkscreen.c: + * gdk/gdkwindow.c: + * gdk/x11/gdkcolor-x11.c: + * gdk/x11/gdkcursor-x11.c: + * gdk/x11/gdkdisplay-x11.c: + * gdk/x11/gdkdnd-x11.c: + * gdk/x11/gdkevents-x11.c: + * gdk/x11/gdkfont-x11.c: + * gdk/x11/gdkgc-x11.c: + * gdk/x11/gdkinput.c: + * gdk/x11/gdkkeys-x11.c: + * gdk/x11/gdkpango-x11.c: + * gdk/x11/gdkpixmap-x11.c: + * gdk/x11/gdkproperty-x11.c: + * gdk/x11/gdkscreen-x11.c: + * gdk/x11/gdkselection-x11.c: + * gdk/x11/gdkvisual-x11.c: + * gdk/x11/gdkwindow-x11.c: + * gdk/x11/gdkxid.c: + * gtk/gtkclipboard.c: + * gtk/gtkcolorsel.c: + * gtk/gtkiconfactory.c: + * gtk/gtkinvisible.c: + * gtk/gtkliststore.c: + * gtk/gtkmenu.c: + * gtk/gtkmenushell.c: + * gtk/gtknotebook.c: + * gtk/gtkplug.c: + * gtk/gtkselection.c: + * gtk/gtksettings.c: + * gtk/gtktreemodel.c: + * gtk/gtktreemodelsort.c: + * gtk/gtktreeselection.c: + * gtk/gtktreestore.c: + * gtk/gtktreeview.c: + * gtk/gtktreeviewcolumn.c: + * gtk/gtkwidget.c: + * gtk/gtkwindow.c: Document 2.2 API additions. I'm not + going to list all individual functions here; if you want to see + the list, grep for "Since: 2.2". + Tue Nov 26 13:07:56 2002 HideToshi Tajima * modules/input/gtkimcontextxim.c @@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor 2002-11-25 Matthias Clasen - * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. + * docs/tutorial/gtk-tut.sgml: Fix the ftp download url. Mon Nov 25 19:10:54 2002 Soeren Sandmann diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml index 4ca53acd7..f03b3deef 100644 --- a/docs/reference/gtk/tmpl/gtk-unused.sgml +++ b/docs/reference/gtk/tmpl/gtk-unused.sgml @@ -2192,6 +2192,15 @@ Get the type of GtkIdentifier. @str: @Returns: + + + + + +@store: +@iter: +@position: + @@ -2968,6 +2977,15 @@ a gtk_object_unref(). @tree_model: @iter: + + + + + +@tree_store: +@iter: +@position: + diff --git a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml index f9daddfc6..3a35ee8fc 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml @@ -46,6 +46,7 @@ probably has a selection colored background to render to. @GTK_CELL_RENDERER_PRELIT: The mouse is hovering over the cell. @GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner @GTK_CELL_RENDERER_SORTED: The cell is in a sorted row +@GTK_CELL_RENDERER_FOCUSED: diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml index eebb13263..c0077d4a8 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml @@ -82,6 +82,11 @@ GtkCellRendererToggle + + + + + diff --git a/docs/reference/gtk/tmpl/gtkliststore.sgml b/docs/reference/gtk/tmpl/gtkliststore.sgml index 49250dad0..bce8d449c 100644 --- a/docs/reference/gtk/tmpl/gtkliststore.sgml +++ b/docs/reference/gtk/tmpl/gtkliststore.sgml @@ -271,13 +271,3 @@ particular row is needed often, it is worth keeping the iter around. @b: - - - - - -@store: -@iter: -@position: - - diff --git a/docs/reference/gtk/tmpl/gtktreestore.sgml b/docs/reference/gtk/tmpl/gtktreestore.sgml index b24b3ad4c..39832d3b9 100644 --- a/docs/reference/gtk/tmpl/gtktreestore.sgml +++ b/docs/reference/gtk/tmpl/gtktreestore.sgml @@ -209,7 +209,17 @@ drop interfaces. @b: - + + + + + +@tree_store: +@iter: +@position: + + + diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml index 7317743b6..84a67e37d 100644 --- a/docs/reference/gtk/tmpl/gtktreeview.sgml +++ b/docs/reference/gtk/tmpl/gtktreeview.sgml @@ -762,6 +762,7 @@ Function used for #gtk_tree_view_map_expanded_rows. @arg1: @arg2: @arg3: +@Returns: @@ -806,6 +807,7 @@ Function used for #gtk_tree_view_map_expanded_rows. @treeview: the object which received the signal. +@Returns: @@ -813,6 +815,7 @@ Function used for #gtk_tree_view_map_expanded_rows. @treeview: the object which received the signal. +@Returns: @@ -821,6 +824,7 @@ Function used for #gtk_tree_view_map_expanded_rows. @treeview: the object which received the signal. @arg1: +@Returns: @@ -837,6 +841,7 @@ Function used for #gtk_tree_view_map_expanded_rows. @treeview: the object which received the signal. +@Returns: @@ -864,6 +869,7 @@ Function used for #gtk_tree_view_map_expanded_rows. @treeview: the object which received the signal. +@Returns: @@ -871,6 +877,7 @@ Function used for #gtk_tree_view_map_expanded_rows. @treeview: the object which received the signal. +@Returns: diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml index de8057d44..4c6d77b91 100644 --- a/docs/reference/gtk/tmpl/gtkwindow.sgml +++ b/docs/reference/gtk/tmpl/gtkwindow.sgml @@ -774,6 +774,14 @@ Deprecated alias for gtk_window_set_position(). @Returns: + + + + + +@setting: + + diff --git a/gdk-pixbuf/ChangeLog b/gdk-pixbuf/ChangeLog index 6fb5412fb..d7aee5fd6 100644 --- a/gdk-pixbuf/ChangeLog +++ b/gdk-pixbuf/ChangeLog @@ -1,3 +1,11 @@ +2002-11-28 Matthias Clasen + + * gdk-pixbuf/gdk-pixbuf-io.c: + * gdk-pixbuf/gdk-pixbuf-loader.c: + * gdk-pixbuf/gdk-pixbuf.c: Document 2.2 API additions. I'm not + going to list all individual functions here; if you want to see + the list, grep for "Since: 2.2". + Fri Nov 8 19:06:07 2002 Owen Taylor * Makefile.am (gdk-pixbuf.loaders): Make gdk-pixbuf.loaders diff --git a/gdk-pixbuf/gdk-pixbuf-io.c b/gdk-pixbuf/gdk-pixbuf-io.c index ad126337f..9642182a8 100644 --- a/gdk-pixbuf/gdk-pixbuf-io.c +++ b/gdk-pixbuf/gdk-pixbuf-io.c @@ -1002,6 +1002,8 @@ gdk_pixbuf_savev (GdkPixbuf *pixbuf, * Returns the name of the format. * * Return value: the name of the format. + * + * Since: 2.2 */ gchar * gdk_pixbuf_format_get_name (GdkPixbufFormat *format) @@ -1018,6 +1020,8 @@ gdk_pixbuf_format_get_name (GdkPixbufFormat *format) * Returns a description of the format. * * Return value: a description of the format. + * + * Since: 2.2 */ gchar * gdk_pixbuf_format_get_description (GdkPixbufFormat *format) @@ -1042,6 +1046,8 @@ gdk_pixbuf_format_get_description (GdkPixbufFormat *format) * Returns the mime types supported by the format. * * Return value: a %NULL-terminated array of mime types. + * + * Since: 2.2 */ gchar ** gdk_pixbuf_format_get_mime_types (GdkPixbufFormat *format) @@ -1055,9 +1061,12 @@ gdk_pixbuf_format_get_mime_types (GdkPixbufFormat *format) * gdk_pixbuf_format_get_extensions: * @format: a #GdkPixbufFormat * - * Returns the filename extensions typically used for files in the given format. + * Returns the filename extensions typically used for files in the + * given format. * * Return value: a %NULL-terminated array of filename extensions. + * + * Since: 2.2 */ gchar ** gdk_pixbuf_format_get_extensions (GdkPixbufFormat *format) @@ -1074,6 +1083,8 @@ gdk_pixbuf_format_get_extensions (GdkPixbufFormat *format) * Returns whether pixbufs can be saved in the given format. * * Return value: whether pixbufs can be saved in the given format. + * + * Since: 2.2 */ gboolean gdk_pixbuf_format_is_writable (GdkPixbufFormat *format) @@ -1101,6 +1112,8 @@ _gdk_pixbuf_get_format (GdkPixbufModule *module) * image formats. The list should be freed when it is no longer needed, * but the structures themselves are owned by #GdkPixbuf and should not be * freed. + * + * Since: 2.2 */ GSList * gdk_pixbuf_get_formats (void) diff --git a/gdk-pixbuf/gdk-pixbuf-loader.c b/gdk-pixbuf/gdk-pixbuf-loader.c index 070ade1b1..bf3602763 100644 --- a/gdk-pixbuf/gdk-pixbuf-loader.c +++ b/gdk-pixbuf/gdk-pixbuf-loader.c @@ -201,6 +201,8 @@ gdk_pixbuf_loader_finalize (GObject *object) * * Attempts to set the desired image size are ignored after the * emission of the ::size_prepared signal. + * + * Since: 2.2 */ void gdk_pixbuf_loader_set_size (GdkPixbufLoader *loader, @@ -662,6 +664,8 @@ gdk_pixbuf_loader_close (GdkPixbufLoader *loader, * * Returns: A #GdkPixbufFormat or %NULL. The return value is owned * by GdkPixbuf and should not be freed. + * + * Since: 2.2 */ GdkPixbufFormat * gdk_pixbuf_loader_get_format (GdkPixbufLoader *loader) diff --git a/gdk-pixbuf/gdk-pixbuf.c b/gdk-pixbuf/gdk-pixbuf.c index 1a0a1df61..b97dd19a4 100644 --- a/gdk-pixbuf/gdk-pixbuf.c +++ b/gdk-pixbuf/gdk-pixbuf.c @@ -535,6 +535,8 @@ gdk_pixbuf_get_option (GdkPixbuf *pixbuf, * ignored and %FALSE is returned. * * Return value: %TRUE on success. + * + * Since: 2.2 **/ gboolean gdk_pixbuf_set_option (GdkPixbuf *pixbuf, diff --git a/gdk/gdk.c b/gdk/gdk.c index c3caeb8bf..87d12ea46 100644 --- a/gdk/gdk.c +++ b/gdk/gdk.c @@ -279,6 +279,8 @@ _gdk_get_command_line_args (int *argc, * * You shouldn't call this function explicitely if you are using * gtk_init(), gtk_init_check(), gdk_init(), or gdk_init_check(). + * + * Since: 2.2 **/ void gdk_parse_args (int *argc, @@ -357,6 +359,8 @@ gdk_parse_args (int *argc, * * Returns: the display name, if specified explicitely, otherwise %NULL * this string is owned by GTK+ and must not be modified or freed. + * + * Since: 2.2 */ G_CONST_RETURN gchar * gdk_get_display_arg_name (void) diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c index e121e426d..820caf703 100644 --- a/gdk/gdkdisplay.c +++ b/gdk/gdkdisplay.c @@ -175,6 +175,8 @@ gdk_display_finalize (GObject *object) * * Closes the connection windowing system for the given display, * and cleans up associated resources. + * + * Since: 2.2 */ void gdk_display_close (GdkDisplay *display) @@ -201,6 +203,8 @@ gdk_display_close (GdkDisplay *display) * * Return value: the next #GdkEvent to be processed, or %NULL if no events * are pending. The returned #GdkEvent should be freed with gdk_event_free(). + * + * Since: 2.2 **/ GdkEvent* gdk_display_get_event (GdkDisplay *display) @@ -220,9 +224,11 @@ gdk_display_get_event (GdkDisplay *display) * not get more events from the windowing system. It only checks the events * that have already been moved to the GDK event queue.) * - * Return value: a copy of the first #GdkEvent on the event queue, or %NULL if no - * events are in the queue. The returned #GdkEvent should be freed with + * Return value: a copy of the first #GdkEvent on the event queue, or %NULL + * if no events are in the queue. The returned #GdkEvent should be freed with * gdk_event_free(). + * + * Since: 2.2 **/ GdkEvent* gdk_display_peek_event (GdkDisplay *display) @@ -246,6 +252,8 @@ gdk_display_peek_event (GdkDisplay *display) * * Appends a copy of the given event onto the front of the event * queue for @display. + * + * Since: 2.2 **/ void gdk_display_put_event (GdkDisplay *display, @@ -259,8 +267,8 @@ gdk_display_put_event (GdkDisplay *display, /** * gdk_pointer_ungrab: - * @time_: a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no timestamp is - * available. + * @time_: a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no + * timestamp is available. * * Ungrabs the pointer, if it is grabbed by this application. **/ @@ -374,6 +382,8 @@ gdk_device_get_core_pointer (void) * * Return value: the core pointer device; this is owned by the * display and should not be freed. + * + * Since: 2.2 **/ GdkDevice * gdk_display_get_core_pointer (GdkDisplay *display) @@ -435,6 +445,8 @@ _gdk_get_sm_client_id (void) * * Gets the current location of the pointer and the current modifier * mask for a given display. + * + * Since: 2.2 **/ void gdk_display_get_pointer (GdkDisplay *display, @@ -473,6 +485,8 @@ gdk_display_get_pointer (GdkDisplay *display, * another application). * * Returns: the window under the mouse pointer, or %NULL + * + * Since: 2.2 **/ GdkWindow * gdk_display_get_window_at_pointer (GdkDisplay *display, @@ -505,6 +519,8 @@ gdk_display_get_window_at_pointer (GdkDisplay *display, * reason to use this facility. * * Return value: the previous pointer hook table + * + * Since: 2.2 **/ GdkDisplayPointerHooks * gdk_display_set_pointer_hooks (GdkDisplay *display, diff --git a/gdk/gdkdisplaymanager.c b/gdk/gdkdisplaymanager.c index 644652dc3..5ca5ae23b 100644 --- a/gdk/gdkdisplaymanager.c +++ b/gdk/gdkdisplaymanager.c @@ -160,6 +160,8 @@ gdk_display_manager_get_property (GObject *object, * * Returns the global #GdkDisplayManager singleton; gdk_parse_pargs(), * gdk_init(), or gdk_init_check() must have been called first. + * + * Since: 2.2 **/ GdkDisplayManager* gdk_display_manager_get (void) @@ -180,6 +182,8 @@ gdk_display_manager_get (void) * * Returns: a #GdkDisplay, or %NULL if there is no default * display. + * + * Since: 2.2 */ GdkDisplay * gdk_display_manager_get_default_display (GdkDisplayManager *display_manager) @@ -198,6 +202,8 @@ gdk_display_manager_get_default_display (GdkDisplayManager *display_manager) * * Returns: a #GdkDisplay, or %NULL if there is no default * display. + * + * Since: 2.2 */ GdkDisplay * gdk_display_get_default (void) @@ -212,6 +218,8 @@ gdk_display_get_default (void) * gdk_display_get_default ()). * * Returns: a #GdkScreen, or %NULL if there is no default display. + * + * Since: 2.2 */ GdkScreen * gdk_screen_get_default (void) @@ -228,6 +236,8 @@ gdk_screen_get_default (void) * @display: a #GdkDisplay * * Sets @display as the default display. + * + * Since: 2.2 **/ void gdk_display_manager_set_default_display (GdkDisplayManager *display_manager, @@ -248,6 +258,8 @@ gdk_display_manager_set_default_display (GdkDisplayManager *display_manager, * * Return value: a newly allocated #GSList of #GdkDisplay objects. * Free this list with g_slist_free() when you are done with it. + * + * Since: 2.2 **/ GSList * gdk_display_manager_list_displays (GdkDisplayManager *display_manager) diff --git a/gdk/gdkdraw.c b/gdk/gdkdraw.c index dfffb0421..b9062caad 100644 --- a/gdk/gdkdraw.c +++ b/gdk/gdkdraw.c @@ -211,6 +211,8 @@ gdk_drawable_get_depth (GdkDrawable *drawable) * Gets the #GdkScreen associated with a #GdkDrawable. * * Return value: the #GdkScreen associated with @drawable + * + * Since: 2.2 **/ GdkScreen* gdk_drawable_get_screen(GdkDrawable *drawable) @@ -227,6 +229,8 @@ gdk_drawable_get_screen(GdkDrawable *drawable) * Gets the #GdkDisplay associated with a #GdkDrawable. * * Return value: the #GdkDisplay associated with @drawable + * + * Since: 2.2 **/ GdkDisplay* gdk_drawable_get_display (GdkDrawable *drawable) @@ -723,17 +727,20 @@ gdk_draw_image (GdkDrawable *drawable, * @dest_y: Destination Y coordinate within drawable. * @width: Width of region to render, in pixels, or -1 to use pixbuf width. * @height: Height of region to render, in pixels, or -1 to use pixbuf height. - * @dither: Dithering mode for GdkRGB. + * @dither: Dithering mode for #GdkRGB. * @x_dither: X offset for dither. * @y_dither: Y offset for dither. * * Renders a rectangular portion of a pixbuf to a drawable. The destination * drawable must have a colormap. All windows have a colormap, however, pixmaps - * only have colormap by default if they were created with a non-NULL window argument. - * Otherwise a colormap must be set on them with gdk_drawable_set_colormap. + * only have colormap by default if they were created with a non-%NULL window + * argument. Otherwise a colormap must be set on them with + * gdk_drawable_set_colormap(). + * + * On older X servers, rendering pixbufs with an alpha channel involves round + * trips to the X server, and may be somewhat slow. * - * On older X servers, rendering pixbufs with an alpha channel involves round trips - * to the X server, and may be somewhat slow. + * Since: 2.2 **/ void gdk_draw_pixbuf (GdkDrawable *drawable, diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c index 4e464906e..48d938f41 100644 --- a/gdk/gdkevents.c +++ b/gdk/gdkevents.c @@ -268,6 +268,8 @@ static GHashTable *event_hash = NULL; * * Return value: a newly-allocated #GdkEvent. The returned #GdkEvent * should be freed with gdk_event_free(). + * + * Since: 2.2 **/ GdkEvent* gdk_event_new (GdkEventType type) @@ -828,6 +830,8 @@ gdk_event_get_axis (GdkEvent *event, * Sets the screen for @event to @screen. The event must * have been allocated by GTK+, for instance, by * gdk_event_copy(). + * + * Since: 2.2 **/ void gdk_event_set_screen (GdkEvent *event, @@ -847,14 +851,16 @@ gdk_event_set_screen (GdkEvent *event, * @event: a #GdkEvent * * Returns the screen for the event. The screen is - * typically the screen for event->any.window, but + * typically the screen for event->any.window, but * for events such as mouse events, it is the screen * where the the pointer was when the event occurs - * that is, the screen which has the root window - * to which event->motion.x_root and - * event->motion.y_root are relative. + * to which event->motion.x_root and + * event->motion.y_root are relative. * * Return value: the screen for the event + * + * Since: 2.2 **/ GdkScreen * gdk_event_get_screen (GdkEvent *event) @@ -1105,6 +1111,8 @@ gdk_synthesize_window_state (GdkWindow *window, * Sets the double click time (two clicks within this time interval * count as a double click and result in a #GDK_2BUTTON_PRESS event). * Applications should NOT set this, it is a global user-configured setting. + * + * Since: 2.2 **/ void gdk_display_set_double_click_time (GdkDisplay *display, diff --git a/gdk/gdkrgb.c b/gdk/gdkrgb.c index 20f1eef31..825abd07d 100644 --- a/gdk/gdkrgb.c +++ b/gdk/gdkrgb.c @@ -3488,7 +3488,7 @@ gdk_rgb_get_colormap (void) /** * gdk_screen_get_rgb_colormap: - * @screen : a #GdkScreen. + * @screen: a #GdkScreen. * * Gets the preferred colormap for rendering image data on @screen. * Not a very useful function; historically, GDK could only render RGB @@ -3497,6 +3497,8 @@ gdk_rgb_get_colormap (void) * call this function. * * Return value: the preferred colormap + * + * Since: 2.2 **/ GdkColormap * gdk_screen_get_rgb_colormap (GdkScreen *screen) @@ -3516,7 +3518,7 @@ gdk_screen_get_rgb_colormap (GdkScreen *screen) /** * gdk_screen_get_rgb_visual: - * @screen : a #GdkScreen + * @screen: a #GdkScreen * * Gets a "preferred visual" chosen by GdkRGB for rendering image data * on @screen. In previous versions of @@ -3526,6 +3528,8 @@ gdk_screen_get_rgb_colormap (GdkScreen *screen) * drawables with any visual. * * Return value: The #GdkVisual chosen by GdkRGB. + * + * Since: 2.2 **/ GdkVisual * gdk_screen_get_rgb_visual (GdkScreen *screen) diff --git a/gdk/gdkscreen.c b/gdk/gdkscreen.c index 564328ff7..f7160ecbc 100644 --- a/gdk/gdkscreen.c +++ b/gdk/gdkscreen.c @@ -92,14 +92,16 @@ _gdk_screen_close (GdkScreen *screen) /** * gdk_screen_get_monitor_at_point: - * @screen : a #GdkScreen. - * @x : the x coordinate in the virtual screen. - * @y : the y coordinate in the virtual screen. + * @screen: a #GdkScreen. + * @x: the x coordinate in the virtual screen. + * @y: the y coordinate in the virtual screen. * * Returns the monitor number in which the point (@x,@y) is located. * * Returns: the monitor number in which the point (@x,@y) belong, or * -1 if the point is not in any monitor. + * + * Since: 2.2 **/ gint gdk_screen_get_monitor_at_point (GdkScreen *screen, @@ -134,8 +136,10 @@ gdk_screen_get_monitor_at_point (GdkScreen *screen, * @window: a #GdkWindow * @returns: the monitor number in which most of @window is located. * - * Returns the number of the monitor in which the largest area of the bounding rectangle - * of @window resides. + * Returns the number of the monitor in which the largest area of the + * bounding rectangle of @window resides. + * + * Since: 2.2 **/ gint gdk_screen_get_monitor_at_window (GdkScreen *screen, @@ -171,7 +175,7 @@ gdk_screen_get_monitor_at_window (GdkScreen *screen, * * Returns the width of the default screen in pixels. * - * Return value: the width of the default screen in pixels. + * Return value: the width of the default screen in pixels. **/ gint gdk_screen_width (void) diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c index e8d564ed6..468762612 100644 --- a/gdk/gdkwindow.c +++ b/gdk/gdkwindow.c @@ -694,7 +694,7 @@ gdk_window_remove_filter (GdkWindow *window, /** * gdk_screen_get_toplevel_windows: - * @screen : The #GdkScreen where the toplevels are located. + * @screen: The #GdkScreen where the toplevels are located. * * Obtains a list of all toplevel windows known to GDK on the screen @screen. * A toplevel window is a child of the root window (see @@ -704,6 +704,8 @@ gdk_window_remove_filter (GdkWindow *window, * its elements need not be freed. * * Return value: list of toplevel windows, free with g_list_free() + * + * Since: 2.2 **/ GList * gdk_screen_get_toplevel_windows (GdkScreen *screen) diff --git a/gdk/x11/gdkcolor-x11.c b/gdk/x11/gdkcolor-x11.c index 415709930..c4e6a4b0c 100644 --- a/gdk/x11/gdkcolor-x11.c +++ b/gdk/x11/gdkcolor-x11.c @@ -376,6 +376,8 @@ gdk_colormap_sync (GdkColormap *colormap, * Gets the system's default colormap for @screen * * Returns: the default colormap for @screen. + * + * Since: 2.2 */ GdkColormap * gdk_screen_get_system_colormap (GdkScreen *screen) @@ -1263,6 +1265,8 @@ gdk_color_change (GdkColormap *colormap, * with gdk_x11_colormap_foreign_new(), unref'ing the last * reference to the object will only free the #GdkColoramp * object and not call XFreeColormap() + * + * Since: 2.2 **/ GdkColormap * gdk_x11_colormap_foreign_new (GdkVisual *visual, @@ -1499,6 +1503,8 @@ gdk_x11_colormap_get_xcolormap (GdkColormap *colormap) * Gets the screen for which this colormap was created. * * Return value: the screen for which this colormap was created. + * + * Since: 2.2 **/ GdkScreen * gdk_colormap_get_screen (GdkColormap *cmap) diff --git a/gdk/x11/gdkcursor-x11.c b/gdk/x11/gdkcursor-x11.c index 649874518..a891df347 100644 --- a/gdk/x11/gdkcursor-x11.c +++ b/gdk/x11/gdkcursor-x11.c @@ -98,6 +98,8 @@ * a cursor with no pixels in it. * * Return value: a new #GdkCursor + * + * Since: 2.2 **/ GdkCursor* gdk_cursor_new_for_display (GdkDisplay *display, @@ -276,11 +278,13 @@ gdk_x11_cursor_get_xcursor (GdkCursor *cursor) /** * gdk_cursor_get_display: - * @cursor : a #GdkCursor. + * @cursor: a #GdkCursor. + * + * Returns the display on which the #GdkCursor is defined. * - * Returns the display on which the GdkCursor is defined + * Returns: the #GdkDisplay associated to @cursor * - * Returns : the #GdkDisplay associated to @cursor + * Since: 2.2 */ GdkDisplay * diff --git a/gdk/x11/gdkdisplay-x11.c b/gdk/x11/gdkdisplay-x11.c index aa8ee560c..7c4a328a4 100644 --- a/gdk/x11/gdkdisplay-x11.c +++ b/gdk/x11/gdkdisplay-x11.c @@ -99,6 +99,8 @@ gdk_display_x11_class_init (GdkDisplayX11Class * class) * could not be opened. * * Opens a display. + * + * Since: 2.2 */ GdkDisplay * gdk_display_open (const gchar *display_name) @@ -302,6 +304,8 @@ gdk_internal_connection_watch (Display *display, * * Returns: a string representing the display name. This string is owned * by GDK and should not be modified or freed. + * + * Since: 2.2 */ G_CONST_RETURN gchar * gdk_display_get_name (GdkDisplay * display) @@ -318,6 +322,8 @@ gdk_display_get_name (GdkDisplay * display) * Gets the number of screen managed by the @display. * * Returns: number of screens. + * + * Since: 2.2 */ gint gdk_display_get_n_screens (GdkDisplay * display) @@ -333,8 +339,10 @@ gdk_display_get_n_screens (GdkDisplay * display) * @screen_num: the screen number * * Returns a screen object for one of the screens of the display. - * + * * Returns: the #GdkScreen object + * + * Since: 2.2 */ GdkScreen * gdk_display_get_screen (GdkDisplay * display, gint screen_num) @@ -352,6 +360,8 @@ gdk_display_get_screen (GdkDisplay * display, gint screen_num) * Get the default #GdkScreen for @display. * * Returns: the default #GdkScreen object for @display + * + * Since: 2.2 */ GdkScreen * gdk_display_get_default_screen (GdkDisplay * display) @@ -382,10 +392,12 @@ _gdk_x11_display_is_root_window (GdkDisplay *display, /** * gdk_display_pointer_ungrab: - * @display : a #GdkDisplay. + * @display: a #GdkDisplay. * @time_: a timestap (e.g. GDK_CURRENT_TIME). * * Release any pointer grab. + * + * Since: 2.2 */ void gdk_display_pointer_ungrab (GdkDisplay *display, @@ -399,12 +411,14 @@ gdk_display_pointer_ungrab (GdkDisplay *display, } /** - * gdk_display_pointer_is_grabbed : - * @display : a #GdkDisplay + * gdk_display_pointer_is_grabbed: + * @display: a #GdkDisplay * * Test if the pointer is grabbed. * - * Returns : TRUE if an active X pointer grab is in effect + * Returns: %TRUE if an active X pointer grab is in effect + * + * Since: 2.2 */ gboolean gdk_display_pointer_is_grabbed (GdkDisplay * display) @@ -416,10 +430,12 @@ gdk_display_pointer_is_grabbed (GdkDisplay * display) /** * gdk_display_keyboard_ungrab: - * @display : a #GdkDisplay. - * @time_ : a timestap (e.g #GDK_CURRENT_TIME). + * @display: a #GdkDisplay. + * @time_: a timestap (e.g #GDK_CURRENT_TIME). * * Release any keyboard grab + * + * Since: 2.2 */ void gdk_display_keyboard_ungrab (GdkDisplay *display, @@ -437,6 +453,7 @@ gdk_display_keyboard_ungrab (GdkDisplay *display, * * Emits a short beep on @display * + * Since: 2.2 */ void gdk_display_beep (GdkDisplay * display) @@ -447,17 +464,20 @@ gdk_display_beep (GdkDisplay * display) } /** - * gdk_display_sync : - * @display : a #GdkDisplay + * gdk_display_sync: + * @display: a #GdkDisplay * * Flushes any requests queued for the windowing system and waits until all * requests have been handled. This is often used for making sure that the * display is synchronized with the current state of the program. Calling * gdk_display_sync() before gdk_error_trap_pop() makes sure that any errors - * generated from earlier requests are handled before the error trap is removed. + * generated from earlier requests are handled before the error trap is + * removed. * * This is most useful for X11. On windowing systems where requests are * handled synchronously, this function will do nothing. + * + * Since: 2.2 */ void gdk_display_sync (GdkDisplay * display) @@ -475,6 +495,8 @@ gdk_display_sync (GdkDisplay * display) * To ungrab the display again, use gdk_x11_display_ungrab(). * * gdk_x11_display_grab()/gdk_x11_display_ungrab() calls can be nested. + * + * Since: 2.2 **/ void gdk_x11_display_grab (GdkDisplay * display) @@ -496,6 +518,8 @@ gdk_x11_display_grab (GdkDisplay * display) * * Ungrab @display after it has been grabbed with * gdk_x11_display_grab(). + * + * Since: 2.2 **/ void gdk_x11_display_ungrab (GdkDisplay * display) @@ -582,6 +606,8 @@ gdk_display_x11_finalize (GObject *object) * Find the #GdkDisplay corresponding to @display, if any exists. * * Return value: the #GdkDisplay, if found, otherwise %NULL. + * + * Since: 2.2 **/ GdkDisplay * gdk_x11_lookup_xdisplay (Display *xdisplay) @@ -630,6 +656,8 @@ _gdk_x11_display_screen_for_xrootwin (GdkDisplay *display, * @returns: an X display. * * Returns the X display of a #GdkDisplay. + * + * Since: 2.2 */ Display * gdk_x11_display_get_xdisplay (GdkDisplay *display) @@ -794,9 +822,10 @@ broadcast_xmessage (GdkDisplay *display, * windows. * * GTK+ will call this function automatically after opening the first - * #GtkWindow unless - * gtk_window_set_auto_startup_notification() is called to disable - * that feature. + * #GtkWindow unless gtk_window_set_auto_startup_notification() is called + * to disable that feature. + * + * Since: 2.2 **/ void gdk_notify_startup_complete (void) diff --git a/gdk/x11/gdkdnd-x11.c b/gdk/x11/gdkdnd-x11.c index 500bcff3c..225744492 100644 --- a/gdk/x11/gdkdnd-x11.c +++ b/gdk/x11/gdkdnd-x11.c @@ -2794,6 +2794,8 @@ gdk_drag_begin (GdkWindow *window, * support Drag and Drop. * * Finds out the DND protocol supported by a window. + * + * Since: 2.2 */ guint32 gdk_drag_get_protocol_for_display (GdkDisplay *display, @@ -2909,6 +2911,8 @@ drag_context_find_window_cache (GdkDragContext *context, * * This function is called by the drag source to obtain the * @dest_window and @protocol parameters for gdk_drag_motion(). + * + * Since: 2.2 **/ void gdk_drag_find_window_for_screen (GdkDragContext *context, diff --git a/gdk/x11/gdkevents-x11.c b/gdk/x11/gdkevents-x11.c index b21098b4a..a97e204e9 100644 --- a/gdk/x11/gdkevents-x11.c +++ b/gdk/x11/gdkevents-x11.c @@ -315,6 +315,7 @@ gdk_event_apply_filters (XEvent *xevent, * * Adds a filter to be called when X ClientMessage events are received. * + * Since: 2.2 **/ void gdk_display_add_client_message_filter (GdkDisplay *display, @@ -1978,17 +1979,19 @@ gdk_event_dispatch (GSource *source, } /** - * gdk_event_send_client_message_for_display : - * @display : the #GdkDisplay for the window where the message is to be sent. - * @event : the #GdkEvent to send, which should be a #GdkEventClient. - * @winid : the window to send the X ClientMessage event to. + * gdk_event_send_client_message_for_display: + * @display: the #GdkDisplay for the window where the message is to be sent. + * @event: the #GdkEvent to send, which should be a #GdkEventClient. + * @winid: the window to send the X ClientMessage event to. * * Sends an X ClientMessage event to a given window. * * This could be used for communicating between different applications, * though the amount of data is limited to 20 bytes. * - * Returns : non-zero on success. + * Returns: non-zero on success. + * + * Since: 2.2 */ gboolean gdk_event_send_client_message_for_display (GdkDisplay *display, @@ -2074,8 +2077,8 @@ gdk_event_send_client_message_to_all_recurse (GdkDisplay *display, /** * gdk_screen_broadcast_client_message: - * @screen : the #GdkScreen where the event will be broadcasted. - * @event : the #GdkEvent. + * @screen: the #GdkScreen where the event will be broadcasted. + * @event: the #GdkEvent. * * Sends an X ClientMessage event to all toplevel windows on @screen. * @@ -2083,6 +2086,8 @@ gdk_event_send_client_message_to_all_recurse (GdkDisplay *display, * as described in the Inter-Client Communication Conventions Manual (ICCCM). * If no windows are found with the WM_STATE property set, the message is * sent to all children of the root window. + * + * Since: 2.2 */ void @@ -2253,6 +2258,8 @@ fetch_net_wm_check_window (GdkScreen *screen) * Return value: the name of the window manager screen @screen, or * "unknown" if the window manager is unknown. The string is owned by GDK * and should not be freed. + * + * Since: 2.2 **/ const char* gdk_x11_screen_get_window_manager_name (GdkScreen *screen) @@ -2318,13 +2325,14 @@ struct _NetWmSupportedAtoms /** * gdk_x11_screen_supports_net_wm_hint: - * @screen : the relevant #GdkScreen. + * @screen: the relevant #GdkScreen. * @property: a property atom. * * This function is specific to the X11 backend of GDK, and indicates * whether the window manager supports a certain hint from the * Extended Window Manager Hints Specification. You can find this - * specification on http://www.freedesktop.org. + * specification on + * http://www.freedesktop.org. * * When using this function, keep in mind that the window manager * can change over time; so you shouldn't use this function in @@ -2336,6 +2344,8 @@ struct _NetWmSupportedAtoms * a window manager change. * * Return value: %TRUE if the window manager supports @property + * + * Since: 2.2 **/ gboolean gdk_x11_screen_supports_net_wm_hint (GdkScreen *screen, @@ -2518,8 +2528,10 @@ check_transform (const gchar *xsettings_name, * FIXME needs a list of valid settings here, or a link to * more information. * - * Returns : %TRUE if the setting existed and a value was stored + * Returns: %TRUE if the setting existed and a value was stored * in @value, %FALSE otherwise. + * + * Since: 2.2 **/ gboolean gdk_screen_get_setting (GdkScreen *screen, diff --git a/gdk/x11/gdkfont-x11.c b/gdk/x11/gdkfont-x11.c index 0b3a55a99..9c809cd11 100644 --- a/gdk/x11/gdkfont-x11.c +++ b/gdk/x11/gdkfont-x11.c @@ -98,7 +98,9 @@ gdk_fontset_name_hash_get (GdkDisplay *display) * * Returns the #GdkDisplay for @font. * - * Returns : the corresponding #GdkDisplay. + * Returns: the corresponding #GdkDisplay. + * + * Since: 2.2 **/ GdkDisplay* gdk_font_get_display (GdkFont* font) @@ -174,6 +176,8 @@ gdk_font_hash_lookup (GdkDisplay *display, * * The font may be newly loaded or looked up the font in a cache. * You should make no assumptions about the initial reference count. + * + * Since: 2.2 */ GdkFont * gdk_font_load_for_display (GdkDisplay *display, @@ -274,6 +278,8 @@ gdk_font_charset_for_locale (void) * * Return value: the newly loaded font, or %NULL if the font * cannot be loaded. + * + * Since: 2.2 */ GdkFont * gdk_font_from_description_for_display (GdkDisplay *display, @@ -328,6 +334,8 @@ gdk_font_from_description_for_display (GdkDisplay *display, * * The fontset may be newly loaded or looked up in a cache. * You should make no assumptions about the initial reference count. + * + * Since: 2.2 */ GdkFont * gdk_fontset_load_for_display (GdkDisplay *display, diff --git a/gdk/x11/gdkgc-x11.c b/gdk/x11/gdkgc-x11.c index 20d9f8362..84b9dfe9a 100644 --- a/gdk/x11/gdkgc-x11.c +++ b/gdk/x11/gdkgc-x11.c @@ -742,6 +742,8 @@ gdk_gc_copy (GdkGC *dst_gc, GdkGC *src_gc) * Gets the #GdkScreen for which @gc was created * * Returns: the #GdkScreen for @gc. + * + * Since: 2.2 */ GdkScreen * gdk_gc_get_screen (GdkGC *gc) diff --git a/gdk/x11/gdkinput.c b/gdk/x11/gdkinput.c index f84404c01..eb9fc32ae 100644 --- a/gdk/x11/gdkinput.c +++ b/gdk/x11/gdkinput.c @@ -105,12 +105,14 @@ gdk_devices_list (void) /** * gdk_display_list_devices: - * @display : a #GdkDisplay + * @display: a #GdkDisplay * * Returns the list of available input devices attached to @display. * The list is statically allocated and should not be freed. * * Return value: a list of #GdkDevice + * + * Since: 2.2 **/ GList * gdk_display_list_devices (GdkDisplay *display) diff --git a/gdk/x11/gdkkeys-x11.c b/gdk/x11/gdkkeys-x11.c index 21cc28fa3..cec1f10d2 100644 --- a/gdk/x11/gdkkeys-x11.c +++ b/gdk/x11/gdkkeys-x11.c @@ -185,6 +185,8 @@ get_xkb (GdkKeymapX11 *keymap_x11) * @returns: the #GdkKeymap attached to @display. * * Returns the #GdkKeymap attached to @display. + * + * Since: 2.2 **/ GdkKeymap* gdk_keymap_get_for_display (GdkDisplay *display) diff --git a/gdk/x11/gdkpango-x11.c b/gdk/x11/gdkpango-x11.c index d67488947..464565188 100644 --- a/gdk/x11/gdkpango-x11.c +++ b/gdk/x11/gdkpango-x11.c @@ -41,6 +41,8 @@ * the widget you intend to render text onto. * * Return value: a new #PangoContext for @screen + * + * Since: 2.2 **/ PangoContext * gdk_pango_context_get_for_screen (GdkScreen *screen) diff --git a/gdk/x11/gdkpixmap-x11.c b/gdk/x11/gdkpixmap-x11.c index 459d9f23c..9d7276533 100644 --- a/gdk/x11/gdkpixmap-x11.c +++ b/gdk/x11/gdkpixmap-x11.c @@ -323,7 +323,7 @@ gdk_pixmap_create_from_data (GdkWindow *window, * @display: The #GdkDisplay where @anid is located. * @anid: a native pixmap handle. * - * Wraps a native window in a #GdkPixmap. + * Wraps a native pixmap in a #GdkPixmap. * This may fail if the pixmap has been destroyed. * * For example in the X backend, a native pixmap handle is an Xlib @@ -331,6 +331,8 @@ gdk_pixmap_create_from_data (GdkWindow *window, * * Return value: the newly-created #GdkPixmap wrapper for the * native pixmap or %NULL if the pixmap has been destroyed. + * + * Since: 2.2 **/ GdkPixmap * gdk_pixmap_foreign_new_for_display (GdkDisplay *display, @@ -417,7 +419,7 @@ gdk_pixmap_lookup (GdkNativeWindow anid) /** * gdk_pixmap_lookup_for_display: - * @display : the #GdkDisplay associated with @anid + * @display: the #GdkDisplay associated with @anid * @anid: a native pixmap handle. * * Looks up the #GdkPixmap that wraps the given native pixmap handle. @@ -425,8 +427,10 @@ gdk_pixmap_lookup (GdkNativeWindow anid) * For example in the X backend, a native pixmap handle is an Xlib * XID. * - * Return value: the #GdkWindow wrapper for the native window, + * Return value: the #GdkPixmap wrapper for the native pixmap, * or %NULL if there is none. + * + * Since: 2.2 **/ GdkPixmap* gdk_pixmap_lookup_for_display (GdkDisplay *display, GdkNativeWindow anid) diff --git a/gdk/x11/gdkproperty-x11.c b/gdk/x11/gdkproperty-x11.c index 162d16b55..139c5b52c 100644 --- a/gdk/x11/gdkproperty-x11.c +++ b/gdk/x11/gdkproperty-x11.c @@ -151,6 +151,8 @@ insert_atom_pair (GdkDisplay *display, * with the same string value. * * Return value: the X atom corresponding to @atom. + * + * Since: 2.2 **/ Atom gdk_x11_atom_to_xatom_for_display (GdkDisplay *display, @@ -211,6 +213,8 @@ gdk_x11_atom_to_xatom (GdkAtom atom) * #GdkAtom. * * Return value: the corresponding #GdkAtom. + * + * Since: 2.2 **/ GdkAtom gdk_x11_xatom_to_atom_for_display (GdkDisplay *display, @@ -338,9 +342,11 @@ gdk_atom_name (GdkAtom atom) * * Returns the X atom for a #GdkDisplay corresponding to @atom_name. * This function caches the result, so if called repeatedly it is much - * faster than XInternAtom, which is a round trip to the server each time. + * faster than XInternAtom(), which is a round trip to the server each time. * * Return value: a X atom for a #GdkDisplay + * + * Since: 2.2 **/ Atom gdk_x11_get_xatom_by_name_for_display (GdkDisplay *display, @@ -371,7 +377,7 @@ gdk_x11_get_xatom_by_name (const gchar *atom_name) /** * gdk_x11_get_xatom_name_for_display: - * @display : the #GdkDisplay where @xatom is defined + * @display: the #GdkDisplay where @xatom is defined * @xatom: an X atom * * Returns the name of an X atom for its display. This @@ -379,8 +385,10 @@ gdk_x11_get_xatom_by_name (const gchar *atom_name) * XAtomName() and gdk_atom_name(), the result doesn't need to * be freed. * - * Return value: name of the X atom; this string is owned by GTK+, + * Return value: name of the X atom; this string is owned by GDK, * so it shouldn't be modifed or freed. + * + * Since: 2.2 **/ G_CONST_RETURN gchar * gdk_x11_get_xatom_name_for_display (GdkDisplay *display, diff --git a/gdk/x11/gdkscreen-x11.c b/gdk/x11/gdkscreen-x11.c index c8f819727..3ad5cd9f1 100644 --- a/gdk/x11/gdkscreen-x11.c +++ b/gdk/x11/gdkscreen-x11.c @@ -110,6 +110,8 @@ gdk_screen_x11_class_init (GdkScreenX11Class *klass) * Gets the display to which the @screen belongs. * * Returns: the display to which @screen belongs + * + * Since: 2.2 **/ GdkDisplay * gdk_screen_get_display (GdkScreen *screen) @@ -125,6 +127,8 @@ gdk_screen_get_display (GdkScreen *screen) * Gets the width of @screen in pixels * * Returns: the width of @screen in pixels. + * + * Since: 2.2 **/ gint gdk_screen_get_width (GdkScreen *screen) @@ -141,6 +145,8 @@ gdk_screen_get_width (GdkScreen *screen) * Gets the height of @screen in pixels * * Returns: the height of @screen in pixels. + * + * Since: 2.2 **/ gint gdk_screen_get_height (GdkScreen *screen) @@ -158,6 +164,8 @@ gdk_screen_get_height (GdkScreen *screen) * Note that on some X servers this value will not be correct. * * Returns: the width of @screen in pixels. + * + * Since: 2.2 **/ gint gdk_screen_get_width_mm (GdkScreen *screen) @@ -175,6 +183,8 @@ gdk_screen_get_width_mm (GdkScreen *screen) * Note that on some X servers this value will not be correct. * * Returns: the heigth of @screen in pixels. + * + * Since: 2.2 **/ gint gdk_screen_get_height_mm (GdkScreen *screen) @@ -192,6 +202,8 @@ gdk_screen_get_height_mm (GdkScreen *screen) * to which it belongs. (See gdk_screen_get_display()) * * Returns: the index + * + * Since: 2.2 **/ gint gdk_screen_get_number (GdkScreen *screen) @@ -208,6 +220,8 @@ gdk_screen_get_number (GdkScreen *screen) * Gets the root window of @screen. * * Returns: the root window + * + * Since: 2.2 **/ GdkWindow * gdk_screen_get_root_window (GdkScreen *screen) @@ -224,6 +238,8 @@ gdk_screen_get_root_window (GdkScreen *screen) * Gets the default colormap for @screen. * * Returns: the default #GdkColormap. + * + * Since: 2.2 **/ GdkColormap * gdk_screen_get_default_colormap (GdkScreen *screen) @@ -239,6 +255,8 @@ gdk_screen_get_default_colormap (GdkScreen *screen) * @colormap: a #GdkColormap * * Sets the default @colormap for @screen. + * + * Since: 2.2 **/ void gdk_screen_set_default_colormap (GdkScreen *screen, @@ -304,12 +322,14 @@ gdk_screen_x11_finalize (GObject *object) /** * gdk_screen_get_n_monitors: - * @screen : a #GdkScreen. + * @screen: a #GdkScreen. * * Returns the number of monitors being part of the virtual screen * * Returns: number of monitors part of the virtual screen or * 0 if @screen is not in virtual screen mode. + * + * Since: 2.2 **/ gint gdk_screen_get_n_monitors (GdkScreen *screen) @@ -332,6 +352,7 @@ gdk_screen_get_n_monitors (GdkScreen *screen) * Note that the virtual screen coordinates can be retrieved via * gdk_screen_get_width() and gdk_screen_get_height(). * + * Since: 2.2 **/ void gdk_screen_get_monitor_geometry (GdkScreen *screen, @@ -351,6 +372,8 @@ gdk_screen_get_monitor_geometry (GdkScreen *screen, * @returns: an Xlib Screen* * * Returns the screen of a #GdkScreen. + * + * Since: 2.2 */ Screen * gdk_x11_screen_get_xscreen (GdkScreen *screen) @@ -366,6 +389,8 @@ gdk_x11_screen_get_xscreen (GdkScreen *screen) * its display. * * Returns the index of a #GdkScreen. + * + * Since: 2.2 */ int gdk_x11_screen_get_screen_number (GdkScreen *screen) @@ -608,6 +633,8 @@ _gdk_windowing_substitute_screen_number (const gchar *display_name, * a #GdkDisplay with this screen as the default screen. * * Return value: a newly allocated string, free with g_free() + * + * Since: 2.2 **/ gchar * gdk_screen_make_display_name (GdkScreen *screen) diff --git a/gdk/x11/gdkselection-x11.c b/gdk/x11/gdkselection-x11.c index 0f55b77f4..5a83ccdbc 100644 --- a/gdk/x11/gdkselection-x11.c +++ b/gdk/x11/gdkselection-x11.c @@ -101,20 +101,22 @@ _gdk_selection_filter_clear_event (XSelectionClearEvent *event) } /** * gdk_selection_owner_set_for_display: - * @display : the #GdkDisplay. - * @owner : a GdkWindow or NULL to indicate that the the owner for - * the given should be unset. - * @selection : an atom identifying a selection. - * @time_ : timestamp to use when setting the selection. - * If this is older than the timestamp given last time the owner was - * set for the given selection, the request will be ignored. - * @send_event : if TRUE, and the new owner is different from the current - * owner, the current owner will be sent a SelectionClear event. + * @display: the #GdkDisplay. + * @owner: a #GdkWindow or %NULL to indicate that the the owner for + * the given should be unset. + * @selection: an atom identifying a selection. + * @time_: timestamp to use when setting the selection. + * If this is older than the timestamp given last time the owner was + * set for the given selection, the request will be ignored. + * @send_event: if %TRUE, and the new owner is different from the current + * owner, the current owner will be sent a SelectionClear event. * * Sets the #GdkWindow @owner as the current owner of the selection @selection. * - * Returns : TRUE if the selection owner was succesfully changed to owner, - * otherwise FALSE. + * Returns: %TRUE if the selection owner was successfully changed to owner, + * otherwise %FALSE. + * + * Since: 2.2 */ gboolean gdk_selection_owner_set_for_display (GdkDisplay *display, @@ -179,9 +181,9 @@ gdk_selection_owner_set_for_display (GdkDisplay *display, } /** - * gdk_selection_owner_get_for_display : - * @display : a #GdkDisplay. - * @selection : an atom indentifying a selection. + * gdk_selection_owner_get_for_display: + * @display: a #GdkDisplay. + * @selection: an atom indentifying a selection. * * Determine the owner of the given selection. * @@ -189,11 +191,12 @@ gdk_selection_owner_set_for_display (GdkDisplay *display, * process if a foreign window was previously created for that * window, but a new foreign window will never be created by this call. * - * Returns :if there is a selection owner for this window, - * and it is a window known to the current process, the GdkWindow that owns - * the selection, otherwise NULL. + * Returns: if there is a selection owner for this window, and it is a + * window known to the current process, the #GdkWindow that owns the + * selection, otherwise %NULL. + * + * Since: 2.2 */ - GdkWindow * gdk_selection_owner_get_for_display (GdkDisplay *display, GdkAtom selection) @@ -364,15 +367,17 @@ gdk_selection_property_get (GdkWindow *requestor, /** * gdk_selection_send_notify_for_display: - * @display : the #GdkDisplay where @requestor is realized - * @requestor : window to which to deliver response. - * @selection : selection that was requested. - * @target : target that was selected. - * @property : property in which the selection owner stored the data, - * or GDK_NONE to indicate that the request was rejected. - * @time_ : timestamp. + * @display: the #GdkDisplay where @requestor is realized + * @requestor: window to which to deliver response. + * @selection: selection that was requested. + * @target: target that was selected. + * @property: property in which the selection owner stored the data, + * or %GDK_NONE to indicate that the request was rejected. + * @time_: timestamp. * * Send a response to SelectionRequest event. + * + * Since: 2.2 **/ void gdk_selection_send_notify_for_display (GdkDisplay *display, @@ -402,22 +407,24 @@ gdk_selection_send_notify_for_display (GdkDisplay *display, * gdk_text_property_to_text_list_for_display: * @display: The #GdkDisplay where the encoding is defined. * @encoding: an atom representing the encoding. The most - * common values for this are STRING, or COMPOUND_TEXT. - * This is value used as the type for the property. + * common values for this are STRING, or COMPOUND_TEXT. + * This is value used as the type for the property. * @format: the format of the property. * @text: The text data. * @length: The number of items to transform. * @list: location to store a terminated array of strings in - * the encoding of the current locale. This array should be - * freed using gdk_free_text_list(). + * the encoding of the current locale. This array should be + * freed using gdk_free_text_list(). * * Convert a text string from the encoding as it is stored * in a property into an array of strings in the encoding of - * the current local. (The elements of the array represent the - * null-separated elements of the original text string.) + * the current locale. (The elements of the array represent the + * nul-separated elements of the original text string.) * - * Returns : the number of strings stored in list, or 0, + * Returns: the number of strings stored in list, or 0, * if the conversion failed. + * + * Since: 2.2 */ gint gdk_text_property_to_text_list_for_display (GdkDisplay *display, @@ -545,11 +552,13 @@ make_list (const gchar *text, * @list: location to store the list of strings or %NULL. The * list should be freed with g_strfreev(). * - * Converts a text property in the giving encoding to + * Converts a text property in the given encoding to * a list of UTF-8 strings. * * Return value: the number of strings in the resulting * list. + * + * Since: 2.2 **/ gint gdk_text_property_to_utf8_list_for_display (GdkDisplay *display, @@ -634,8 +643,8 @@ gdk_text_property_to_utf8_list_for_display (GdkDisplay *display, /** * gdk_string_to_compound_text_for_display: - * @display : the #GdkDisplay where the encoding is defined. - * @str : a null-terminated string. + * @display: the #GdkDisplay where the encoding is defined. + * @str: a nul-terminated string. * @encoding: location to store the encoding atom * (to be used as the type for the property). * @format: location to store the format of the property @@ -645,7 +654,9 @@ gdk_text_property_to_utf8_list_for_display (GdkDisplay *display, * Convert a string from the encoding of the current * locale into a form suitable for storing in a window property. * - * Returns : 0 upon sucess, non-zero upon failure. + * Returns: 0 upon sucess, non-zero upon failure. + * + * Since: 2.2 **/ gint gdk_string_to_compound_text_for_display (GdkDisplay *display, @@ -777,6 +788,8 @@ gdk_utf8_to_string_target (const gchar *str) * * Return value: %TRUE if the conversion succeeded, otherwise * %FALSE. + * + * Since: 2.2 **/ gboolean gdk_utf8_to_compound_text_for_display (GdkDisplay *display, diff --git a/gdk/x11/gdkvisual-x11.c b/gdk/x11/gdkvisual-x11.c index 7de791221..b1eae4e1f 100644 --- a/gdk/x11/gdkvisual-x11.c +++ b/gdk/x11/gdkvisual-x11.c @@ -341,13 +341,15 @@ gdk_visual_get_best_type (void) /** * gdk_screen_get_system_visual: - * @screen : a #GdkScreen. + * @screen: a #GdkScreen. * * Get the system's default visual for @screen. * This is the visual for the root window of the display. * The return value should not be freed. * - * Return value: system visual + * Return value: the system visual + * + * Since: 2.2 **/ GdkVisual * gdk_screen_get_system_visual (GdkScreen * screen) @@ -507,7 +509,7 @@ gdk_query_visual_types (GdkVisualType **visual_types, /** * gdk_screen_list_visuals: - * @screen : the relevant #GdkScreen. + * @screen: the relevant #GdkScreen. * * Lists the available visuals for the specified @screen. * A visual describes a hardware image data format. @@ -516,7 +518,10 @@ gdk_query_visual_types (GdkVisualType **visual_types, * * Call g_list_free() on the return value when you're finished with it. * - * Return value: a list of visuals; the list must be freed, but not its contents + * Return value: a list of visuals; the list must be freed, but not its + * contents + * + * Since: 2.2 **/ GList * gdk_screen_list_visuals (GdkScreen *screen) @@ -537,7 +542,7 @@ gdk_screen_list_visuals (GdkScreen *screen) } /** - * gdk_x11_screen_lookup_visual + * gdk_x11_screen_lookup_visual: * @screen: a #GdkScreen. * @xvisualid: an X Visual ID. * @@ -545,6 +550,8 @@ gdk_screen_list_visuals (GdkScreen *screen) * * Returns: the #GdkVisual (owned by the screen object), or %NULL * if the visual ID wasn't found. + * + * Since: 2.2 */ GdkVisual * gdk_x11_screen_lookup_visual (GdkScreen *screen, @@ -646,6 +653,8 @@ gdk_x11_visual_get_xvisual (GdkVisual *visual) * Gets the screen to which this visual belongs * * Return value: the screen to which this visual belongs. + * + * Since: 2.2 **/ GdkScreen * gdk_visual_get_screen (GdkVisual *visual) diff --git a/gdk/x11/gdkwindow-x11.c b/gdk/x11/gdkwindow-x11.c index 3904619f9..14602a20c 100644 --- a/gdk/x11/gdkwindow-x11.c +++ b/gdk/x11/gdkwindow-x11.c @@ -734,6 +734,8 @@ x_event_mask_to_gdk_event_mask (long mask) * * Return value: the newly-created #GdkWindow wrapper for the * native window or %NULL if the window has been destroyed. + * + * Since: 2.2 **/ GdkWindow * gdk_window_foreign_new_for_display (GdkDisplay *display, @@ -820,6 +822,8 @@ gdk_window_foreign_new_for_display (GdkDisplay *display, * * Return value: the #GdkWindow wrapper for the native window, * or %NULL if there is none. + * + * Since: 2.2 **/ GdkWindow * gdk_window_lookup_for_display (GdkDisplay *display, GdkNativeWindow anid) @@ -1761,6 +1765,8 @@ gdk_window_set_modal_hint (GdkWindow *window, * function should NOT be called in addition, instead you should allow * the window to be treated according to standard policy for its * semantic type. + * + * Since: 2.2 **/ void gdk_window_set_skip_taskbar_hint (GdkWindow *window, @@ -1798,6 +1804,8 @@ gdk_window_set_skip_taskbar_hint (GdkWindow *window, * already fully describes the window, this function should NOT be * called in addition, instead you should allow the window to be * treated according to standard policy for its semantic type. + * + * Since: 2.2 **/ void gdk_window_set_skip_pager_hint (GdkWindow *window, @@ -3595,6 +3603,7 @@ gdk_window_unmaximize (GdkWindow *window) * most standard window managers, and GDK makes a best effort to get * it to happen. * + * Since: 2.2 **/ void gdk_window_fullscreen (GdkWindow *window) @@ -3628,8 +3637,9 @@ gdk_window_fullscreen (GdkWindow *window) * don't have a concept of "fullscreen"; so you can't rely on the * unfullscreenification actually happening. But it will happen with * most standard window managers, and GDK makes a best effort to get - * it to happen. - * + * it to happen. + * + * Since: 2.2 **/ void gdk_window_unfullscreen (GdkWindow *window) diff --git a/gdk/x11/gdkxid.c b/gdk/x11/gdkxid.c index 92c8cecb4..ac851208b 100644 --- a/gdk/x11/gdkxid.c +++ b/gdk/x11/gdkxid.c @@ -68,12 +68,14 @@ _gdk_xid_table_remove (GdkDisplay *display, /** * gdk_xid_table_lookup_for_display: - * @display : the #GdkDisplay. - * @xid : an X id. + * @display: the #GdkDisplay. + * @xid: an X id. * - * Returns the Gdk object associated with the given X id. + * Returns the GDK object associated with the given X id. + * + * Returns: a GDK object associated with the given X id. * - * Returns: an GdkObject associated with the given X id. + * Since: 2.2 */ gpointer gdk_xid_table_lookup_for_display (GdkDisplay *display, diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c index 778e03219..8415918d4 100644 --- a/gtk/gtkclipboard.c +++ b/gtk/gtkclipboard.c @@ -190,6 +190,8 @@ clipboard_display_closed (GdkDisplay *display, * be created. Once a clipboard object has * been created, it is persistent for all time and * cannot be freed. + * + * Since: 2.2 **/ GtkClipboard * gtk_clipboard_get_for_display (GdkDisplay *display, GdkAtom selection) @@ -955,6 +957,8 @@ gtk_clipboard_wait_for_text (GtkClipboard *clipboard) * Gets the #GdkDisplay associated with @clipboard * * Return value: the #GdkDisplay associated with @clipboard + * + * Since: 2.2 **/ GdkDisplay * gtk_clipboard_get_display (GtkClipboard *clipboard) diff --git a/gtk/gtkcolorsel.c b/gtk/gtkcolorsel.c index c7d793618..6588ece9c 100644 --- a/gtk/gtkcolorsel.c +++ b/gtk/gtkcolorsel.c @@ -2708,6 +2708,8 @@ gtk_color_selection_set_change_palette_hook (GtkColorSelectionChangePaletteFunc * "gtk-color-palette" so all GtkColorSelection widgets will be modified. * * Return value: the previous change palette hook (that was replaced). + * + * Since: 2.2 **/ GtkColorSelectionChangePaletteWithScreenFunc gtk_color_selection_set_change_palette_with_screen_hook (GtkColorSelectionChangePaletteWithScreenFunc func) diff --git a/gtk/gtkiconfactory.c b/gtk/gtkiconfactory.c index a3ed80778..dedd12b4d 100644 --- a/gtk/gtkiconfactory.c +++ b/gtk/gtkiconfactory.c @@ -1212,6 +1212,8 @@ icon_size_lookup_intern (GtkSettings *settings, * the usual size. * * Return value: %TRUE if @size was a valid size + * + * Since: 2.2 **/ gboolean gtk_icon_size_lookup_for_settings (GtkSettings *settings, diff --git a/gtk/gtkinvisible.c b/gtk/gtkinvisible.c index 4e1418e0a..7b7896bf3 100644 --- a/gtk/gtkinvisible.c +++ b/gtk/gtkinvisible.c @@ -156,6 +156,8 @@ gtk_invisible_destroy (GtkObject *object) * Creates a new #GtkInvisible object for a specified screen * * Return value: a newly created #GtkInvisible object + * + * Since: 2.2 **/ GtkWidget* gtk_invisible_new_for_screen (GdkScreen *screen) @@ -184,6 +186,8 @@ gtk_invisible_new (void) * @screen: a #GdkScreen. * * Sets the #GdkScreen where the #GtkInvisible object will be displayed. + * + * Since: 2.2 **/ void gtk_invisible_set_screen (GtkInvisible *invisible, @@ -222,7 +226,9 @@ gtk_invisible_set_screen (GtkInvisible *invisible, * * Returns the #GdkScreen object associated with @invisible * - * Return value : the associated #GdkScreen. + * Return value: the associated #GdkScreen. + * + * Since: 2.2 **/ GdkScreen * gtk_invisible_get_screen (GtkInvisible *invisible) diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c index a8d5b43b7..19104a894 100644 --- a/gtk/gtkliststore.c +++ b/gtk/gtkliststore.c @@ -1373,6 +1373,8 @@ gtk_list_store_clear (GtkListStore *list_store) * Checks if the given iter is a valid iter for this #GtkListStore. * * Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid. + * + * Since: 2.2 **/ gboolean gtk_list_store_iter_is_valid (GtkListStore *list_store, @@ -1637,6 +1639,8 @@ gtk_list_store_reorder_func (gconstpointer a, * * Reorders @store to follow the order indicated by @new_order. Note that * this function only works with unsorted stores. + * + * Since: 2.2 **/ void gtk_list_store_reorder (GtkListStore *store, @@ -1692,6 +1696,8 @@ gtk_list_store_reorder (GtkListStore *store, * * Swaps @a and @b in @store. Note that this function only works with * unsorted stores. + * + * Since: 2.2 **/ void gtk_list_store_swap (GtkListStore *store, @@ -1952,6 +1958,8 @@ free_paths_and_out: * Moves @iter in @store to the position before @position. Note that this * function only works with unsorted stores. If @position is %NULL, @iter * will be moved to the end of the list. + * + * Since: 2.2 **/ void gtk_list_store_move_before (GtkListStore *store, @@ -1965,11 +1973,13 @@ gtk_list_store_move_before (GtkListStore *store, * gtk_list_store_move_after: * @store: A #GtkListStore. * @iter: A #GtkTreeIter. - * @position: A #GtkTreeIter, or %NULL. + * @position: A #GtkTreeIter or %NULL. * * Moves @iter in @store to the position after @position. Note that this * function only works with unsorted stores. If @position is %NULL, @iter * will be moved to the start of the list. + * + * Since: 2.2 **/ void gtk_list_store_move_after (GtkListStore *store, diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c index 0e50ebf26..d7c06650c 100644 --- a/gtk/gtkmenu.c +++ b/gtk/gtkmenu.c @@ -2957,6 +2957,8 @@ gtk_menu_hide_all (GtkWidget *widget) * determined by the widget the menu is attached to. * * Sets the #GdkScreen on which the menu will be displayed. + * + * Since: 2.2 **/ void gtk_menu_set_screen (GtkMenu *menu, diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c index 683de2666..2cded4b87 100644 --- a/gtk/gtkmenushell.c +++ b/gtk/gtkmenushell.c @@ -1003,6 +1003,8 @@ gtk_menu_shell_move_selected (GtkMenuShell *menu_shell, * Select the first visible or selectable child of the menu shell; * don't select tearoff items unless the only item is a tearoff * item. + * + * Since: 2.2 **/ void gtk_menu_shell_select_first (GtkMenuShell *menu_shell, diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c index 51d3dd963..ab2b2ab98 100644 --- a/gtk/gtknotebook.c +++ b/gtk/gtknotebook.c @@ -4199,6 +4199,8 @@ gtk_notebook_get_nth_page (GtkNotebook *notebook, * Gets the number of pages in a notebook. * * Return value: the number of pages in the notebook. + * + * Since: 2.2 **/ gint gtk_notebook_get_n_pages (GtkNotebook *notebook) diff --git a/gtk/gtkplug.c b/gtk/gtkplug.c index fbf25e0f3..17345563e 100644 --- a/gtk/gtkplug.c +++ b/gtk/gtkplug.c @@ -351,6 +351,8 @@ gtk_plug_construct (GtkPlug *plug, * Finish the initialization of @plug for a given #GtkSocket identified by * @socket_id which is currently displayed on @display. * This function will generally only be used by classes deriving from #GtkPlug. + * + * Since: 2.2 **/ void gtk_plug_construct_for_display (GtkPlug *plug, @@ -408,6 +410,8 @@ gtk_plug_new (GdkNativeWindow socket_id) * Create a new plug widget inside the #GtkSocket identified by socket_id. * * Return value: the new #GtkPlug widget. + * + * Since: 2.2 */ GtkWidget* gtk_plug_new_for_display (GdkDisplay *display, diff --git a/gtk/gtkselection.c b/gtk/gtkselection.c index c8a9ec6f0..700494ff2 100644 --- a/gtk/gtkselection.c +++ b/gtk/gtkselection.c @@ -306,6 +306,8 @@ gtk_target_list_find (GtkTargetList *list, * if @widget is %NULL, release ownership of the selection. * * Return value: TRUE if the operation succeeded + * + * Since: 2.2 */ gboolean gtk_selection_owner_set_for_display (GdkDisplay *display, @@ -1024,6 +1026,8 @@ gtk_selection_init (void) * be deprecated in future versions of GTK+. * * Return value: %TRUE if the event was handled, otherwise false + * + * Since: 2.2 **/ gboolean gtk_selection_clear (GtkWidget *widget, diff --git a/gtk/gtksettings.c b/gtk/gtksettings.c index ae5ed3cb7..87661612b 100644 --- a/gtk/gtksettings.c +++ b/gtk/gtksettings.c @@ -272,6 +272,8 @@ gtk_settings_finalize (GObject *object) * Gets the #GtkSettings object for @screen, creating it if necessary. * * Return value: a #GtkSettings object. + * + * Since: 2.2 */ GtkSettings* gtk_settings_get_for_screen (GdkScreen *screen) diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c index f79569275..2c4a94a53 100644 --- a/gtk/gtktreemodel.c +++ b/gtk/gtktreemodel.c @@ -226,6 +226,8 @@ gtk_tree_path_new_from_string (const gchar *path) * Creates a new path with @first_index and @varargs as indices. * * Return value: A newly created GtkTreePath. + * + * Since: 2.2 **/ GtkTreePath * gtk_tree_path_new_from_indices (gint first_index, @@ -787,6 +789,8 @@ gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model, * acceptable return value for this string. * * Return value: A newly-allocated string. Must be freed with g_free(). + * + * Since: 2.2 **/ gchar * gtk_tree_model_get_string_from_iter (GtkTreeModel *tree_model, @@ -1779,6 +1783,16 @@ gtk_tree_row_reference_valid (GtkTreeRowReference *reference) } +/** + * gtk_tree_row_reference_copy: + * @reference: a #GtkTreeRowReference + * + * Copies a #GtkTreeRowReference. + * + * Return value: a copy of @reference. + * + * Since: 2.2 + **/ GtkTreeRowReference * gtk_tree_row_reference_copy (GtkTreeRowReference *reference) { diff --git a/gtk/gtktreemodelsort.c b/gtk/gtktreemodelsort.c index d3bc741ad..6817b2253 100644 --- a/gtk/gtktreemodelsort.c +++ b/gtk/gtktreemodelsort.c @@ -2348,6 +2348,8 @@ gtk_tree_model_sort_iter_is_valid_helper (GtkTreeIter *iter, * Checks if the given iter is a valid iter for this #GtkTreeModelSort. * * Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid. + * + * Since: 2.2 **/ gboolean gtk_tree_model_sort_iter_is_valid (GtkTreeModelSort *tree_model_sort, diff --git a/gtk/gtktreeselection.c b/gtk/gtktreeselection.c index a6fc4cd0b..fed25adbc 100644 --- a/gtk/gtktreeselection.c +++ b/gtk/gtktreeselection.c @@ -422,6 +422,8 @@ gtk_tree_selection_get_selected (GtkTreeSelection *selection, * * * Return value: A #GList containing a #GtkTreePath for each selected row. + * + * Since: 2.2 **/ GList * gtk_tree_selection_get_selected_rows (GtkTreeSelection *selection, @@ -543,6 +545,8 @@ gtk_tree_selection_count_selected_rows_helper (GtkRBTree *tree, * Returns the number of rows that have been selected in @tree. * * Return value: The number of rows selected. + * + * Since: 2.2 **/ gint gtk_tree_selection_count_selected_rows (GtkTreeSelection *selection) @@ -1257,6 +1261,8 @@ gtk_tree_selection_select_range (GtkTreeSelection *selection, * * Unselects a range of nodes, determined by @start_path and @end_path * inclusive. + * + * Since: 2.2 **/ void gtk_tree_selection_unselect_range (GtkTreeSelection *selection, diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c index d322e95c0..413c57b11 100644 --- a/gtk/gtktreestore.c +++ b/gtk/gtktreestore.c @@ -1542,6 +1542,8 @@ gtk_tree_store_iter_is_valid_helper (GtkTreeIter *iter, * Checks if the given iter is a valid iter for this #GtkTreeStore. * * Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid. + * + * Since: 2.2 **/ gboolean gtk_tree_store_iter_is_valid (GtkTreeStore *tree_store, @@ -1901,6 +1903,8 @@ gtk_tree_store_reorder_func (gconstpointer a, * Reorders the children of @parent in @tree_store to follow the order * indicated by @new_order. Note that this function only works with * unsorted stores. + * + * Since: 2.2 **/ void gtk_tree_store_reorder (GtkTreeStore *tree_store, @@ -1981,6 +1985,8 @@ gtk_tree_store_reorder (GtkTreeStore *tree_store, * * Swaps @a and @b in the same level of @tree_store. Note that this function * only works with unsorted stores. + * + * Since: 2.2 **/ void gtk_tree_store_swap (GtkTreeStore *tree_store, @@ -2418,6 +2424,8 @@ free_paths_and_out: * @position should be in the same level. Note that this function only * works with unsorted stores. If @position is %NULL, @iter will be * moved to the end of the level. + * + * Since: 2.2 **/ void gtk_tree_store_move_before (GtkTreeStore *tree_store, @@ -2437,6 +2445,8 @@ gtk_tree_store_move_before (GtkTreeStore *tree_store, * @position should be in the same level. Note that this function only * works with unsorted stores. If @position is %NULL, @iter will be moved * to the start of the level. + * + * Since: 2.2 **/ void gtk_tree_store_move_after (GtkTreeStore *tree_store, diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c index 5377e901e..b42dac119 100644 --- a/gtk/gtktreeview.c +++ b/gtk/gtktreeview.c @@ -8971,6 +8971,8 @@ gtk_tree_view_collapse_all (GtkTreeView *tree_view) * * Expands the row at @path. This will also expand all parent rows of * @path as necessary. + * + * Since: 2.2 **/ void gtk_tree_view_expand_to_path (GtkTreeView *tree_view, @@ -9617,6 +9619,8 @@ gtk_tree_view_set_cursor (GtkTreeView *tree_view, * @gtk_widget_grab_focus (@tree_view) in order to give keyboard focus to the * widget. Please note that editing can only happen when the widget is * realized. + * + * Since: 2.2 **/ void gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view, diff --git a/gtk/gtktreeviewcolumn.c b/gtk/gtktreeviewcolumn.c index 9bfd44662..1ca07088a 100644 --- a/gtk/gtktreeviewcolumn.c +++ b/gtk/gtktreeviewcolumn.c @@ -3122,6 +3122,8 @@ gtk_tree_view_column_cell_is_visible (GtkTreeViewColumn *tree_column) * * Sets the current keyboard focus to be at @cell, if the column contains * 2 or more editable and activatable cells. + * + * Since: 2.2 **/ void gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column, diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index ccfd756a4..1e64f51a6 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -4760,6 +4760,8 @@ gtk_widget_get_screen_unchecked (GtkWidget *widget) * free those resources when the widget is unrealized. * * Return value: the #GdkScreen for the toplevel for this widget. + * + * Since: 2.2 **/ GdkScreen* gtk_widget_get_screen (GtkWidget *widget) @@ -4796,6 +4798,8 @@ gtk_widget_get_screen (GtkWidget *widget) * * Return value: %TRUE if there is a #GdkScreen associcated * with the widget. + * + * Since: 2.2 **/ gboolean gtk_widget_has_screen (GtkWidget *widget) @@ -4818,6 +4822,8 @@ gtk_widget_has_screen (GtkWidget *widget) * free those resources when the widget is unrealized. * * Return value: the #GdkDisplay for the toplevel for this widget. + * + * Since: 2.2 **/ GdkDisplay* gtk_widget_get_display (GtkWidget *widget) @@ -4841,6 +4847,8 @@ gtk_widget_get_display (GtkWidget *widget) * and you should free those resources when the widget is unrealized. * * Return value: the #GdkWindow root window for the toplevel for this widget. + * + * Since: 2.2 **/ GdkWindow* gtk_widget_get_root_window (GtkWidget *widget) @@ -6403,6 +6411,8 @@ gtk_widget_class_install_style_property (GtkWidgetClass *class, * style property with that name. * * Finds a style property of a widget class by name. + * + * Since: 2.2 */ GParamSpec* gtk_widget_class_find_style_property (GtkWidgetClass *klass, @@ -6423,6 +6433,8 @@ gtk_widget_class_find_style_property (GtkWidgetClass *klass, * @returns: an newly allocated array of #GParamSpec*. The array must be freed with g_free(). * * Returns all style properties of a widget class. + * + * Since: 2.2 */ GParamSpec** gtk_widget_class_list_style_properties (GtkWidgetClass *klass, @@ -6832,6 +6844,8 @@ gtk_widget_ref_accessible (AtkImplementor *implementor) * clipboard already exists, a new one will * be created. Once a clipboard object has * been created, it is persistent for all time. + * + * Since: 2.2 **/ GtkClipboard * gtk_widget_get_clipboard (GtkWidget *widget, GdkAtom selection) diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index bee766c3b..13e7a0da3 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -1894,6 +1894,7 @@ gtk_window_get_type_hint (GtkWindow *window) * Windows may set a hint asking the desktop environment not to display * the window in the task bar. This function toggles this hint. * + * Since: 2.2 **/ void gtk_window_set_skip_taskbar_hint (GtkWindow *window, @@ -1924,6 +1925,8 @@ gtk_window_set_skip_taskbar_hint (GtkWindow *window, * Gets the value set by gtk_window_set_skip_taskbar_hint() * * Return value: %TRUE if window shouldn't be in taskbar + * + * Since: 2.2 **/ gboolean gtk_window_get_skip_taskbar_hint (GtkWindow *window) @@ -1948,6 +1951,7 @@ gtk_window_get_skip_taskbar_hint (GtkWindow *window) * switcher that displays a thumbnail representation of the windows * on the screen.) * + * Since: 2.2 **/ void gtk_window_set_skip_pager_hint (GtkWindow *window, @@ -1978,6 +1982,8 @@ gtk_window_set_skip_pager_hint (GtkWindow *window, * Gets the value set by gtk_window_set_skip_pager_hint(). * * Return value: %TRUE if window shouldn't be in pager + * + * Since: 2.2 **/ gboolean gtk_window_get_skip_pager_hint (GtkWindow *window) @@ -2649,6 +2655,8 @@ load_pixbuf_verbosely (const char *filename, * with a pixbuf created by loading the image from @filename. * * Returns: %TRUE if setting the icon succeeded. + * + * Since: 2.2 **/ gboolean gtk_window_set_icon_from_file (GtkWindow *window, @@ -2732,6 +2740,8 @@ gtk_window_set_default_icon_list (GList *list) * on disk. Warns on failure if @err is %NULL. * * Returns: %TRUE if setting the icon succeeded. + * + * Since: 2.2 **/ gboolean gtk_window_set_default_icon_from_file (const gchar *filename, @@ -5743,6 +5753,7 @@ gtk_window_unmaximize (GtkWindow *window) * You can track the fullscreen state via the "window_state_event" signal * on #GtkWidget. * + * Since: 2.2 **/ void gtk_window_fullscreen (GtkWindow *window) @@ -5782,6 +5793,7 @@ gtk_window_fullscreen (GtkWindow *window) * You can track the fullscreen state via the "window_state_event" signal * on #GtkWidget. * + * Since: 2.2 **/ void gtk_window_unfullscreen (GtkWindow *window) @@ -6021,6 +6033,8 @@ gtk_window_begin_move_drag (GtkWindow *window, * Sets the #GdkScreen where the @window is displayed; if * the window is already mapped, it will be unmapped, and * then remapped on the new screen. + * + * Since: 2.2 */ void gtk_window_set_screen (GtkWindow *window, @@ -6077,6 +6091,8 @@ gtk_window_check_screen (GtkWindow *window) * Returns the #GdkScreen associated with @window. * * Return value: a #GdkScreen. + * + * Since: 2.2 */ GdkScreen* gtk_window_get_screen (GtkWindow *window) @@ -6801,6 +6817,7 @@ _gtk_window_set_has_toplevel_focus (GtkWindow *window, * temporarily, show your splash screen, then re-enable it so that * showing the main window would automatically result in notification. * + * Since: 2.2 **/ void gtk_window_set_auto_startup_notification (gboolean setting)