[gtk/ebassi/gidocgen: 480/500] settings: Convert docs
- From: Emmanuele Bassi <ebassi src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk/ebassi/gidocgen: 480/500] settings: Convert docs
- Date: Thu, 11 Mar 2021 16:48:19 +0000 (UTC)
commit f93f975e429f7b6206d775eec66af003ae837e95
Author: Matthias Clasen <mclasen redhat com>
Date: Mon Mar 1 22:52:39 2021 -0500
settings: Convert docs
gtk/gtksettings.c | 316 +++++++++++++++++++++++++++++++++++++++++-------------
1 file changed, 244 insertions(+), 72 deletions(-)
---
diff --git a/gtk/gtksettings.c b/gtk/gtksettings.c
index 30cf7d7321..f17090ef3d 100644
--- a/gtk/gtksettings.c
+++ b/gtk/gtksettings.c
@@ -63,11 +63,9 @@
#endif
/**
- * SECTION:gtksettings
- * @Short_description: Sharing settings between applications
- * @Title: Settings
+ * GtkSettings:
*
- * GtkSettings provide a mechanism to share global settings between
+ * `GtkSettings` provides a mechanism to share global settings between
* applications.
*
* On the X window system, this sharing is realized by an
@@ -81,18 +79,18 @@
* In the absence of these sharing mechanisms, GTK reads default values for
* settings from `settings.ini` files in `/etc/gtk-4.0`, `$XDG_CONFIG_DIRS/gtk-4.0`
* and `$XDG_CONFIG_HOME/gtk-4.0`. These files must be valid key files (see
- * #GKeyFile), and have a section called Settings. Themes can also provide
+ * `GKeyFile`), and have a section called Settings. Themes can also provide
* default values for settings by installing a `settings.ini` file
* next to their `gtk.css` file.
*
* Applications can override system-wide settings by setting the property
- * of the GtkSettings object with g_object_set(). This should be restricted
- * to special cases though; GtkSettings are not meant as an application
+ * of the `GtkSettings` object with g_object_set(). This should be restricted
+ * to special cases though; `GtkSettings` are not meant as an application
* configuration facility.
*
- * There is one GtkSettings instance per display. It can be obtained with
- * gtk_settings_get_for_display(), but in many cases, it is more convenient
- * to use gtk_widget_get_settings().
+ * There is one `GtkSettings` instance per display. It can be obtained with
+ * [type_func@GtkSettings.get_for_display], but in many cases, it is more
+ * convenient to use [method@Gtk.Widget.get_settings].
*/
/* --- typedefs --- */
@@ -331,6 +329,12 @@ gtk_settings_class_init (GtkSettingsClass *class)
quark_gtk_settings = g_quark_from_static_string ("gtk-settings");
+ /**
+ * GtkSettings:gtk-double-click-time:
+ *
+ * The maximum time to allow between two clicks for them to be considered
+ * a double click, in milliseconds.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-double-click-time",
P_("Double Click Time"),
@@ -338,6 +342,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
0, G_MAXINT, 400,
GTK_PARAM_READWRITE));
g_assert (result == PROP_DOUBLE_CLICK_TIME);
+
+ /**
+ * GtkSettings:gtk-double-click-distance:
+ *
+ * The maximum distance allowed between two clicks for them to be considered
+ * a double click, in pixels.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-double-click-distance",
P_("Double Click Distance"),
@@ -351,7 +362,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
*
* Whether the cursor should blink.
*
- * Also see the #GtkSettings:gtk-cursor-blink-timeout setting,
+ * Also see the [property@Gtk.Settings:gtk-cursor-blink-timeout] setting,
* which allows more flexible control over cursor blinking.
*/
result = settings_install_property_parser (class,
@@ -361,6 +372,12 @@ gtk_settings_class_init (GtkSettingsClass *class)
TRUE,
GTK_PARAM_READWRITE));
g_assert (result == PROP_CURSOR_BLINK);
+
+ /**
+ * GtkSettings:gtk-cursor-blink-time:
+ *
+ * Length of the cursor blink cycle, in milliseconds.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-cursor-blink-time",
P_("Cursor Blink Time"),
@@ -373,10 +390,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-cursor-blink-timeout:
*
* Time after which the cursor stops blinking, in seconds.
+ *
* The timer is reset after each user interaction.
*
* Setting this to zero has the same effect as setting
- * #GtkSettings:gtk-cursor-blink to %FALSE.
+ * [property@Gtk.Settings:gtk-cursor-blink] to %FALSE.
*/
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-cursor-blink-timeout",
@@ -385,6 +403,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
1, G_MAXINT, 10,
GTK_PARAM_READWRITE));
g_assert (result == PROP_CURSOR_BLINK_TIMEOUT);
+
+ /**
+ * GtkSettings:gtk-split-cursor:
+ *
+ * Whether two cursors should be displayed for mixed left-to-right and
+ * right-to-left text.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-split-cursor",
P_("Split Cursor"),
@@ -393,6 +418,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_SPLIT_CURSOR);
+ /**
+ * GtkSettings:gtk-cursor-aspect-ratio:
+ *
+ * The aspect ratio of the text caret.
+ */
result = settings_install_property_parser (class,
g_param_spec_double ("gtk-cursor-aspect-ratio",
P_("Cursor Aspect Ratio"),
@@ -401,6 +431,14 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_CURSOR_ASPECT_RATIO);
+ /**
+ * GtkSettings:gtk-theme-name:
+ *
+ * Name of the theme to load.
+ *
+ * See [class@Gtk.CssProvider] for details about how
+ * GTK finds the CSS stylesheet for a theme.
+ */
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-theme-name",
P_("Theme Name"),
@@ -409,6 +447,14 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_THEME_NAME);
+ /**
+ * GtkSettings:gtk-icon-theme-name:
+ *
+ * Name of the icon theme to use.
+ *
+ * See [class@Gtk.IconTheme] for details about how
+ * GTK handles icon themes.
+ */
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-icon-theme-name",
P_("Icon Theme Name"),
@@ -417,6 +463,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_ICON_THEME_NAME);
+ /**
+ * GtkSettings:gtk-dnd-drag-threshold:
+ *
+ * The number of pixels the cursor can move before dragging.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-dnd-drag-threshold",
P_("Drag threshold"),
@@ -428,7 +479,9 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-font-name:
*
- * The default font to use. GTK uses the family name and size from this string.
+ * The default font to use.
+ *
+ * GTK uses the family name and size from this string.
*/
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-font-name",
@@ -438,6 +491,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_FONT_NAME);
+ /**
+ * GtkSettings:gtk-xft-antialias:
+ *
+ * Whether to antialias fonts.
+ *
+ * The values are 0 for no, 1 for yes, or -1 for the system default.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-xft-antialias",
P_("Xft Antialias"),
@@ -447,6 +507,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
g_assert (result == PROP_XFT_ANTIALIAS);
+ /**
+ * GtkSettings:gtk-xft-hinting:
+ *
+ * Whether to enable font hinting.
+ *
+ * The values are 0 for no, 1 for yes, or -1 for the system default.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-xft-hinting",
P_("Xft Hinting"),
@@ -456,6 +523,14 @@ gtk_settings_class_init (GtkSettingsClass *class)
g_assert (result == PROP_XFT_HINTING);
+ /**
+ * GtkSettings:gtk-xft-hintstyle:
+ *
+ * What degree of font hinting to use.
+ *
+ * The possible vaues are hintnone, hintslight,
+ * hintmedium, hintfull.
+ */
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-xft-hintstyle",
P_("Xft Hint Style"),
@@ -465,6 +540,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
g_assert (result == PROP_XFT_HINTSTYLE);
+ /**
+ * GtkSettings:gtk-xft-rgba:
+ *
+ * The type of subpixel antialiasing to use.
+ *
+ * The possible values are none, rgb, bgr, vrgb, vbgr.
+ */
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-xft-rgba",
P_("Xft RGBA"),
@@ -474,6 +556,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
g_assert (result == PROP_XFT_RGBA);
+ /**
+ * GtkSettings:gtk-xft-dpi:
+ *
+ * The font resolution, in 1024 * dots/inch.
+ *
+ * -1 to use the default value.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-xft-dpi",
P_("Xft DPI"),
@@ -483,6 +572,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
g_assert (result == PROP_XFT_DPI);
+ /**
+ * GtkSettings:gtk-cursor-theme-name:
+ *
+ * Name of the cursor theme to use.
+ *
+ * Use %NULL to use the default theme.
+ */
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-cursor-theme-name",
P_("Cursor theme name"),
@@ -491,6 +587,13 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_CURSOR_THEME_NAME);
+ /**
+ * GtkSettings:gtk-cursor-theme-size:
+ *
+ * The size to use for cursors.
+ *
+ * 0 means to use the default size.
+ */
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-cursor-theme-size",
P_("Cursor theme size"),
@@ -500,6 +603,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
g_assert (result == PROP_CURSOR_THEME_SIZE);
+ /**
+ * GtkSettings:gtk-alternative-button-order:
+ *
+ * Whether buttons in dialogs should use the alternative button order.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-alternative-button-order",
P_("Alternative button order"),
@@ -512,7 +620,9 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-alternative-sort-arrows:
*
* Controls the direction of the sort indicators in sorted list and tree
- * views. By default an arrow pointing down means the column is sorted
+ * views.
+ *
+ * By default an arrow pointing down means the column is sorted
* in ascending order. When set to %TRUE, this order will be inverted.
*/
result = settings_install_property_parser (class,
@@ -523,6 +633,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_ALTERNATIVE_SORT_ARROWS);
+ /**
+ * GtkSettings:gtk-enable-animations:
+ *
+ * Whether to enable toolkit-wide animations.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-enable-animations",
P_("Enable Animations"),
@@ -536,10 +651,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-error-bell:
*
* When %TRUE, keyboard navigation and other input-related errors
- * will cause a beep. Since the error bell is implemented using
- * gdk_surface_beep(), the windowing system may offer ways to
- * configure the error bell in many ways, such as flashing the
- * window or similar visual effects.
+ * will cause a beep.
+ *
+ * Since the error bell is implemented using gdk_surface_beep(), the
+ * windowing system may offer ways to configure the error bell in many
+ * ways, such as flashing the window or similar visual effects.
*/
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-error-bell",
@@ -554,7 +670,9 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-print-backends:
*
* A comma-separated list of print backends to use in the print
- * dialog. Available print backends depend on the GTK installation,
+ * dialog.
+ *
+ * Available print backends depend on the GTK installation,
* and may include "file", "cups", "lpr" or "papi".
*/
result = settings_install_property_parser (class,
@@ -568,15 +686,16 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-print-preview-command:
*
- * A command to run for displaying the print preview. The command
- * should contain a `%f` placeholder, which will get replaced by
- * the path to the pdf file. The command may also contain a `%s`
- * placeholder, which will get replaced by the path to a file
- * containing the print settings in the format produced by
- * gtk_print_settings_to_file().
+ * A command to run for displaying the print preview.
+ *
+ * The command should contain a `%f` placeholder, which will get
+ * replaced by the path to the pdf file. The command may also
+ * contain a `%s` placeholder, which will get replaced by the
+ * path to a file containing the print settings in the format
+ * produced by [method@Gtk.PrintSettings.to_file].
*
- * The preview application is responsible for removing the pdf file
- * and the print settings file when it is done.
+ * The preview application is responsible for removing the pdf
+ * file and the print settings file when it is done.
*/
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-print-preview-command",
@@ -603,13 +722,14 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-im-module:
*
- * Which IM (input method) module should be used by default. This is the
- * input method that will be used if the user has not explicitly chosen
- * another input method from the IM context menu.
+ * Which IM (input method) module should be used by default.
+ *
+ * This is the input method that will be used if the user has not
+ * explicitly chosen another input method from the IM context menu.
* This also can be a colon-separated list of input methods, which GTK
* will try in turn until it finds one available on the system.
*
- * See #GtkIMContext.
+ * See [class@Gtk.IMContext].
*/
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-im-module",
@@ -623,9 +743,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-recent-files-max-age:
*
* The maximum age, in days, of the items inside the recently used
- * resources list. Items older than this setting will be excised
- * from the list. If set to 0, the list will always be empty; if
- * set to -1, no item will be removed.
+ * resources list.
+ *
+ * Items older than this setting will be excised from the list.
+ * If set to 0, the list will always be empty; if set to -1, no
+ * item will be removed.
*/
result = settings_install_property_parser (class,
g_param_spec_int ("gtk-recent-files-max-age",
@@ -636,6 +758,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_RECENT_FILES_MAX_AGE);
+ /**
+ * GtkSettings:gtk-fontconfig-timestamp:
+ *
+ * Timestamp of the curent fontconfig configuration.
+ */
result = settings_install_property_parser (class,
g_param_spec_uint ("gtk-fontconfig-timestamp",
P_("Fontconfig configuration timestamp"),
@@ -653,8 +780,8 @@ gtk_settings_class_init (GtkSettingsClass *class)
* See the [Sound Theme Specifications](http://www.freedesktop.org/wiki/Specifications/sound-theme-spec)
* for more information on event sounds and sound themes.
*
- * GTK itself does not support event sounds, you have to use a loadable
- * module like the one that comes with libcanberra.
+ * GTK itself does not support event sounds, you have to use
+ * a loadable module like the one that comes with libcanberra.
*/
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-sound-theme-name",
@@ -708,12 +835,14 @@ gtk_settings_class_init (GtkSettingsClass *class)
*
* If the value of this setting is %TRUE, clicking the primary button in a
* #GtkRange trough will move the slider, and hence set the range’s value, to
- * the point that you clicked. If it is %FALSE, a primary click will cause the
- * slider/value to move by the range’s page-size towards the point clicked.
+ * the point that you clicked.
+ *
+ * If it is %FALSE, a primary click will cause the slider/value to move
+ * by the range’s page-size towards the point clicked.
*
* Whichever action you choose for the primary button, the other action will
- * be available by holding Shift and primary-clicking, or (since GTK 3.22.25)
- * clicking the middle mouse button.
+ * be available by holding Shift and primary-clicking, or clicking the middle
+ * mouse button.
*/
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-primary-button-warps-slider",
@@ -726,17 +855,20 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-application-prefer-dark-theme:
*
- * Whether the application prefers to use a dark theme. If a GTK theme
- * includes a dark variant, it will be used instead of the configured
- * theme.
+ * Whether the application prefers to use a dark theme.
+ *
+ * If a GTK theme includes a dark variant, it will be used
+ * instead of the configured theme.
*
- * Some applications benefit from minimizing the amount of light pollution that
- * interferes with the content. Good candidates for dark themes are photo and
- * video editors that make the actual content get all the attention and minimize
- * the distraction of the chrome.
+ * Some applications benefit from minimizing the amount of light
+ * pollution that interferes with the content. Good candidates for
+ * dark themes are photo and video editors that make the actual
+ * content get all the attention and minimize the distraction of
+ * the chrome.
*
- * Dark themes should not be used for documents, where large spaces are white/light
- * and the dark chrome creates too much contrast (web browser, text editor...).
+ * Dark themes should not be used for documents, where large spaces
+ * are white/light and the dark chrome creates too much contrast
+ * (web browser, text editor...).
*/
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-application-prefer-dark-theme",
@@ -746,6 +878,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_APPLICATION_PREFER_DARK_THEME);
+ /**
+ * GtkSettings:gkt-entry-select-on-focus:
+ *
+ * Whether to select the contents of an entry when it is focused.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-entry-select-on-focus",
P_("Select on focus"),
@@ -758,7 +895,9 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-entry-password-hint-timeout:
*
* How long to show the last input character in hidden
- * entries. This value is in milliseconds. 0 disables showing the
+ * entries.
+ *
+ * This value is in milliseconds. 0 disables showing the
* last char. 600 is a good value for enabling it.
*/
result = settings_install_property_parser (class,
@@ -770,6 +909,12 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_ENTRY_PASSWORD_HINT_TIMEOUT);
+ /**
+ * GtkSettings:gtk-label-select-on-focus:
+ *
+ * Whether to select the contents of a selectable
+ * label when it is focused.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-label-select-on-focus",
P_("Select on focus"),
@@ -778,6 +923,12 @@ gtk_settings_class_init (GtkSettingsClass *class)
GTK_PARAM_READWRITE));
g_assert (result == PROP_LABEL_SELECT_ON_FOCUS);
+ /**
+ * GtkSettings:gtk-shell-shows-app-menu:
+ *
+ * Set to %TRUE if the desktop environment is displaying
+ * the app menu, %FALSE if the app should display it itself.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-shell-shows-app-menu",
P_("Desktop shell shows app menu"),
@@ -787,6 +938,12 @@ gtk_settings_class_init (GtkSettingsClass *class)
FALSE, GTK_PARAM_READWRITE));
g_assert (result == PROP_SHELL_SHOWS_APP_MENU);
+ /**
+ * GtkSettings:gtk-shell-shows-menubar:
+ *
+ * Set to %TRUE if the desktop environment is displaying
+ * the menubar, %FALSE if the app should display it itself.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-shell-shows-menubar",
P_("Desktop shell shows the menubar"),
@@ -796,6 +953,12 @@ gtk_settings_class_init (GtkSettingsClass *class)
FALSE, GTK_PARAM_READWRITE));
g_assert (result == PROP_SHELL_SHOWS_MENUBAR);
+ /**
+ * GtkSettings:gtk-shell-shows-desktop:
+ *
+ * Set to %TRUE if the desktop environment is displaying
+ * the desktop folder, %FALSE if not.
+ */
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-shell-shows-desktop",
P_("Desktop environment shows the desktop
folder"),
@@ -808,7 +971,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-decoration-layout:
*
- * This setting determines which buttons should be put in the
+ * Determines which buttons should be put in the
* titlebar of client-side decorated windows, and whether they
* should be placed at the left of right.
*
@@ -827,7 +990,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
* that can be closed.
*
* Also note that the setting can be overridden with the
- * #GtkHeaderBar:decoration-layout property.
+ * [property@Gtk.HeaderBar:decoration-layout] property.
*/
result = settings_install_property_parser (class,
g_param_spec_string ("gtk-decoration-layout",
@@ -839,7 +1002,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-titlebar-double-click:
*
- * This setting determines the action to take when a double-click
+ * Determines the action to take when a double-click
* occurs on the titlebar of client-side decorated windows.
*
* Recognized actions are minimize, toggle-maximize, menu, lower
@@ -855,7 +1018,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-titlebar-middle-click:
*
- * This setting determines the action to take when a middle-click
+ * Determines the action to take when a middle-click
* occurs on the titlebar of client-side decorated windows.
*
* Recognized actions are minimize, toggle-maximize, menu, lower
@@ -871,7 +1034,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-titlebar-right-click:
*
- * This setting determines the action to take when a right-click
+ * Determines the action to take when a right-click
* occurs on the titlebar of client-side decorated windows.
*
* Recognized actions are minimize, toggle-maximize, menu, lower
@@ -891,7 +1054,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
* color chooser or the font chooser will use a header bar at
* the top to show action widgets, or an action area at the bottom.
*
- * This setting does not affect custom dialogs using GtkDialog
+ * This setting does not affect custom dialogs using `GtkDialog`
* directly, or message dialogs.
*/
result = settings_install_property_parser (class,
@@ -920,7 +1083,9 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-recent-files-enabled:
*
* Whether GTK should keep track of items inside the recently used
- * resources list. If set to %FALSE, the list will always be empty.
+ * resources list.
+ *
+ * If set to %FALSE, the list will always be empty.
*/
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-recent-files-enabled",
@@ -933,7 +1098,9 @@ gtk_settings_class_init (GtkSettingsClass *class)
/**
* GtkSettings:gtk-long-press-time:
*
- * The time for a button or touch press to be considered a "long press".
+ * The time for a button or touch press to be considered a “long press”.
+ *
+ * See [class@Gtk.GestureLongPress].
*/
result = settings_install_property_parser (class,
g_param_spec_uint ("gtk-long-press-time",
@@ -947,8 +1114,9 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-keynav-use-caret:
*
* Whether GTK should make sure that text can be navigated with
- * a caret, even if it is not editable. This is useful when using
- * a screen reader.
+ * a caret, even if it is not editable.
+ *
+ * This is useful when using a screen reader.
*/
result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-keynav-use-caret",
@@ -962,6 +1130,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-overlay-scrolling:
*
* Whether scrolled windows may use overlaid scrolling indicators.
+ *
* If this is set to %FALSE, scrolled windows will have permanent
* scrollbars.
*/
@@ -1130,11 +1299,11 @@ gtk_settings_create_for_display (GdkDisplay *display)
/**
* gtk_settings_get_for_display:
- * @display: a #GdkDisplay.
+ * @display: a `GdkDisplay`
*
- * Gets the #GtkSettings object for @display, creating it if necessary.
+ * Gets the `GtkSettings` object for @display, creating it if necessary.
*
- * Returns: (transfer none): a #GtkSettings object.
+ * Returns: (transfer none): a `GtkSettings` object
*/
GtkSettings *
gtk_settings_get_for_display (GdkDisplay *display)
@@ -1159,12 +1328,14 @@ gtk_settings_get_for_display (GdkDisplay *display)
/**
* gtk_settings_get_default:
*
- * Gets the #GtkSettings object for the default display, creating
- * it if necessary. See gtk_settings_get_for_display().
+ * Gets the `GtkSettings` object for the default display, creating
+ * it if necessary.
*
- * Returns: (nullable) (transfer none): a #GtkSettings object. If there is
- * no default display, then returns %NULL.
- **/
+ * See [type_func@Gtk.Settings.get_for_display].
+ *
+ * Returns: (nullable) (transfer none): a `GtkSettings` object. If there is
+ * no default display, then returns %NULL.
+ */
GtkSettings*
gtk_settings_get_default (void)
{
@@ -1953,13 +2124,14 @@ _gtk_settings_get_setting_source (GtkSettings *settings,
/**
* gtk_settings_reset_property:
- * @settings: a #GtkSettings object
+ * @settings: a `GtkSettings` object
* @name: the name of the setting to reset
*
* Undoes the effect of calling g_object_set() to install an
- * application-specific value for a setting. After this call,
- * the setting will again follow the session-wide value for
- * this setting.
+ * application-specific value for a setting.
+ *
+ * After this call, the setting will again follow the session-wide
+ * value for this setting.
*/
void
gtk_settings_reset_property (GtkSettings *settings,
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
