Lerking/gtk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Beef up docs for gtk_init

Browse Source 
Mention explictly that this opens the default display.
This commit is contained in:
Matthias Clasen
2024-10-21 17:06:00 -04:00
parent 1f20d0c9ed
commit d6f93a3213
1 changed files with 7 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
gtk/gtkmain.c
View File

@@ -629,18 +629,19 @@ 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
* toolkit.
* applications.
*
* It will initialize everything needed to operate the toolkit. In particular,
* it will open the default display (see [func@Gdk.Display.get_default]).
*
* If you are using `GtkApplication`, you usually don't have to call this
* function; the `GApplication::startup` handler does it for you. Though,
* if you are using GApplication methods that will be invoked before `startup`,
* such as `local_command_line`, you may need to initialize stuff explicitly.
*
* 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, call
* [func@Gtk.init_check] instead.
* 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, 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