callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add annotations so that methods are properly paired to objects.

Browse Source 
Add type annotations to 1st argument of gdk_x11_* functions so that they are
properly recognized as methods of GdkX11 objects.

https://bugzilla.gnome.org/show_bug.cgi?id=655496
This commit is contained in:
Pavel Holejsovsky 2011-07-28 13:27:23 +02:00
parent 0893a3fd39
commit 21a5b038a7
7 changed files with 32 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
gdk/x11/gdkcursor-x11.c
View File

@ -286,7 +286,7 @@ _gdk_x11_display_get_cursor_for_type (GdkDisplay *display,
/** /**
* gdk_x11_cursor_get_xdisplay: * gdk_x11_cursor_get_xdisplay:
* @cursor: a #GdkCursor. * @cursor: (type GdkX11Cursor): a #GdkCursor.
* *
* Returns the display of a #GdkCursor. * Returns the display of a #GdkCursor.
* *
@ -302,7 +302,7 @@ gdk_x11_cursor_get_xdisplay (GdkCursor *cursor)
/** /**
* gdk_x11_cursor_get_xcursor: * gdk_x11_cursor_get_xcursor:
* @cursor: a #GdkCursor. * @cursor: (type GdkX11Cursor): a #GdkCursor.
* *
* Returns the X cursor belonging to a #GdkCursor. * Returns the X cursor belonging to a #GdkCursor.
* *
@ -435,7 +435,7 @@ update_cursor (gpointer data,
/** /**
* gdk_x11_display_set_cursor_theme: * gdk_x11_display_set_cursor_theme:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* @theme: the name of the cursor theme to use, or %NULL to unset * @theme: the name of the cursor theme to use, or %NULL to unset
* a previously set value * a previously set value
* @size: the cursor size to use, or 0 to keep the previous size * @size: the cursor size to use, or 0 to keep the previous size

20
gdk/x11/gdkdisplay-x11.c
View File

@ -1635,7 +1635,7 @@ gdk_x11_display_get_default_group (GdkDisplay *display)
/** /**
* gdk_x11_display_grab: * gdk_x11_display_grab:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* *
* Call XGrabServer() on @display. * Call XGrabServer() on @display.
* To ungrab the display again, use gdk_x11_display_ungrab(). * To ungrab the display again, use gdk_x11_display_ungrab().
@ -1660,7 +1660,7 @@ gdk_x11_display_grab (GdkDisplay *display)
/** /**
* gdk_x11_display_ungrab: * gdk_x11_display_ungrab:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* *
* Ungrab @display after it has been grabbed with * Ungrab @display after it has been grabbed with
* gdk_x11_display_grab(). * gdk_x11_display_grab().
@ -1844,7 +1844,7 @@ _gdk_x11_display_screen_for_xrootwin (GdkDisplay *display,
/** /**
* gdk_x11_display_get_xdisplay: * gdk_x11_display_get_xdisplay:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* @returns: (transfer none): an X display. * @returns: (transfer none): an X display.
* *
* Returns the X display of a #GdkDisplay. * Returns the X display of a #GdkDisplay.
@ -1975,7 +1975,7 @@ broadcast_xmessage (GdkDisplay *display,
/** /**
* gdk_x11_display_broadcast_startup_message: * gdk_x11_display_broadcast_startup_message:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* @message_type: startup notification message type ("new", "change", * @message_type: startup notification message type ("new", "change",
* or "remove") * or "remove")
* @...: a list of key/value pairs (as strings), terminated by a * @...: a list of key/value pairs (as strings), terminated by a
@ -2148,7 +2148,7 @@ gdk_x11_display_store_clipboard (GdkDisplay *display,
/** /**
* gdk_x11_display_get_user_time: * gdk_x11_display_get_user_time:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* *
* Returns the timestamp of the last user interaction on * Returns the timestamp of the last user interaction on
* @display. The timestamp is taken from events caused * @display. The timestamp is taken from events caused
@ -2180,7 +2180,7 @@ gdk_x11_display_supports_input_shapes (GdkDisplay *display)
/** /**
* gdk_x11_display_get_startup_notification_id: * gdk_x11_display_get_startup_notification_id:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* *
* Gets the startup notification ID for a display. * Gets the startup notification ID for a display.
* *
@ -2196,7 +2196,7 @@ gdk_x11_display_get_startup_notification_id (GdkDisplay *display)
/** /**
* gdk_x11_display_set_startup_notification_id: * gdk_x11_display_set_startup_notification_id:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* @startup_id: the startup notification ID (must be valid utf8) * @startup_id: the startup notification ID (must be valid utf8)
* *
* Sets the startup notification ID for a display. * Sets the startup notification ID for a display.
@ -2412,7 +2412,7 @@ delete_outdated_error_traps (GdkX11Display *display_x11)
/** /**
* gdk_x11_display_error_trap_push: * gdk_x11_display_error_trap_push:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* *
* Begins a range of X requests on @display for which X error events * Begins a range of X requests on @display for which X error events
* will be ignored. Unignored errors (when no trap is pushed) will abort * will be ignored. Unignored errors (when no trap is pushed) will abort
@ -2517,7 +2517,7 @@ gdk_x11_display_error_trap_pop_internal (GdkDisplay *display,
/** /**
* gdk_x11_display_error_trap_pop: * gdk_x11_display_error_trap_pop:
* @display: the display * @display: (type GdkX11Display): the display
* *
* Pops the error trap pushed by gdk_x11_display_error_trap_push(). * Pops the error trap pushed by gdk_x11_display_error_trap_push().
* Will XSync() if necessary and will always block until * Will XSync() if necessary and will always block until
@ -2544,7 +2544,7 @@ gdk_x11_display_error_trap_pop (GdkDisplay *display)
/** /**
* gdk_x11_display_error_trap_pop_ignored: * gdk_x11_display_error_trap_pop_ignored:
* @display: the display * @display: (type GdkX11Display): the display
* *
* Pops the error trap pushed by gdk_x11_display_error_trap_push(). * Pops the error trap pushed by gdk_x11_display_error_trap_push().
* Does not block to see if an error occurred; merely records the * Does not block to see if an error occurred; merely records the

10
gdk/x11/gdkscreen-x11.c
View File

@ -266,7 +266,7 @@ gdk_x11_screen_get_monitor_plug_name (GdkScreen *screen,
/** /**
* gdk_x11_screen_get_monitor_output: * gdk_x11_screen_get_monitor_output:
* @screen: a #GdkScreen * @screen: (type GdkX11Screen): a #GdkScreen
* @monitor_num: number of the monitor, between 0 and gdk_screen_get_n_monitors (screen) * @monitor_num: number of the monitor, between 0 and gdk_screen_get_n_monitors (screen)
* *
* Gets the XID of the specified output/monitor. * Gets the XID of the specified output/monitor.
@ -319,7 +319,7 @@ gdk_x11_screen_get_rgba_visual (GdkScreen *screen)
/** /**
* gdk_x11_screen_get_xscreen: * gdk_x11_screen_get_xscreen:
* @screen: a #GdkScreen. * @screen: (type GdkX11Screen): a #GdkScreen.
* @returns: (transfer none): an Xlib <type>Screen*</type> * @returns: (transfer none): an Xlib <type>Screen*</type>
* *
* Returns the screen of a #GdkScreen. * Returns the screen of a #GdkScreen.
@ -334,7 +334,7 @@ gdk_x11_screen_get_xscreen (GdkScreen *screen)
/** /**
* gdk_x11_screen_get_screen_number: * gdk_x11_screen_get_screen_number:
* @screen: a #GdkScreen. * @screen: (type GdkX11Screen): a #GdkScreen.
* @returns: the position of @screen among the screens of * @returns: the position of @screen among the screens of
* its display. * its display.
* *
@ -1275,7 +1275,7 @@ fetch_net_wm_check_window (GdkScreen *screen)
/** /**
* gdk_x11_screen_supports_net_wm_hint: * gdk_x11_screen_supports_net_wm_hint:
* @screen: the relevant #GdkScreen. * @screen: (type GdkX11Screen): the relevant #GdkScreen.
* @property: a property atom. * @property: a property atom.
* *
* This function is specific to the X11 backend of GDK, and indicates * This function is specific to the X11 backend of GDK, and indicates
@ -1510,7 +1510,7 @@ _gdk_x11_screen_init_events (GdkScreen *screen)
/** /**
* gdk_x11_screen_get_window_manager_name: * gdk_x11_screen_get_window_manager_name:
* @screen: a #GdkScreen * @screen: (type GdkX11Screen): a #GdkScreen
* *
* Returns the name of the window manager for @screen. * Returns the name of the window manager for @screen.
* *

6
gdk/x11/gdkselection-x11.c
View File

@ -333,7 +333,7 @@ _gdk_x11_display_send_selection_notify (GdkDisplay *display,
/** /**
* gdk_x11_display_text_property_to_text_list: * gdk_x11_display_text_property_to_text_list:
* @display: The #GdkDisplay where the encoding is defined * @display: (type GdkX11Display): The #GdkDisplay where the encoding is defined
* @encoding: an atom representing the encoding. The most * @encoding: an atom representing the encoding. The most
* common values for this are STRING, or COMPOUND_TEXT. * common values for this are STRING, or COMPOUND_TEXT.
* This is value used as the type for the property * This is value used as the type for the property
@ -574,7 +574,7 @@ _gdk_x11_display_text_property_to_utf8_list (GdkDisplay *display,
/** /**
* gdk_x11_display_string_to_compound_text: * gdk_x11_display_string_to_compound_text:
* @display: the #GdkDisplay where the encoding is defined * @display: (type GdkX11Display): the #GdkDisplay where the encoding is defined
* @str: a nul-terminated string * @str: a nul-terminated string
* @encoding: (out) (transfer none): location to store the encoding atom * @encoding: (out) (transfer none): location to store the encoding atom
* (to be used as the type for the property) * (to be used as the type for the property)
@ -695,7 +695,7 @@ _gdk_x11_display_utf8_to_string_target (GdkDisplay *display,
/** /**
* gdk_x11_display_utf8_to_compound_text: * gdk_x11_display_utf8_to_compound_text:
* @display: a #GdkDisplay * @display: (type GdkX11Display): a #GdkDisplay
* @str: a UTF-8 string * @str: a UTF-8 string
* @encoding: (out): location to store resulting encoding * @encoding: (out): location to store resulting encoding
* @format: (out): location to store format of the result * @format: (out): location to store format of the result

2
gdk/x11/gdkvisual-x11.c
View File

@ -457,7 +457,7 @@ _gdk_x11_screen_list_visuals (GdkScreen *screen)
/** /**
* gdk_x11_screen_lookup_visual: * gdk_x11_screen_lookup_visual:
* @screen: a #GdkScreen. * @screen: (type GdkX11Screen): a #GdkScreen.
* @xvisualid: an X Visual ID. * @xvisualid: an X Visual ID.
* *
* Looks up the #GdkVisual for a particular screen and X Visual ID. * Looks up the #GdkVisual for a particular screen and X Visual ID.

15
gdk/x11/gdkwindow-x11.c
View File

@ -1699,7 +1699,7 @@ gdk_window_x11_lower (GdkWindow *window)
/** /**
* gdk_x11_window_move_to_current_desktop: * gdk_x11_window_move_to_current_desktop:
* @window: a #GdkWindow * @window: (type GdkX11Window): a #GdkWindow
* *
* Moves the window to the correct workspace when running under a * Moves the window to the correct workspace when running under a
* window manager that supports multiple workspaces, as described * window manager that supports multiple workspaces, as described
@ -3023,7 +3023,7 @@ gdk_x11_window_set_focus_on_map (GdkWindow *window,
/** /**
* gdk_x11_window_set_user_time: * gdk_x11_window_set_user_time:
* @window: A toplevel #GdkWindow * @window: (type GdkX11Window): A toplevel #GdkWindow
* @timestamp: An XServer timestamp to which the property should be set * @timestamp: An XServer timestamp to which the property should be set
* *
* The application can use this call to update the _NET_WM_USER_TIME * The application can use this call to update the _NET_WM_USER_TIME
@ -3088,7 +3088,7 @@ gdk_x11_window_set_user_time (GdkWindow *window,
/** /**
* gdk_x11_window_set_theme_variant: * gdk_x11_window_set_theme_variant:
* @window: a #GdkWindow * @window: (type GdkX11Window): a #GdkWindow
* @variant: the theme variant to export * @variant: the theme variant to export
* *
* GTK+ applications can request a dark theme variant. In order to * GTK+ applications can request a dark theme variant. In order to
@ -4701,9 +4701,10 @@ timestamp_predicate (Display *display,
/** /**
* gdk_x11_get_server_time: * gdk_x11_get_server_time:
* @window: a #GdkWindow, used for communication with the server. * @window: (type GdkX11Window): a #GdkWindow, used for communication
* The window must have GDK_PROPERTY_CHANGE_MASK in its * with the server. The window must have
* events mask or a hang will result. * GDK_PROPERTY_CHANGE_MASK in its events mask or a hang will
* result.
* *
* Routine to get the current X server time stamp. * Routine to get the current X server time stamp.
* *
@ -4739,7 +4740,7 @@ gdk_x11_get_server_time (GdkWindow *window)
/** /**
* gdk_x11_window_get_xid: * gdk_x11_window_get_xid:
* @window: a native #GdkWindow. * @window: (type GdkX11Window): a native #GdkWindow.
* *
* Returns the X resource (window) belonging to a #GdkWindow. * Returns the X resource (window) belonging to a #GdkWindow.
* *

3
gdk/x11/gdkxid.c
View File

@ -81,7 +81,8 @@ _gdk_x11_display_remove_window (GdkDisplay *display,
/** /**
* gdk_x11_window_lookup_for_display: * gdk_x11_window_lookup_for_display:
* @display: the #GdkDisplay corresponding to the window handle * @display: (type GdkX11Window): the #GdkDisplay corresponding to the
* window handle
* @window: an XLib <type>Window</type> * @window: an XLib <type>Window</type>
* *
* Looks up the #GdkWindow that wraps the given native window handle. * Looks up the #GdkWindow that wraps the given native window handle.