diff options
author | Matthias Clasen <mclasen@redhat.com> | 2023-03-27 21:55:36 -0400 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2023-03-27 21:55:36 -0400 |
commit | a2d20a5dc061bdb9145eea032357a928e97661a7 (patch) | |
tree | 2f34affa705acf4418fd30d54576b6d7b58e6342 /gtk/gtkmain.c | |
parent | cacecd2fb54025a59db0b5b02b5e52663b17e941 (diff) | |
download | gtk+-a2d20a5dc061bdb9145eea032357a928e97661a7.tar.gz |
docs: Some tweaks
Diffstat (limited to 'gtk/gtkmain.c')
-rw-r--r-- | gtk/gtkmain.c | 38 |
1 files changed, 17 insertions, 21 deletions
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c index ad41fa5749..85f90f1e4b 100644 --- a/gtk/gtkmain.c +++ b/gtk/gtkmain.c @@ -634,24 +634,22 @@ gtk_init_check (void) * gtk_init: * * Call this function before using any other GTK functions in your GUI - * applications. It will initialize everything needed to operate the + * applications. It will initialize everything needed to operate the * toolkit. * - * If you are using `GtkApplication`, you don't have to call gtk_init() - * or gtk_init_check(); the `GApplication::startup` handler - * does it for you. + * If you are using `GtkApplication`, you don't have to call this + * function; the `GApplication::startup` handler does it for you. * * This function will terminate your program if it was unable to * initialize the windowing system for some reason. If you want - * your program to fall back to a textual interface you want to - * call gtk_init_check() instead. + * your program to fall back to a textual interface, call + * [func@Gtk.init_check] instead. * - * GTK calls `signal (SIGPIPE, SIG_IGN)` - * during initialization, to ignore SIGPIPE signals, since these are - * almost never wanted in graphical applications. If you do need to - * handle SIGPIPE for some reason, reset the handler after gtk_init(), - * but notice that other libraries (e.g. libdbus or gvfs) might do - * similar things. + * GTK calls `signal (SIGPIPE, SIG_IGN)` during initialization, to ignore + * SIGPIPE signals, since these are almost never wanted in graphical + * applications. If you do need to handle SIGPIPE for some reason, reset + * the handler after gtk_init(), but notice that other libraries (e.g. + * libdbus or gvfs) might do similar things. */ void gtk_init (void) @@ -728,8 +726,9 @@ gtk_init_check_abi_check (int num_checks, size_t sizeof_GtkWindow, size_t sizeof /** * gtk_is_initialized: * - * Use this function to check if GTK has been initialized with gtk_init() - * or gtk_init_check(). + * Use this function to check if GTK has been initialized. + * + * See [func@Gtk.init]. * * Returns: the initialization status */ @@ -766,12 +765,11 @@ gtk_is_initialized (void) * update_locale (const char *new_locale) * { * setlocale (LC_ALL, new_locale); - * GtkTextDirection direction = gtk_get_locale_direction (); - * gtk_widget_set_default_direction (direction); + * gtk_widget_set_default_direction (gtk_get_locale_direction ()); * } * ]| * - * Returns: the `GtkTextDirection` of the current locale + * Returns: the direction of the current locale */ GtkTextDirection gtk_get_locale_direction (void) @@ -822,12 +820,10 @@ gtk_get_locale_direction (void) * locale. It determines, for example, whether GTK uses * the right-to-left or left-to-right text direction. * - * This function is equivalent to - * [func@Pango.Language.get_default]. + * This function is equivalent to [func@Pango.Language.get_default]. * See that function for details. * - * Returns: (transfer none): the default language as a - * `PangoLanguage` + * Returns: (transfer none): the default language */ PangoLanguage * gtk_get_default_language (void) |