Commit 54ec42f0 authored by Evan Nemerson's avatar Evan Nemerson

gtk: port many nullability annotation fixes from Vala bindings

https://bugzilla.gnome.org/show_bug.cgi?id=730745
parent 4d1930cf
...@@ -1154,7 +1154,7 @@ shared_data_unref (gpointer data) ...@@ -1154,7 +1154,7 @@ shared_data_unref (gpointer data)
* @entries: (array length=n_entries): an array of action descriptions * @entries: (array length=n_entries): an array of action descriptions
* @n_entries: the number of entries * @n_entries: the number of entries
* @user_data: data to pass to the action callbacks * @user_data: data to pass to the action callbacks
* @destroy: destroy notification callback for @user_data * @destroy: (nullable): destroy notification callback for @user_data
* *
* This variant of gtk_action_group_add_actions() adds a #GDestroyNotify * This variant of gtk_action_group_add_actions() adds a #GDestroyNotify
* callback for @user_data. * callback for @user_data.
...@@ -1265,7 +1265,7 @@ gtk_action_group_add_toggle_actions (GtkActionGroup *action_group, ...@@ -1265,7 +1265,7 @@ gtk_action_group_add_toggle_actions (GtkActionGroup *action_group,
* @entries: (array length=n_entries): an array of toggle action descriptions * @entries: (array length=n_entries): an array of toggle action descriptions
* @n_entries: the number of entries * @n_entries: the number of entries
* @user_data: data to pass to the action callbacks * @user_data: data to pass to the action callbacks
* @destroy: destroy notification callback for @user_data * @destroy: (nullable): destroy notification callback for @user_data
* *
* This variant of gtk_action_group_add_toggle_actions() adds a * This variant of gtk_action_group_add_toggle_actions() adds a
* #GDestroyNotify callback for @user_data. * #GDestroyNotify callback for @user_data.
......
...@@ -68,7 +68,8 @@ gtk_hscale_init (GtkHScale *hscale) ...@@ -68,7 +68,8 @@ gtk_hscale_init (GtkHScale *hscale)
/** /**
* gtk_hscale_new: * gtk_hscale_new:
* @adjustment: the #GtkAdjustment which sets the range of the scale. * @adjustment: (nullable): the #GtkAdjustment which sets the range of
* the scale.
* *
* Creates a new #GtkHScale. * Creates a new #GtkHScale.
* *
......
...@@ -1409,11 +1409,12 @@ gtk_rc_get_style (GtkWidget *widget) ...@@ -1409,11 +1409,12 @@ gtk_rc_get_style (GtkWidget *widget)
* G_OBJECT_TYPE (widget)); * G_OBJECT_TYPE (widget));
* ]| * ]|
* *
* Returns: (transfer none): A style created by matching with the * Returns: (nullable) (transfer none): A style created by matching
* supplied paths, or %NULL if nothing matching was specified and the * with the supplied paths, or %NULL if nothing matching was
* default style should be used. The returned value is owned by GTK+ * specified and the default style should be used. The returned
* as part of an internal cache, so you must call g_object_ref() on * value is owned by GTK+ as part of an internal cache, so you
* the returned value if you want to keep a reference to it. * must call g_object_ref() on the returned value if you want to
* keep a reference to it.
* *
* Deprecated:3.0: Use #GtkStyleContext instead * Deprecated:3.0: Use #GtkStyleContext instead
**/ **/
......
...@@ -4498,12 +4498,12 @@ gtk_widget_modify_base (GtkWidget *widget, ...@@ -4498,12 +4498,12 @@ gtk_widget_modify_base (GtkWidget *widget,
/** /**
* gtk_widget_modify_cursor: * gtk_widget_modify_cursor:
* @widget: a #GtkWidget * @widget: a #GtkWidget
* @primary: the color to use for primary cursor (does not need to be * @primary: (nullable): the color to use for primary cursor (does not
* allocated), or %NULL to undo the effect of previous calls to * need to be allocated), or %NULL to undo the effect of previous
* of gtk_widget_modify_cursor(). * calls to of gtk_widget_modify_cursor().
* @secondary: the color to use for secondary cursor (does not need to be * @secondary: (nullable): the color to use for secondary cursor (does
* allocated), or %NULL to undo the effect of previous calls to * not need to be allocated), or %NULL to undo the effect of
* of gtk_widget_modify_cursor(). * previous calls to of gtk_widget_modify_cursor().
* *
* Sets the cursor color to use in a widget, overriding the #GtkWidget * Sets the cursor color to use in a widget, overriding the #GtkWidget
* cursor-color and secondary-cursor-color * cursor-color and secondary-cursor-color
......
...@@ -1643,7 +1643,7 @@ gtk_builder_connect_signals (GtkBuilder *builder, ...@@ -1643,7 +1643,7 @@ gtk_builder_connect_signals (GtkBuilder *builder,
* @object: object to connect a signal to * @object: object to connect a signal to
* @signal_name: name of the signal * @signal_name: name of the signal
* @handler_name: name of the handler * @handler_name: name of the handler
* @connect_object: a #GObject, if non-%NULL, use g_signal_connect_object() * @connect_object: (nullable): a #GObject, if non-%NULL, use g_signal_connect_object()
* @flags: #GConnectFlags to use * @flags: #GConnectFlags to use
* @user_data: user data * @user_data: user data
* *
......
...@@ -1385,7 +1385,7 @@ clipboard_received_func (GtkClipboard *clipboard, ...@@ -1385,7 +1385,7 @@ clipboard_received_func (GtkClipboard *clipboard,
* This function waits for the data to be received using the main * This function waits for the data to be received using the main
* loop, so events, timeouts, etc, may be dispatched during the wait. * loop, so events, timeouts, etc, may be dispatched during the wait.
* *
* Returns: a newly-allocated #GtkSelectionData object or %NULL * Returns: (nullable): a newly-allocated #GtkSelectionData object or %NULL
* if retrieving the given target failed. If non-%NULL, * if retrieving the given target failed. If non-%NULL,
* this value must be freed with gtk_selection_data_free() * this value must be freed with gtk_selection_data_free()
* when you are finished with it. * when you are finished with it.
...@@ -1438,7 +1438,7 @@ clipboard_text_received_func (GtkClipboard *clipboard, ...@@ -1438,7 +1438,7 @@ clipboard_text_received_func (GtkClipboard *clipboard,
* the data to be received using the main loop, so events, * the data to be received using the main loop, so events,
* timeouts, etc, may be dispatched during the wait. * timeouts, etc, may be dispatched during the wait.
* *
* Returns: a newly-allocated UTF-8 string which must * Returns: (nullable): a newly-allocated UTF-8 string which must
* be freed with g_free(), or %NULL if retrieving * be freed with g_free(), or %NULL if retrieving
* the selection data failed. (This could happen * the selection data failed. (This could happen
* for various reasons, in particular if the * for various reasons, in particular if the
...@@ -1497,7 +1497,7 @@ clipboard_rich_text_received_func (GtkClipboard *clipboard, ...@@ -1497,7 +1497,7 @@ clipboard_rich_text_received_func (GtkClipboard *clipboard,
* waits for the data to be received using the main loop, so events, * waits for the data to be received using the main loop, so events,
* timeouts, etc, may be dispatched during the wait. * timeouts, etc, may be dispatched during the wait.
* *
* Returns: (array length=length) (transfer full): a * Returns: (nullable) (array length=length) (transfer full): a
* newly-allocated binary block of data which must be * newly-allocated binary block of data which must be
* freed with g_free(), or %NULL if retrieving the * freed with g_free(), or %NULL if retrieving the
* selection data failed. (This could happen for various * selection data failed. (This could happen for various
...@@ -1564,7 +1564,7 @@ clipboard_image_received_func (GtkClipboard *clipboard, ...@@ -1564,7 +1564,7 @@ clipboard_image_received_func (GtkClipboard *clipboard,
* the data to be received using the main loop, so events, * the data to be received using the main loop, so events,
* timeouts, etc, may be dispatched during the wait. * timeouts, etc, may be dispatched during the wait.
* *
* Returns: (transfer full): a newly-allocated #GdkPixbuf * Returns: (nullable) (transfer full): a newly-allocated #GdkPixbuf
* object which must be disposed with g_object_unref(), or * object which must be disposed with g_object_unref(), or
* %NULL if retrieving the selection data failed. (This could * %NULL if retrieving the selection data failed. (This could
* happen for various reasons, in particular if the clipboard * happen for various reasons, in particular if the clipboard
...@@ -1618,13 +1618,12 @@ clipboard_uris_received_func (GtkClipboard *clipboard, ...@@ -1618,13 +1618,12 @@ clipboard_uris_received_func (GtkClipboard *clipboard,
* for the data to be received using the main loop, so events, * for the data to be received using the main loop, so events,
* timeouts, etc, may be dispatched during the wait. * timeouts, etc, may be dispatched during the wait.
* *
* Returns: (array zero-terminated=1) (element-type utf8) (transfer full): a newly-allocated * Returns: (nullable) (array zero-terminated=1) (element-type utf8) (transfer full):
* %NULL-terminated array of strings which must * a newly-allocated %NULL-terminated array of strings which must
* be freed with g_strfreev(), or %NULL if * be freed with g_strfreev(), or %NULL if retrieving the
* retrieving the selection data failed. (This * selection data failed. (This could happen for various reasons,
* could happen for various reasons, in particular * in particular if the clipboard was empty or if the contents of
* if the clipboard was empty or if the contents of * the clipboard could not be converted into URI form.)
* the clipboard could not be converted into URI form.)
* *
* Since: 2.14 * Since: 2.14
**/ **/
......
...@@ -51,9 +51,10 @@ typedef void (* GtkClipboardReceivedFunc) (GtkClipboard *clipboard, ...@@ -51,9 +51,10 @@ typedef void (* GtkClipboardReceivedFunc) (GtkClipboard *clipboard,
/** /**
* GtkClipboardTextReceivedFunc: * GtkClipboardTextReceivedFunc:
* @clipboard: the #GtkClipboard * @clipboard: the #GtkClipboard
* @text: the text received, as a UTF-8 encoded string, or %NULL * @text: (nullable): the text received, as a UTF-8 encoded string, or
* if retrieving the data failed. * %NULL if retrieving the data failed.
* @data: the @user_data supplied to gtk_clipboard_request_text(). * @data: (closure): the @user_data supplied to
* gtk_clipboard_request_text().
* *
* A function to be called when the results of gtk_clipboard_request_text() * A function to be called when the results of gtk_clipboard_request_text()
* are received, or when the request fails. * are received, or when the request fails.
...@@ -120,8 +121,8 @@ typedef void (* GtkClipboardURIReceivedFunc) (GtkClipboard *clipboard, ...@@ -120,8 +121,8 @@ typedef void (* GtkClipboardURIReceivedFunc) (GtkClipboard *clipboard,
/** /**
* GtkClipboardTargetsReceivedFunc: * GtkClipboardTargetsReceivedFunc:
* @clipboard: the #GtkClipboard * @clipboard: the #GtkClipboard
* @atoms: the supported targets, as array of #GdkAtom, or %NULL * @atoms: (nullable) (array length=n_atoms): the supported targets,
* if retrieving the data failed. * as array of #GdkAtom, or %NULL if retrieving the data failed.
* @n_atoms: the length of the @atoms array. * @n_atoms: the length of the @atoms array.
* @data: (closure): the @user_data supplied to * @data: (closure): the @user_data supplied to
* gtk_clipboard_request_targets(). * gtk_clipboard_request_targets().
......
...@@ -5807,7 +5807,7 @@ gtk_combo_box_get_id_column (GtkComboBox *combo_box) ...@@ -5807,7 +5807,7 @@ gtk_combo_box_get_id_column (GtkComboBox *combo_box)
* no row is active, or if the active row has a %NULL ID value, then %NULL * no row is active, or if the active row has a %NULL ID value, then %NULL
* is returned. * is returned.
* *
* Returns: the ID of the active row, or %NULL * Returns: (nullable): the ID of the active row, or %NULL
* *
* Since: 3.0 * Since: 3.0
**/ **/
......
...@@ -1311,8 +1311,9 @@ gtk_container_class_install_child_property (GtkContainerClass *cclass, ...@@ -1311,8 +1311,9 @@ gtk_container_class_install_child_property (GtkContainerClass *cclass,
* *
* Finds a child property of a container class by name. * Finds a child property of a container class by name.
* *
* Returns: (transfer none): the #GParamSpec of the child property * Returns: (nullable) (transfer none): the #GParamSpec of the child
* or %NULL if @class has no child property with that name. * property or %NULL if @class has no child property with that
* name.
*/ */
GParamSpec* GParamSpec*
gtk_container_class_find_child_property (GObjectClass *cclass, gtk_container_class_find_child_property (GObjectClass *cclass,
......
...@@ -177,7 +177,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS ...@@ -177,7 +177,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS
/** /**
* gtk_theming_engine_register_property: (skip) * gtk_theming_engine_register_property: (skip)
* @name_space: namespace for the property name * @name_space: namespace for the property name
* @parse_func: parsing function to use, or %NULL * @parse_func: (nullable): parsing function to use, or %NULL
* @pspec: the #GParamSpec for the new property * @pspec: the #GParamSpec for the new property
* *
* Registers a property so it can be used in the CSS file format, * Registers a property so it can be used in the CSS file format,
......
...@@ -174,7 +174,7 @@ gtk_css_section_get_section_type (const GtkCssSection *section) ...@@ -174,7 +174,7 @@ gtk_css_section_get_section_type (const GtkCssSection *section)
* #GTK_CSS_SECTION_IMPORT if it was loaded with an import rule from * #GTK_CSS_SECTION_IMPORT if it was loaded with an import rule from
* a different file. * a different file.
* *
* Returns: the parent section or %NULL if none * Returns: (nullable) (transfer none): the parent section or %NULL if none
* *
* Since: 3.2 * Since: 3.2
**/ **/
......
...@@ -8131,7 +8131,8 @@ gtk_entry_set_inner_border (GtkEntry *entry, ...@@ -8131,7 +8131,8 @@ gtk_entry_set_inner_border (GtkEntry *entry,
* This function returns the entry’s #GtkEntry:inner-border property. See * This function returns the entry’s #GtkEntry:inner-border property. See
* gtk_entry_set_inner_border() for more information. * gtk_entry_set_inner_border() for more information.
* *
* Returns: (transfer none): the entry’s #GtkBorder, or %NULL if none was set. * Returns: (nullable) (transfer none): the entry’s #GtkBorder, or
* %NULL if none was set.
* *
* Since: 2.10 * Since: 2.10
* *
...@@ -9153,8 +9154,8 @@ ensure_has_tooltip (GtkEntry *entry) ...@@ -9153,8 +9154,8 @@ ensure_has_tooltip (GtkEntry *entry)
* Gets the contents of the tooltip on the icon at the specified * Gets the contents of the tooltip on the icon at the specified
* position in @entry. * position in @entry.
* *
* Returns: the tooltip text, or %NULL. Free the returned string * Returns: (nullable): the tooltip text, or %NULL. Free the returned
* with g_free() when done. * string with g_free() when done.
* *
* Since: 2.16 * Since: 2.16
*/ */
...@@ -9240,8 +9241,8 @@ gtk_entry_set_icon_tooltip_text (GtkEntry *entry, ...@@ -9240,8 +9241,8 @@ gtk_entry_set_icon_tooltip_text (GtkEntry *entry,
* Gets the contents of the tooltip on the icon at the specified * Gets the contents of the tooltip on the icon at the specified
* position in @entry. * position in @entry.
* *
* Returns: the tooltip text, or %NULL. Free the returned string * Returns: (nullable): the tooltip text, or %NULL. Free the returned
* with g_free() when done. * string with g_free() when done.
* *
* Since: 2.16 * Since: 2.16
*/ */
...@@ -10849,7 +10850,7 @@ gtk_entry_set_tabs (GtkEntry *entry, ...@@ -10849,7 +10850,7 @@ gtk_entry_set_tabs (GtkEntry *entry,
* Gets the tabstops that were set on the entry using gtk_entry_set_tabs(), if * Gets the tabstops that were set on the entry using gtk_entry_set_tabs(), if
* any. * any.
* *
* Returns: (transfer none): the tabstops, or %NULL if none was set. * Returns: (nullable) (transfer none): the tabstops, or %NULL if none was set.
* *
* Since: 3.10 * Since: 3.10
*/ */
......
...@@ -2046,9 +2046,9 @@ gtk_file_chooser_remove_shortcut_folder (GtkFileChooser *chooser, ...@@ -2046,9 +2046,9 @@ gtk_file_chooser_remove_shortcut_folder (GtkFileChooser *chooser,
* Queries the list of shortcut folders in the file chooser, as set by * Queries the list of shortcut folders in the file chooser, as set by
* gtk_file_chooser_add_shortcut_folder(). * gtk_file_chooser_add_shortcut_folder().
* *
* Returns: (element-type filename) (transfer full): A list of * Returns: (nullable) (element-type filename) (transfer full): A list
* folder filenames, or %NULL if there are no shortcut folders. Free * of folder filenames, or %NULL if there are no shortcut folders.
* the returned list with g_slist_free(), and the filenames with * Free the returned list with g_slist_free(), and the filenames with
* g_free(). * g_free().
* *
* Since: 2.4 * Since: 2.4
...@@ -2144,9 +2144,9 @@ gtk_file_chooser_remove_shortcut_folder_uri (GtkFileChooser *chooser, ...@@ -2144,9 +2144,9 @@ gtk_file_chooser_remove_shortcut_folder_uri (GtkFileChooser *chooser,
* Queries the list of shortcut folders in the file chooser, as set by * Queries the list of shortcut folders in the file chooser, as set by
* gtk_file_chooser_add_shortcut_folder_uri(). * gtk_file_chooser_add_shortcut_folder_uri().
* *
* Returns: (element-type utf8) (transfer full): A list of folder * Returns: (nullable) (element-type utf8) (transfer full): A list of
* URIs, or %NULL if there are no shortcut folders. Free the returned * folder URIs, or %NULL if there are no shortcut folders. Free the
* list with g_slist_free(), and the URIs with g_free(). * returned list with g_slist_free(), and the URIs with g_free().
* *
* Since: 2.4 * Since: 2.4
**/ **/
......
...@@ -448,7 +448,7 @@ gtk_frame_get_label (GtkFrame *frame) ...@@ -448,7 +448,7 @@ gtk_frame_get_label (GtkFrame *frame)
/** /**
* gtk_frame_set_label_widget: * gtk_frame_set_label_widget:
* @frame: a #GtkFrame * @frame: a #GtkFrame
* @label_widget: the new label widget * @label_widget: (nullable): the new label widget
* *
* Sets the label widget for the frame. This is the widget that * Sets the label widget for the frame. This is the widget that
* will appear embedded in the top edge of the frame as a * will appear embedded in the top edge of the frame as a
...@@ -501,7 +501,8 @@ gtk_frame_set_label_widget (GtkFrame *frame, ...@@ -501,7 +501,8 @@ gtk_frame_set_label_widget (GtkFrame *frame,
* Retrieves the label widget for the frame. See * Retrieves the label widget for the frame. See
* gtk_frame_set_label_widget(). * gtk_frame_set_label_widget().
* *
* Returns: (transfer none): the label widget, or %NULL if there is none. * Returns: (nullable) (transfer none): the label widget, or %NULL if
* there is none.
**/ **/
GtkWidget * GtkWidget *
gtk_frame_get_label_widget (GtkFrame *frame) gtk_frame_get_label_widget (GtkFrame *frame)
......
...@@ -1957,8 +1957,9 @@ choose_icon (GtkIconTheme *icon_theme, ...@@ -1957,8 +1957,9 @@ choose_icon (GtkIconTheme *icon_theme,
* gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() * gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon()
* combines these two steps if all you need is the pixbuf.) * combines these two steps if all you need is the pixbuf.)
* *
* Returns: (transfer full): a #GtkIconInfo object containing information * Returns: (nullable) (transfer full): a #GtkIconInfo object
* about the icon, or %NULL if the icon wasn’t found. * containing information about the icon, or %NULL if the icon wasn’t
* found.
* *
* Since: 2.4 * Since: 2.4
*/ */
...@@ -1994,8 +1995,9 @@ gtk_icon_theme_lookup_icon (GtkIconTheme *icon_theme, ...@@ -1994,8 +1995,9 @@ gtk_icon_theme_lookup_icon (GtkIconTheme *icon_theme,
* gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() combines * gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() combines
* these two steps if all you need is the pixbuf.) * these two steps if all you need is the pixbuf.)
* *
* Returns: (transfer full): a #GtkIconInfo object containing * Returns: (nullable) (transfer full): a #GtkIconInfo object
* information about the icon, or %NULL if the icon wasn’t found. * containing information about the icon, or %NULL if the icon wasn’t
* found.
* *
* Since: 3.10 * Since: 3.10
*/ */
...@@ -2098,8 +2100,9 @@ gtk_icon_theme_lookup_icon_for_scale (GtkIconTheme *icon_theme, ...@@ -2098,8 +2100,9 @@ gtk_icon_theme_lookup_icon_for_scale (GtkIconTheme *icon_theme,
* tries them all in the given order before falling back to * tries them all in the given order before falling back to
* inherited icon themes. * inherited icon themes.
* *
* Returns: (transfer full): a #GtkIconInfo object containing information * Returns: (nullable) (transfer full): a #GtkIconInfo object
* about the icon, or %NULL if the icon wasn’t found. * containing information about the icon, or %NULL if the icon wasn’t
* found.
* *
* Since: 2.12 * Since: 2.12
*/ */
...@@ -2136,8 +2139,9 @@ gtk_icon_theme_choose_icon (GtkIconTheme *icon_theme, ...@@ -2136,8 +2139,9 @@ gtk_icon_theme_choose_icon (GtkIconTheme *icon_theme,
* tries them all in the given order before falling back to * tries them all in the given order before falling back to
* inherited icon themes. * inherited icon themes.
* *
* Returns: (transfer full): a #GtkIconInfo object containing information * Returns: (nullable) (transfer full): a #GtkIconInfo object
* about the icon, or %NULL if the icon wasn’t found. * containing information about the icon, or %NULL if the icon wasn’t
* found.
* *
* Since: 3.10 * Since: 3.10
*/ */
...@@ -2188,8 +2192,8 @@ gtk_icon_theme_error_quark (void) ...@@ -2188,8 +2192,8 @@ gtk_icon_theme_error_quark (void)
* returned by this function. Otherwise GTK+ may need to keep the old * returned by this function. Otherwise GTK+ may need to keep the old
* icon theme loaded, which would be a waste of memory. * icon theme loaded, which would be a waste of memory.
* *
* Returns: (transfer full): the rendered icon; this may be a * Returns: (nullable) (transfer full): the rendered icon; this may be
* newly created icon or a new reference to an internal icon, so * a newly created icon or a new reference to an internal icon, so
* you must not modify the icon. Use g_object_unref() to release * you must not modify the icon. Use g_object_unref() to release
* your reference to the icon. %NULL if the icon isn’t found. * your reference to the icon. %NULL if the icon isn’t found.
* *
...@@ -2237,8 +2241,8 @@ gtk_icon_theme_load_icon (GtkIconTheme *icon_theme, ...@@ -2237,8 +2241,8 @@ gtk_icon_theme_load_icon (GtkIconTheme *icon_theme,
* returned by this function. Otherwise GTK+ may need to keep the old * returned by this function. Otherwise GTK+ may need to keep the old
* icon theme loaded, which would be a waste of memory. * icon theme loaded, which would be a waste of memory.
* *
* Returns: (transfer full): the rendered icon; this may be a * Returns: (nullable) (transfer full): the rendered icon; this may be
* newly created icon or a new reference to an internal icon, so * a newly created icon or a new reference to an internal icon, so
* you must not modify the icon. Use g_object_unref() to release * you must not modify the icon. Use g_object_unref() to release
* your reference to the icon. %NULL if the icon isn’t found. * your reference to the icon. %NULL if the icon isn’t found.
* *
...@@ -2299,10 +2303,11 @@ gtk_icon_theme_load_icon_for_scale (GtkIconTheme *icon_theme, ...@@ -2299,10 +2303,11 @@ gtk_icon_theme_load_icon_for_scale (GtkIconTheme *icon_theme,
* update the icon. This is usually done by connecting to the * update the icon. This is usually done by connecting to the
* GtkWidget::style-set signal. * GtkWidget::style-set signal.
* *
* Returns: (transfer full): the rendered icon; this may be a * Returns: (nullable) (transfer full): the rendered icon; this may be
* newly created icon or a new reference to an internal icon, so * a newly created icon or a new reference to an internal icon, so
* you must not modify the icon. Use cairo_surface_destroy() to release * you must not modify the icon. Use cairo_surface_destroy() to
* your reference to the icon. %NULL if the icon isn’t found. * release your reference to the icon. %NULL if the icon isn’t
* found.
* *
* Since: 3.10 * Since: 3.10
**/ **/
...@@ -2638,7 +2643,7 @@ gtk_icon_theme_list_contexts (GtkIconTheme *icon_theme) ...@@ -2638,7 +2643,7 @@ gtk_icon_theme_list_contexts (GtkIconTheme *icon_theme)
* current theme (for instance, to use when presenting * current theme (for instance, to use when presenting
* a list of themes to the user.) * a list of themes to the user.)
* *
* Returns: the name of an example icon or %NULL. * Returns: (nullable): the name of an example icon or %NULL.
* Free with g_free(). * Free with g_free().
* *
* Since: 2.4 * Since: 2.4
...@@ -5360,9 +5365,9 @@ find_builtin_icon (const gchar *icon_name, ...@@ -5360,9 +5365,9 @@ find_builtin_icon (const gchar *icon_name,
* The icon can then be rendered into a pixbuf using * The icon can then be rendered into a pixbuf using
* gtk_icon_info_load_icon(). * gtk_icon_info_load_icon().
* *
* Returns: (transfer full): a #GtkIconInfo containing * Returns: (nullable) (transfer full): a #GtkIconInfo containing
* information about the icon, or %NULL if the icon * information about the icon, or %NULL if the icon wasn’t
* wasn’t found. Unref with g_object_unref() * found. Unref with g_object_unref()
* *
* Since: 2.14 * Since: 2.14
*/ */
...@@ -5390,9 +5395,9 @@ gtk_icon_theme_lookup_by_gicon (GtkIconTheme *icon_theme, ...@@ -5390,9 +5395,9 @@ gtk_icon_theme_lookup_by_gicon (GtkIconTheme *icon_theme,
* The icon can then be rendered into a pixbuf using * The icon can then be rendered into a pixbuf using
* gtk_icon_info_load_icon(). * gtk_icon_info_load_icon().
* *
* Returns: (transfer full): a #GtkIconInfo containing * Returns: (nullable) (transfer full): a #GtkIconInfo containing
* information about the icon, or %NULL if the icon * information about the icon, or %NULL if the icon wasn’t
* wasn’t found. Unref with g_object_unref() * found. Unref with g_object_unref()
* *
* Since: 3.10 * Since: 3.10
*/ */
......
...@@ -390,7 +390,7 @@ gtk_list_box_class_init (GtkListBoxClass *klass) ...@@ -390,7 +390,7 @@ gtk_list_box_class_init (GtkListBoxClass *klass)
/** /**
* GtkListBox::row-selected: * GtkListBox::row-selected:
* @box: the #GtkListBox * @box: the #GtkListBox
* @row: the selected row * @row: (nullable): the selected row
* *
* The ::row-selected signal is emitted when a new row is selected, or * The ::row-selected signal is emitted when a new row is selected, or
* (with a %NULL @row) when the selection is cleared. * (with a %NULL @row) when the selection is cleared.
......
...@@ -1311,7 +1311,7 @@ gtk_menu_item_set_use_action_appearance (GtkMenuItem *menu_item, ...@@ -1311,7 +1311,7 @@ gtk_menu_item_set_use_action_appearance (GtkMenuItem *menu_item,
/** /**
* gtk_menu_item_set_submenu: * gtk_menu_item_set_submenu:
* @menu_item: a #GtkMenuItem * @menu_item: a #GtkMenuItem
* @submenu: (allow-none): the submenu, or %NULL * @submenu: (allow-none) (type Gtk.Menu): the submenu, or %NULL
* *
* Sets or replaces the menu item’s submenu, or removes it when a %NULL * Sets or replaces the menu item’s submenu, or removes it when a %NULL
* submenu is passed. * submenu is passed.
......
...@@ -77,13 +77,14 @@ typedef gboolean (*GtkRecentFilterFunc) (const GtkRecentFilterInfo *filter_info, ...@@ -77,13 +77,14 @@ typedef gboolean (*GtkRecentFilterFunc) (const GtkRecentFilterInfo *filter_info,
/** /**
* GtkRecentFilterInfo: * GtkRecentFilterInfo:
* @contains: #GtkRecentFilterFlags to indicate which fields are set. * @contains: #GtkRecentFilterFlags to indicate which fields are set.
* @uri: The URI of the file being tested. * @uri: (nullable): The URI of the file being tested.
* @display_name: The string that will be used to display the file in * @display_name: (nullable): The string that will be used to display
* the recent chooser. * the file in the recent chooser.
* @mime_type: MIME type of the file. * @mime_type: (nullable): MIME type of the file.
* @applications: The list of applications that have registered the * @applications: (nullable) (array zero-terminated=1): The list of
* file. * applications that have registered the file.
* @groups: The groups to which the file belongs to. * @groups: (nullable) (array zero-terminated=1): The groups to which
* the file belongs to.
* @age: The number of days elapsed since the file has been * @age: The number of days elapsed since the file has been
* registered. * registered.
* *
......
...@@ -1714,10 +1714,11 @@ gtk_selection_data_set_pixbuf (GtkSelectionData *selection_data, ...@@ -1714,10 +1714,11 @@ gtk_selection_data_set_pixbuf (GtkSelectionData *selection_data,
* *
* Gets the contents of the selection data as a #GdkPixbuf. * Gets the contents of the selection data as a #GdkPixbuf.
* *
* Returns: (transfer full): if the selection data contained a recognized * Returns: (nullable) (transfer full): if the selection data
* image type and it could be converted to a #GdkPixbuf, a * contained a recognized image type and it could be converted to a
* newly allocated pixbuf is returned, otherwise %NULL. * #GdkPixbuf, a newly allocated pixbuf is returned, otherwise
* If the result is non-%NULL it must be freed with g_object_unref(). * %NULL. If the result is non-%NULL it must be freed with
* g_object_unref().
* *
* Since: 2.6 * Since: 2.6
**/ **/
......
...@@ -2249,7 +2249,7 @@ gtk_tree_store_reorder_func (gconstpointer a, ...@@ -2249,7 +2249,7 @@ gtk_tree_store_reorder_func (gconstpointer a,
/** /**
* gtk_tree_store_reorder: (skip) * gtk_tree_store_reorder: (skip)
* @tree_store: A #GtkTreeStore * @tree_store: A #GtkTreeStore
* @parent: A #GtkTreeIter, or %NULL * @parent: (nullable): A #GtkTreeIter, or %NULL
* @new_order: (array): an array of integers mapping the new position of each child * @new_order: (array): an array of integers mapping the new position of each child
* to its old position before the re-ordering, * to its old position before the re-ordering,
* i.e. @new_order`[newpos] = oldpos`. * i.e. @new_order`[newpos] = oldpos`.
......
...@@ -11263,7 +11263,8 @@ gtk_tree_view_new_with_model (GtkTreeModel *model) ...@@ -11263,7 +11263,8 @@ gtk_tree_view_new_with_model (GtkTreeModel *model)
* Returns the model the #GtkTreeView is based on. Returns %NULL if the * Returns the model the #GtkTreeView is based on. Returns %NULL if the
* model is unset. * model is unset.
* *
* Returns: (transfer none): A #GtkTreeModel, or %NULL if none is currently being used. * Returns: (transfer none) (nullable): A #GtkTreeModel, or %NULL if
* none is currently being used.
**/ **/
GtkTreeModel * GtkTreeModel *
gtk_tree_view_get_model (GtkTreeView *tree_view) gtk_tree_view_get_model (GtkTreeView *tree_view)
......
...@@ -7865,7 +7865,7 @@ gtk_widget_reparent (GtkWidget *widget, ...@@ -7865,7 +7865,7 @@ gtk_widget_reparent (GtkWidget *widget,
* gtk_widget_intersect: * gtk_widget_intersect:
* @widget: a #GtkWidget * @widget: a #GtkWidget
* @area: a rectangle * @area: a rectangle
* @intersection: rectangle to store intersection of @widget and @area * @intersection: (nullable): rectangle to store intersection of @widget and @area
* *
* Computes the intersection of a @widget’s area and @area, storing * Computes the intersection of a @widget’s area and @area, storing
* the intersection in @intersection, and returns %TRUE if there was * the intersection in @intersection, and returns %TRUE if there was
...@@ -10254,7 +10254,7 @@ gtk_widget_create_pango_context (GtkWidget *widget) ...@@ -10254,7 +10254,7 @@ gtk_widget_create_pango_context (GtkWidget *widget)
/** /**
* gtk_widget_create_pango_layout: * gtk_widget_create_pango_layout:
* @widget: a #GtkWidget * @widget: a #GtkWidget
* @text: text to set on the layout (can be %NULL) * @text: (nullable): text to set on the layout (can be %NULL)
* *
* Creates a new #PangoLayout with the appropriate font map, * Creates a new #PangoLayout with the appropriate font map,
* font description, and base direction for drawing text for * font description, and base direction for drawing text for
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment