summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog19
-rw-r--r--doc/libwnck-sections.txt4
-rw-r--r--doc/tmpl/tasklist.sgml18
-rw-r--r--doc/tmpl/util.sgml12
-rw-r--r--libwnck/application.c2
-rw-r--r--libwnck/class-group.c12
-rw-r--r--libwnck/pager.c3
-rw-r--r--libwnck/screen.c22
-rw-r--r--libwnck/screen.h4
-rw-r--r--libwnck/selector.c2
-rw-r--r--libwnck/tasklist.c4
-rw-r--r--libwnck/tasklist.h2
-rw-r--r--libwnck/util.c6
-rw-r--r--libwnck/util.h4
-rw-r--r--libwnck/window.c39
-rw-r--r--libwnck/window.h4
-rw-r--r--libwnck/workspace.c12
17 files changed, 152 insertions, 17 deletions
diff --git a/ChangeLog b/ChangeLog
index 4aa6013..d2c5688 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,24 @@
2007-06-18 Vincent Untz <vuntz@gnome.org>
+ * doc/libwnck-sections.txt:
+ * doc/tmpl/tasklist.sgml:
+ * doc/tmpl/util.sgml:
+ * libwnck/application.c:
+ * libwnck/class-group.c:
+ * libwnck/pager.c:
+ * libwnck/screen.c:
+ * libwnck/screen.h:
+ * libwnck/selector.c:
+ * libwnck/tasklist.c:
+ * libwnck/tasklist.h:
+ * libwnck/util.c:
+ * libwnck/util.h:
+ * libwnck/window.c:
+ * libwnck/window.h:
+ * libwnck/workspace.c: add lots of Since: tags.
+
+2007-06-18 Vincent Untz <vuntz@gnome.org>
+
* libwnck/tasklist.c: (wnck_task_update_visible_state),
(wnck_task_create_widgets): use gtk_widget_set_tooltip_text()
diff --git a/doc/libwnck-sections.txt b/doc/libwnck-sections.txt
index 56dda5b..50a716f 100644
--- a/doc/libwnck-sections.txt
+++ b/doc/libwnck-sections.txt
@@ -274,9 +274,9 @@ WnckSelectorClass
<FILE>tasklist</FILE>
<TITLE>WnckTasklist</TITLE>
WnckTasklist
-WnckTasklistGroupingType
wnck_tasklist_new
wnck_tasklist_set_screen
+WnckTasklistGroupingType
wnck_tasklist_set_grouping
wnck_tasklist_set_grouping_limit
wnck_tasklist_set_include_all_workspaces
@@ -313,8 +313,8 @@ wnck_create_window_action_menu
<SECTION>
<FILE>util</FILE>
<TITLE>Miscellaneous Functions</TITLE>
-WnckClientType
wnck_gtk_window_set_dock_type
+WnckClientType
wnck_set_client_type
WnckResourceUsage
wnck_xid_read_resource_usage
diff --git a/doc/tmpl/tasklist.sgml b/doc/tmpl/tasklist.sgml
index 333d83c..1b14960 100644
--- a/doc/tmpl/tasklist.sgml
+++ b/doc/tmpl/tasklist.sgml
@@ -38,15 +38,6 @@ WnckTasklist
</para>
-<!-- ##### ENUM WnckTasklistGroupingType ##### -->
-<para>
-
-</para>
-
-@WNCK_TASKLIST_NEVER_GROUP:
-@WNCK_TASKLIST_AUTO_GROUP:
-@WNCK_TASKLIST_ALWAYS_GROUP:
-
<!-- ##### FUNCTION wnck_tasklist_new ##### -->
<para>
@@ -65,6 +56,15 @@ WnckTasklist
@screen:
+<!-- ##### ENUM WnckTasklistGroupingType ##### -->
+<para>
+
+</para>
+
+@WNCK_TASKLIST_NEVER_GROUP:
+@WNCK_TASKLIST_AUTO_GROUP:
+@WNCK_TASKLIST_ALWAYS_GROUP:
+
<!-- ##### FUNCTION wnck_tasklist_set_grouping ##### -->
<para>
diff --git a/doc/tmpl/util.sgml b/doc/tmpl/util.sgml
index 47c01cc..75ef838 100644
--- a/doc/tmpl/util.sgml
+++ b/doc/tmpl/util.sgml
@@ -17,21 +17,21 @@ Miscellaneous Functions
<!-- ##### SECTION Stability_Level ##### -->
-<!-- ##### ENUM WnckClientType ##### -->
+<!-- ##### FUNCTION wnck_gtk_window_set_dock_type ##### -->
<para>
</para>
-@WNCK_CLIENT_TYPE_APPLICATION:
-@WNCK_CLIENT_TYPE_PAGER:
+@window:
-<!-- ##### FUNCTION wnck_gtk_window_set_dock_type ##### -->
+
+<!-- ##### ENUM WnckClientType ##### -->
<para>
</para>
-@window:
-
+@WNCK_CLIENT_TYPE_APPLICATION:
+@WNCK_CLIENT_TYPE_PAGER:
<!-- ##### FUNCTION wnck_set_client_type ##### -->
<para>
diff --git a/libwnck/application.c b/libwnck/application.c
index e2a27bf..91833d4 100644
--- a/libwnck/application.c
+++ b/libwnck/application.c
@@ -456,6 +456,8 @@ wnck_application_get_icon_is_fallback (WnckApplication *app)
*
* Return value: the startup sequence ID used for startup notification of @app,
* or %NULL if none is available.
+ *
+ * Since: 2.2
*/
const char*
wnck_application_get_startup_id (WnckApplication *app)
diff --git a/libwnck/class-group.c b/libwnck/class-group.c
index ee0f958..af73b0b 100644
--- a/libwnck/class-group.c
+++ b/libwnck/class-group.c
@@ -167,6 +167,8 @@ wnck_class_group_finalize (GObject *object)
* there is no #WnckClassGroup with the specified @res_class. The returned
* #WnckClassGroup is owned by libwnck and must not be referenced or
* unreferenced.
+ *
+ * Since: 2.2
**/
WnckClassGroup *
wnck_class_group_get (const char *res_class)
@@ -526,6 +528,8 @@ _wnck_class_group_remove_window (WnckClassGroup *class_group,
* Return value: the list of #WnckWindow grouped in @class_group, or %NULL if
* the group contains no window. The list should not be modified nor freed, as
* it is owned by @class_group.
+ *
+ * Since: 2.2
**/
GList *
wnck_class_group_get_windows (WnckClassGroup *class_group)
@@ -546,6 +550,8 @@ wnck_class_group_get_windows (WnckClassGroup *class_group)
*
* Return value: the resource class name of @class_group, or an
* empty string if the group has no resource class name.
+ *
+ * Since: 2.2
**/
const char *
wnck_class_group_get_res_class (WnckClassGroup *class_group)
@@ -571,6 +577,8 @@ wnck_class_group_get_res_class (WnckClassGroup *class_group)
* resource class name is used.
*
* Return value: an human-readable name for @class_group.
+ *
+ * Since: 2.2
**/
const char *
wnck_class_group_get_name (WnckClassGroup *class_group)
@@ -597,6 +605,8 @@ wnck_class_group_get_name (WnckClassGroup *class_group)
* Return value: the icon for @class_group. The caller should reference the
* returned <classname>GdkPixbuf</classname> if it needs to keep the icon
* around.
+ *
+ * Since: 2.2
**/
GdkPixbuf *
wnck_class_group_get_icon (WnckClassGroup *class_group)
@@ -621,6 +631,8 @@ wnck_class_group_get_icon (WnckClassGroup *class_group)
* Return value: the mini-icon for @class_group. The caller should reference
* the returned <classname>GdkPixbuf</classname> if it needs to keep the
* mini-icon around.
+ *
+ * Since: 2.2
**/
GdkPixbuf *
wnck_class_group_get_mini_icon (WnckClassGroup *class_group)
diff --git a/libwnck/pager.c b/libwnck/pager.c
index af16ef7..f0b378a 100644
--- a/libwnck/pager.c
+++ b/libwnck/pager.c
@@ -1687,6 +1687,7 @@ wnck_pager_focus (GtkWidget *widget,
*
* Does nothing.
*
+ * Since: 2.2
* Deprecated:
*/
void
@@ -1903,6 +1904,8 @@ wnck_pager_set_show_all (WnckPager *pager,
* Sets the shadow type for @pager to @shadow_type. The main use of this
* function is proper integration of #WnckPager in panels with non-system
* backgrounds.
+ *
+ * Since: 2.2
*/
void
wnck_pager_set_shadow_type (WnckPager * pager,
diff --git a/libwnck/screen.c b/libwnck/screen.c
index 8b22c37..f728a59 100644
--- a/libwnck/screen.c
+++ b/libwnck/screen.c
@@ -642,6 +642,8 @@ wnck_screen_get_for_root (gulong root_window_id)
* #WnckScreen has an index of 0.
*
* Return value: the index of @space on @screen, or -1 on errors.
+ *
+ * Since: 2.20
**/
int
wnck_screen_get_number (WnckScreen *screen)
@@ -690,7 +692,10 @@ wnck_screen_get_workspace (WnckScreen *screen,
* index of 0. See also wnck_workspace_get_number().
*
* Return value: the index of @space on @screen, or -1 on errors.
+ *
+ * Since: 2.14
**/
+/* TODO: when we break API again, kill this function */
int
wnck_screen_get_workspace_index (WnckScreen *screen,
WnckWorkspace *space)
@@ -747,6 +752,8 @@ wnck_screen_get_active_workspace (WnckScreen *screen)
* direction on @screen, or %NULL if no such neighbor #WnckWorkspace exists.
* The returned #WnckWorkspace is owned by libwnck and must not be referenced
* or unreferenced.
+ *
+ * Since: 2.14
**/
WnckWorkspace*
wnck_screen_get_workspace_neighbor (WnckScreen *screen,
@@ -826,6 +833,8 @@ wnck_screen_get_active_window (WnckScreen *screen)
* Return value: the previously active #WnckWindow on @screen, or %NULL. The
* returned #WnckWindow is owned by libwnck and must not be referenced or
* unreferenced.
+ *
+ * Since: 2.8
**/
WnckWindow*
wnck_screen_get_previously_active_window (WnckScreen *screen)
@@ -936,6 +945,8 @@ wnck_screen_get_workspace_count (WnckScreen *screen)
* @count: the number of #WnckWorkspace to request.
*
* Asks the window manager to change the number of #WnckWorkspace on @screen.
+ *
+ * Since: 2.2
**/
void
wnck_screen_change_workspace_count (WnckScreen *screen,
@@ -1049,6 +1060,7 @@ _wnck_screen_process_property_notify (WnckScreen *screen,
* Calculates the layout of #WnckWorkspace, with additional information like
* the row and column of the #WnckWorkspace with index @space_index.
*
+ * Since: 2.12
*/
/* TODO: when we break API again, make this function (and WnckWorkspaceLayout)
* private. Also remove num_workspaces since we can get it from screen! */
@@ -1265,6 +1277,8 @@ wnck_screen_calc_workspace_layout (WnckScreen *screen,
*
* Frees the content of @layout. This does not free @layout itself, so you
* might want to free @layout yourself after calling this.
+ *
+ * Since: 2.12
*/
/* TODO: when we break API again, make this function (and WnckWorkspaceLayout)
* private. */
@@ -2338,6 +2352,8 @@ emit_wm_changed (WnckScreen *screen)
* does not comply with the <ulink
* url="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html">EWMH</ulink>
* specification.
+ *
+ * Since: 2.20
*/
const char *
wnck_screen_get_window_manager_name (WnckScreen *screen)
@@ -2560,6 +2576,8 @@ wnck_screen_release_workspace_layout (WnckScreen *screen,
* changed when a #WnckScreen::showing-desktop-changed signal gets emitted.
*
* Return value: %TRUE if @window is fullscreen, %FALSE otherwise.
+ *
+ * Since: 2.2
**/
gboolean
wnck_screen_get_showing_desktop (WnckScreen *screen)
@@ -2576,6 +2594,8 @@ wnck_screen_get_showing_desktop (WnckScreen *screen)
*
* Asks the window manager to set the "showing the desktop" mode on @screen
* according to @show.
+ *
+ * Since: 2.2
**/
void
wnck_screen_toggle_showing_desktop (WnckScreen *screen,
@@ -2596,6 +2616,8 @@ wnck_screen_toggle_showing_desktop (WnckScreen *screen,
*
* Asks the window manager to move the viewport of the current #WnckWorkspace
* on @screen.
+ *
+ * Since: 2.4
*/
void
wnck_screen_move_viewport (WnckScreen *screen,
diff --git a/libwnck/screen.h b/libwnck/screen.h
index 55e1480..63fbf35 100644
--- a/libwnck/screen.h
+++ b/libwnck/screen.h
@@ -134,6 +134,8 @@ typedef struct _WnckWorkspaceLayout WnckWorkspaceLayout;
* The #WnckWorkspaceLayout struct contains information about the layout of
* #WnckWorkspace on a #WnckScreen, and the exact position of a specific
* #WnckWorkspace.
+ *
+ * Since: 2.12
*/
struct _WnckWorkspaceLayout
{
@@ -157,6 +159,8 @@ struct _WnckWorkspaceLayout
* #WnckWorkspace.
*
* Type defining a direction in which to search a neighbor #WnckWorkspace.
+ *
+ * Since: 2.14
*/
typedef enum
{
diff --git a/libwnck/selector.c b/libwnck/selector.c
index 06aa4c3..190f6c6 100644
--- a/libwnck/selector.c
+++ b/libwnck/selector.c
@@ -1347,6 +1347,8 @@ wnck_selector_unrealize (GtkWidget *widget)
* #WnckScreen it is on.
*
* Return value: a newly created #WnckSelector.
+ *
+ * Since: 2.10
*/
GtkWidget *
wnck_selector_new (void)
diff --git a/libwnck/tasklist.c b/libwnck/tasklist.c
index 1923772..83b13bd 100644
--- a/libwnck/tasklist.c
+++ b/libwnck/tasklist.c
@@ -764,6 +764,8 @@ wnck_tasklist_set_relief_callback (WnckWindow *win,
* Sets the relief type of the buttons in @tasklist to @relief. The main use of
* this function is proper integration of #WnckTasklist in panels with
* non-system backgrounds.
+ *
+ * Since: 2.12
*/
void
wnck_tasklist_set_button_relief (WnckTasklist *tasklist, GtkReliefStyle relief)
@@ -937,6 +939,7 @@ wnck_tasklist_get_minimum_height (WnckTasklist *tasklist)
*
* Sets a function to be used for loading icons.
*
+ * Since: 2.2
**/
void
wnck_tasklist_set_icon_loader (WnckTasklist *tasklist,
@@ -1746,6 +1749,7 @@ wnck_tasklist_disconnect_screen (WnckTasklist *tasklist)
*
* Does nothing.
*
+ * Since: 2.2
* Deprecated:
*/
void
diff --git a/libwnck/tasklist.h b/libwnck/tasklist.h
index 75e6e48..fbbf146 100644
--- a/libwnck/tasklist.h
+++ b/libwnck/tasklist.h
@@ -117,6 +117,8 @@ gint wnck_tasklist_get_minimum_height (WnckTasklist *tasklist);
* Returns: it should return a <classname>GdkPixbuf</classname> of @icon_name
* at size @size, or %NULL if no icon for @icon_name at size @size could be
* loaded.
+ *
+ * Since: 2.2
*/
typedef GdkPixbuf* (*WnckLoadIconFunction) (const char *icon_name,
int size,
diff --git a/libwnck/util.c b/libwnck/util.c
index a3b7a2a..8862736 100644
--- a/libwnck/util.c
+++ b/libwnck/util.c
@@ -118,6 +118,8 @@ _wnck_print_resource_usage (WnckResourceUsage *usage)
* fields of @usage are set to 0.
*
* To properly work, this function requires the XRes extension on the X server.
+ *
+ * Since: 2.6
*/
void
wnck_xid_read_resource_usage (GdkDisplay *gdisplay,
@@ -588,6 +590,8 @@ wnck_pid_read_resource_usage_no_cache (GdkDisplay *gdisplay,
* again after a few seconds should work.
*
* To properly work, this function requires the XRes extension on the X server.
+ *
+ * Since: 2.6
*/
void
wnck_pid_read_resource_usage (GdkDisplay *gdisplay,
@@ -618,6 +622,8 @@ static WnckClientType client_type = 0;
* Sets the role of the libwnck user. For applications providing some window
* management features, like pagers or tasklists, it is important to set the
* role to %WNCK_CLIENT_TYPE_PAGER for libwnck to properly work.
+ *
+ * Since: 2.14
*/
void
wnck_set_client_type (WnckClientType ewmh_sourceindication_client_type)
diff --git a/libwnck/util.h b/libwnck/util.h
index e49a6a2..6398ef4 100644
--- a/libwnck/util.h
+++ b/libwnck/util.h
@@ -48,6 +48,8 @@ typedef struct _WnckResourceUsage WnckResourceUsage;
* The #WnckResourceUsage struct contains information about the total resource
* usage of an X client, and the number of resources allocated for each
* resource type.
+ *
+ * Since: 2.6
*/
struct _WnckResourceUsage
{
@@ -85,6 +87,8 @@ struct _WnckResourceUsage
* with window management, like pagers and taskbars.
*
* Type describing the role of the libwnck user.
+ *
+ * Since: 2.14
*/
typedef enum {
WNCK_CLIENT_TYPE_APPLICATION = 1,
diff --git a/libwnck/window.c b/libwnck/window.c
index abcda1c..2224b78 100644
--- a/libwnck/window.c
+++ b/libwnck/window.c
@@ -495,6 +495,8 @@ _wnck_window_destroy (WnckWindow *window)
*
* Return value: %TRUE if wnck_window_get_name() returns @window<!-- -->'s
* name, %FALSE if it returns a fallback name.
+ *
+ * Since: 2.16
**/
gboolean
wnck_window_has_name (WnckWindow *window)
@@ -546,6 +548,8 @@ wnck_window_get_name (WnckWindow *window)
*
* Return value: %TRUE if wnck_window_get_icon_name() returns
* @window<!-- -->'s icon name, %FALSE if it returns a fallback name.
+ *
+ * Since: 2.16
**/
gboolean
wnck_window_has_icon_name (WnckWindow *window)
@@ -609,6 +613,8 @@ wnck_window_get_application (WnckWindow *window)
*
* Return value: the #WnckWindow for which @window is transient, or %NULL if
* @window is not transient for any #WnckWindow.
+ *
+ * Since: 2.12
**/
WnckWindow*
wnck_window_get_transient (WnckWindow *window)
@@ -661,6 +667,8 @@ wnck_window_get_xid (WnckWindow *window)
* Return value: the #WnckClassGroup to which @window belongs. The returned
* #WnckClassGroup is owned by libwnck and must not be referenced or
* unreferenced.
+ *
+ * Since: 2.2
**/
WnckClassGroup *
wnck_window_get_class_group (WnckWindow *window)
@@ -753,6 +761,8 @@ wnck_window_get_pid (WnckWindow *window)
* libwnck. The initial value is defined when the window is created.
*
* Return value: the sort order of @window, or G_MAXINT if none is available.
+ *
+ * Since: 2.10
**/
gint
wnck_window_get_sort_order (WnckWindow *window)
@@ -804,6 +814,8 @@ wnck_window_get_window_type (WnckWindow *window)
* @wintype: a semantic type.
*
* Sets the semantic type of @window to @wintype.
+ *
+ * Since: 2.12
**/
void
wnck_window_set_window_type (WnckWindow *window, WnckWindowType wintype)
@@ -879,6 +891,8 @@ wnck_window_is_minimized (WnckWindow *window)
* hints.
*
* Return value: %TRUE if @window needs attention, %FALSE otherwise.
+ *
+ * Since: 2.12
**/
gboolean
wnck_window_needs_attention (WnckWindow *window)
@@ -923,6 +937,8 @@ transient_needs_attention (WnckWindow *window)
*
* Return value: %TRUE if @window or one of its transients needs attention,
* %FALSE otherwise.
+ *
+ * Since: 2.12
**/
gboolean
wnck_window_or_transient_needs_attention (WnckWindow *window)
@@ -1055,6 +1071,8 @@ wnck_window_is_shaded (WnckWindow *window)
* See wnck_window_make_above() for more details on this state.
*
* Return value: %TRUE if @window is above other windows, %FALSE otherwise.
+ *
+ * Since: 2.14
**/
gboolean
wnck_window_is_above (WnckWindow *window)
@@ -1125,6 +1143,8 @@ wnck_window_is_skip_tasklist (WnckWindow *window)
* anytime a #WnckWindow::state-changed signal gets emitted.
*
* Return value: %TRUE if @window is fullscreen, %FALSE otherwise.
+ *
+ * Since: 2.8
**/
gboolean
wnck_window_is_fullscreen (WnckWindow *window)
@@ -1161,6 +1181,8 @@ wnck_window_set_skip_tasklist (WnckWindow *window,
*
* Asks the window manager to set the fullscreen state of @window according to
* @fullscreen.
+ *
+ * Since: 2.8
**/
void
wnck_window_set_fullscreen (WnckWindow *window,
@@ -1203,6 +1225,8 @@ wnck_window_is_sticky (WnckWindow *window)
* this call to occur.
*
* Closes @window.
+ *
+ * Since: 2.6 (@timestamp argument was missing in earlier versions)
**/
void
wnck_window_close (WnckWindow *window,
@@ -1397,6 +1421,8 @@ wnck_window_unshade (WnckWindow *window)
* Asks the window manager to put @window on top of most windows (@window will
* not be on top of focused fullscreen windows, of other windows with this
* setting and of dock windows).
+ *
+ * Since: 2.14
**/
void
wnck_window_make_above (WnckWindow *window)
@@ -1416,6 +1442,8 @@ wnck_window_make_above (WnckWindow *window)
*
* Asks the window manager to not put @window on top of most windows, and to
* put it again in the stack with other windows.
+ *
+ * Since: 2.14
**/
void
wnck_window_unmake_above (WnckWindow *window)
@@ -1611,6 +1639,8 @@ wnck_window_unpin (WnckWindow *window)
* window manager may choose to raise @window along with focusing it, and may
* decide to refuse the request (to not steal the focus if there is a more
* recent user activity, for example).
+ *
+ * Since: 2.10 (@timestamp argument was missing in earlier versions)
**/
void
wnck_window_activate (WnckWindow *window,
@@ -1654,6 +1684,8 @@ wnck_window_is_active (WnckWindow *window)
*
* Return value: %TRUE if @window was the most recently activated window on its
* #WnckScreen, %FALSE otherwise.
+ *
+ * Since: 2.8
**/
gboolean
wnck_window_is_most_recently_activated (WnckWindow *window)
@@ -1714,6 +1746,7 @@ find_last_transient_for (GList *windows,
* the most recently active window among @window and its transients.
* This is probably best implemented on the window manager side.
*
+ * Since: 2.10 (@timestamp argument was missing in earlier versions)
**/
void
wnck_window_activate_transient (WnckWindow *window,
@@ -1767,6 +1800,8 @@ wnck_window_activate_transient (WnckWindow *window,
*
* Return value: %TRUE if one of the transients of @window is the most recently
* activated window, %FALSE otherwise.
+ *
+ * Since: 2.12
**/
gboolean
wnck_window_transient_is_most_recently_activated (WnckWindow *window)
@@ -2021,6 +2056,8 @@ wnck_window_get_geometry (WnckWindow *window,
* using wnck_window_set_geometry() with the values returned by
* wnck_window_get_client_window_geometry() should reduce the size of @window
* and move it.
+ *
+ * Since: 2.16
**/
void
wnck_window_set_geometry (WnckWindow *window,
@@ -2138,6 +2175,8 @@ wnck_window_is_on_workspace (WnckWindow *window,
*
* Return value: %TRUE if @window appears in current viewport of @workspace,
* %FALSE otherwise.
+ *
+ * Since: 2.4
**/
gboolean
wnck_window_is_in_viewport (WnckWindow *window,
diff --git a/libwnck/window.h b/libwnck/window.h
index 15e826d..75f331d 100644
--- a/libwnck/window.h
+++ b/libwnck/window.h
@@ -179,6 +179,8 @@ typedef enum
*
* Flag used when changing the geometry of a #WnckWindow. This is the gravity
* point to use as a reference for the new position.
+ *
+ * Since: 2.16
*/
typedef enum
{
@@ -204,6 +206,8 @@ typedef enum
*
* Flag used as a bitmask when changing the geometry of a #WnckWindow. This
* indicates which part of the geometry should be changed.
+ *
+ * Since: 2.16
*/
typedef enum
{
diff --git a/libwnck/workspace.c b/libwnck/workspace.c
index 18e15de..1712f99 100644
--- a/libwnck/workspace.c
+++ b/libwnck/workspace.c
@@ -176,6 +176,7 @@ wnck_workspace_get_name (WnckWorkspace *space)
*
* Changes the name of @space.
*
+ * Since: 2.2
**/
void
wnck_workspace_change_name (WnckWorkspace *space,
@@ -199,6 +200,7 @@ wnck_workspace_change_name (WnckWorkspace *space,
* manager may decide to refuse the request (to not steal the focus if there is
* a more recent user activity, for example).
*
+ * Since: 2.10 (@timestamp argument was missing in earlier versions)
**/
void
wnck_workspace_activate (WnckWorkspace *space,
@@ -307,6 +309,8 @@ _wnck_workspace_set_viewport (WnckWorkspace *space,
* Returns the width of @space.
*
* Returns: the width of @space.
+ *
+ * Since: 2.4
*/
int
wnck_workspace_get_width (WnckWorkspace *space)
@@ -323,6 +327,8 @@ wnck_workspace_get_width (WnckWorkspace *space)
* Returns the height of @space.
*
* Returns: the height of @space.
+ *
+ * Since: 2.4
*/
int
wnck_workspace_get_height (WnckWorkspace *space)
@@ -340,6 +346,8 @@ wnck_workspace_get_height (WnckWorkspace *space)
*
* Returns: the X coordinate of the viewport in @space, or 0 if @space does not
* contain a viewport.
+ *
+ * Since: 2.4
*/
int
wnck_workspace_get_viewport_x (WnckWorkspace *space)
@@ -357,6 +365,8 @@ wnck_workspace_get_viewport_x (WnckWorkspace *space)
*
* Returns: the Y coordinate of the viewport in @space, or 0 if @space does not
* contain a viewport.
+ *
+ * Since: 2.4
*/
int
wnck_workspace_get_viewport_y (WnckWorkspace *space)
@@ -373,6 +383,8 @@ wnck_workspace_get_viewport_y (WnckWorkspace *space)
* Returns whether @space contains a viewport.
*
* Returns: %TRUE if @space contains a viewport, %FALSE otherwise.
+ *
+ * Since: 2.4
*/
gboolean
wnck_workspace_is_virtual (WnckWorkspace *space)