Merge branch 'ebassi/since-for-main' into 'main'

docs: Add deprecation notices for properties

See merge request GNOME/gtk!5204
This commit is contained in:
Matthias Clasen 2022-11-08 16:01:11 +00:00
commit 9e28a407df
2 changed files with 26 additions and 1 deletions

View File

@ -61,6 +61,9 @@ gtk_color_chooser_default_init (GtkColorChooserInterface *iface)
*
* The property can be set to change the current selection
* programmatically.
*
* Deprecated: 4.10: Use [class@Gtk.ColorDialog] and [class@Gtk.ColorDialogButton]
* instead of widgets implementing `GtkColorChooser`
*/
g_object_interface_install_property (iface,
g_param_spec_boxed ("rgba", NULL, NULL,
@ -78,6 +81,9 @@ gtk_color_chooser_default_init (GtkColorChooserInterface *iface)
*
* Implementations are expected to show alpha by rendering the color
* over a non-uniform background (like a checkerboard pattern).
*
* Deprecated: 4.10: Use [class@Gtk.ColorDialog] and [class@Gtk.ColorDialogButton]
* instead of widgets implementing `GtkColorChooser`
*/
g_object_interface_install_property (iface,
g_param_spec_boolean ("use-alpha", NULL, NULL,
@ -94,6 +100,9 @@ gtk_color_chooser_default_init (GtkColorChooserInterface *iface)
* This usually happens when the user clicks a color swatch,
* or a color is selected and the user presses one of the keys
* Space, Shift+Space, Return or Enter.
*
* Deprecated: 4.10: Use [class@Gtk.ColorDialog] and [class@Gtk.ColorDialogButton]
* instead of widgets implementing `GtkColorChooser`
*/
signals[COLOR_ACTIVATED] =
g_signal_new (I_("color-activated"),

View File

@ -59,6 +59,8 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* GtkFontChooser:font: (attributes org.gtk.Property.get=gtk_font_chooser_get_font org.gtk.Property.set=gtk_font_chooser_set_font)
*
* The font description as a string, e.g. "Sans Italic 12".
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
g_object_interface_install_property
(iface,
@ -70,6 +72,8 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* GtkFontChooser:font-desc: (attributes org.gtk.Property.get=gtk_font_chooser_get_font_desc org.gtk.Property.set=gtk_font_chooser_set_font_desc)
*
* The font description as a `PangoFontDescription`.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
g_object_interface_install_property
(iface,
@ -81,6 +85,8 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* GtkFontChooser:preview-text: (attributes org.gtk.Property.get=gtk_font_chooser_get_preview_text org.gtk.Property.set=gtk_font_chooser_set_preview_text)
*
* The string with which to preview the font.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
g_object_interface_install_property
(iface,
@ -92,6 +98,8 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* GtkFontChooser:show-preview-entry: (attributes org.gtk.Property.get=gtk_font_chooser_get_show_preview_entry org.gtk.Property.set=gtk_font_chooser_set_show_preview_entry)
*
* Whether to show an entry to change the preview text.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
g_object_interface_install_property
(iface,
@ -103,6 +111,8 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* GtkFontChooser:level: (attributes org.gtk.Property.get=gtk_font_chooser_get_level org.gtk.Property.set=gtk_font_chooser_set_level)
*
* The level of granularity to offer for selecting fonts.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
g_object_interface_install_property
(iface,
@ -120,6 +130,8 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
*
* The format of the string is compatible with
* CSS and with Pango attributes.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
g_object_interface_install_property
(iface,
@ -131,6 +143,8 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* GtkFontChooser:language: (attributes org.gtk.Property.get=gtk_font_chooser_get_language org.gtk.Property.set=gtk_font_chooser_set_language)
*
* The language for which the font features were selected.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
g_object_interface_install_property
(iface,
@ -148,7 +162,9 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* This usually happens when the user double clicks an item,
* or an item is selected and the user presses one of the keys
* Space, Shift+Space, Return or Enter.
*/
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead
*/
chooser_signals[SIGNAL_FONT_ACTIVATED] =
g_signal_new (I_("font-activated"),
GTK_TYPE_FONT_CHOOSER,