docs: Add missing Deprecated annotations

This commit is contained in:
Emmanuele Bassi 2022-10-30 20:08:39 +00:00
parent 37fadb20a9
commit d665b0e042

View File

@ -84,6 +84,8 @@ gtk_file_chooser_default_init (GtkFileChooserInterface *iface)
* GtkFileChooser:action: (attributes org.gtk.Property.get=gtk_file_chooser_get_action org.gtk.Property.set=gtk_file_chooser_set_action) * GtkFileChooser:action: (attributes org.gtk.Property.get=gtk_file_chooser_get_action org.gtk.Property.set=gtk_file_chooser_set_action)
* *
* The type of operation that the file chooser is performing. * The type of operation that the file chooser is performing.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
g_object_interface_install_property (iface, g_object_interface_install_property (iface,
g_param_spec_enum ("action", NULL, NULL, g_param_spec_enum ("action", NULL, NULL,
@ -96,6 +98,8 @@ gtk_file_chooser_default_init (GtkFileChooserInterface *iface)
* GtkFileChooser:filter: (attributes org.gtk.Property.get=gtk_file_chooser_get_filter org.gtk.Property.set=gtk_file_chooser_set_filter) * GtkFileChooser:filter: (attributes org.gtk.Property.get=gtk_file_chooser_get_filter org.gtk.Property.set=gtk_file_chooser_set_filter)
* *
* The current filter for selecting files that are displayed. * The current filter for selecting files that are displayed.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
g_object_interface_install_property (iface, g_object_interface_install_property (iface,
g_param_spec_object ("filter", NULL, NULL, g_param_spec_object ("filter", NULL, NULL,
@ -106,6 +110,8 @@ gtk_file_chooser_default_init (GtkFileChooserInterface *iface)
* GtkFileChooser:select-multiple: (attributes org.gtk.Property.get=gtk_file_chooser_get_select_multiple org.gtk.Property.set=gtk_file_chooser_set_select_multiple) * GtkFileChooser:select-multiple: (attributes org.gtk.Property.get=gtk_file_chooser_get_select_multiple org.gtk.Property.set=gtk_file_chooser_set_select_multiple)
* *
* Whether to allow multiple files to be selected. * Whether to allow multiple files to be selected.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
g_object_interface_install_property (iface, g_object_interface_install_property (iface,
g_param_spec_boolean ("select-multiple", NULL, NULL, g_param_spec_boolean ("select-multiple", NULL, NULL,
@ -120,6 +126,8 @@ gtk_file_chooser_default_init (GtkFileChooserInterface *iface)
* *
* The returned object should not be modified. It may * The returned object should not be modified. It may
* or may not be updated for later changes. * or may not be updated for later changes.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
g_object_interface_install_property (iface, g_object_interface_install_property (iface,
g_param_spec_object ("filters", NULL, NULL, g_param_spec_object ("filters", NULL, NULL,
@ -134,6 +142,8 @@ gtk_file_chooser_default_init (GtkFileChooserInterface *iface)
* *
* The returned object should not be modified. It may * The returned object should not be modified. It may
* or may not be updated for later changes. * or may not be updated for later changes.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
g_object_interface_install_property (iface, g_object_interface_install_property (iface,
g_param_spec_object ("shortcut-folders", NULL, NULL, g_param_spec_object ("shortcut-folders", NULL, NULL,
@ -145,6 +155,8 @@ gtk_file_chooser_default_init (GtkFileChooserInterface *iface)
* *
* Whether a file chooser not in %GTK_FILE_CHOOSER_ACTION_OPEN mode * Whether a file chooser not in %GTK_FILE_CHOOSER_ACTION_OPEN mode
* will offer the user to create new folders. * will offer the user to create new folders.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
g_object_interface_install_property (iface, g_object_interface_install_property (iface,
g_param_spec_boolean ("create-folders", NULL, NULL, g_param_spec_boolean ("create-folders", NULL, NULL,
@ -156,7 +168,7 @@ gtk_file_chooser_default_init (GtkFileChooserInterface *iface)
* gtk_file_chooser_error_quark: * gtk_file_chooser_error_quark:
* *
* Registers an error quark for `GtkFileChooser` errors. * Registers an error quark for `GtkFileChooser` errors.
* *
* Returns: The error quark used for `GtkFileChooser` errors. * Returns: The error quark used for `GtkFileChooser` errors.
**/ **/
GQuark GQuark
@ -203,7 +215,7 @@ GtkFileChooserAction
gtk_file_chooser_get_action (GtkFileChooser *chooser) gtk_file_chooser_get_action (GtkFileChooser *chooser)
{ {
GtkFileChooserAction action; GtkFileChooserAction action;
g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), FALSE); g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), FALSE);
g_object_get (chooser, "action", &action, NULL); g_object_get (chooser, "action", &action, NULL);
@ -248,7 +260,7 @@ gboolean
gtk_file_chooser_get_select_multiple (GtkFileChooser *chooser) gtk_file_chooser_get_select_multiple (GtkFileChooser *chooser)
{ {
gboolean select_multiple; gboolean select_multiple;
g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), FALSE); g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), FALSE);
g_object_get (chooser, "select-multiple", &select_multiple, NULL); g_object_get (chooser, "select-multiple", &select_multiple, NULL);
@ -291,7 +303,7 @@ gboolean
gtk_file_chooser_get_create_folders (GtkFileChooser *chooser) gtk_file_chooser_get_create_folders (GtkFileChooser *chooser)
{ {
gboolean create_folders; gboolean create_folders;
g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), FALSE); g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), FALSE);
g_object_get (chooser, "create-folders", &create_folders, NULL); g_object_get (chooser, "create-folders", &create_folders, NULL);
@ -326,7 +338,7 @@ gtk_file_chooser_set_current_name (GtkFileChooser *chooser,
{ {
g_return_if_fail (GTK_IS_FILE_CHOOSER (chooser)); g_return_if_fail (GTK_IS_FILE_CHOOSER (chooser));
g_return_if_fail (name != NULL); g_return_if_fail (name != NULL);
GTK_FILE_CHOOSER_GET_IFACE (chooser)->set_current_name (chooser, name); GTK_FILE_CHOOSER_GET_IFACE (chooser)->set_current_name (chooser, name);
} }
@ -359,7 +371,7 @@ void
gtk_file_chooser_select_all (GtkFileChooser *chooser) gtk_file_chooser_select_all (GtkFileChooser *chooser)
{ {
g_return_if_fail (GTK_IS_FILE_CHOOSER (chooser)); g_return_if_fail (GTK_IS_FILE_CHOOSER (chooser));
GTK_FILE_CHOOSER_GET_IFACE (chooser)->select_all (chooser); GTK_FILE_CHOOSER_GET_IFACE (chooser)->select_all (chooser);
} }
@ -368,7 +380,7 @@ gtk_file_chooser_unselect_all (GtkFileChooser *chooser)
{ {
g_return_if_fail (GTK_IS_FILE_CHOOSER (chooser)); g_return_if_fail (GTK_IS_FILE_CHOOSER (chooser));
GTK_FILE_CHOOSER_GET_IFACE (chooser)->unselect_all (chooser); GTK_FILE_CHOOSER_GET_IFACE (chooser)->unselect_all (chooser);
} }
@ -619,6 +631,8 @@ gtk_file_chooser_remove_shortcut_folder (GtkFileChooser *chooser,
* *
* Note that the @chooser takes ownership of the filter if it is floating, * Note that the @chooser takes ownership of the filter if it is floating,
* so you have to ref and sink it if you want to keep a reference. * so you have to ref and sink it if you want to keep a reference.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
void void
gtk_file_chooser_add_filter (GtkFileChooser *chooser, gtk_file_chooser_add_filter (GtkFileChooser *chooser,
@ -661,6 +675,8 @@ gtk_file_chooser_remove_filter (GtkFileChooser *chooser,
* *
* Returns: (transfer full): a `GListModel` containing the current set * Returns: (transfer full): a `GListModel` containing the current set
* of user-selectable filters. * of user-selectable filters.
*
* Deprecated: 4.10: Use [class@Gtk.FileDialog] instead
*/ */
GListModel * GListModel *
gtk_file_chooser_get_filters (GtkFileChooser *chooser) gtk_file_chooser_get_filters (GtkFileChooser *chooser)
@ -711,7 +727,7 @@ GtkFileFilter *
gtk_file_chooser_get_filter (GtkFileChooser *chooser) gtk_file_chooser_get_filter (GtkFileChooser *chooser)
{ {
GtkFileFilter *filter; GtkFileFilter *filter;
g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), NULL); g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), NULL);
g_object_get (chooser, "filter", &filter, NULL); g_object_get (chooser, "filter", &filter, NULL);