diff options
author | Matthias Clasen <mclasen@redhat.com> | 2020-05-26 20:52:41 -0400 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2020-05-26 20:52:41 -0400 |
commit | c47553e31911b2f23ef0edce459358b2ccf52501 (patch) | |
tree | b03b6f5e8fd05c5a35a950b8ffdfae1404f46fcc /gdk | |
parent | 45f162fc50ccc007e6fa634cbe4da1496ada352f (diff) | |
download | gtk+-c47553e31911b2f23ef0edce459358b2ccf52501.tar.gz |
gdk: Drop no-longer-used documentation
Thread support is gone, and we don't have that
section in the docs anymore.
Diffstat (limited to 'gdk')
-rw-r--r-- | gdk/gdk.c | 51 |
1 files changed, 0 insertions, 51 deletions
@@ -296,57 +296,6 @@ gdk_should_use_portal (void) return use_portal[0] == '1'; } -/** - * SECTION:threads - * @Short_description: Functions for using GDK in multi-threaded programs - * @Title: Threads - * - * For thread safety, GDK relies on the thread primitives in GLib, - * and on the thread-safe GLib main loop. - * - * GLib is completely thread safe (all global data is automatically - * locked), but individual data structure instances are not automatically - * locked for performance reasons. So e.g. you must coordinate - * accesses to the same #GHashTable from multiple threads. - * - * GTK, however, is not thread safe. You should only use GTK and GDK - * from the thread gtk_init() and gtk_main() were called on. - * This is usually referred to as the “main thread”. - * - * Signals on GTK and GDK types, as well as non-signal callbacks, are - * emitted in the main thread. - * - * You can schedule work in the main thread safely from other threads - * by using g_main_context_invoke(), g_idle_add(), and g_timeout_add(): - * - * |[<!-- language="C" --> - * static void - * worker_thread (void) - * { - * ExpensiveData *expensive_data = do_expensive_computation (); - * - * g_main_context_invoke (NULL, got_value, expensive_data); - * } - * - * static gboolean - * got_value (gpointer user_data) - * { - * ExpensiveData *expensive_data = user_data; - * - * my_app->expensive_data = expensive_data; - * gtk_button_set_sensitive (my_app->button, TRUE); - * gtk_button_set_label (my_app->button, expensive_data->result_label); - * - * return G_SOURCE_REMOVE; - * } - * ]| - * - * For more information on this "worker thread" pattern, you should - * also look at #GTask, which gives you high-level tools to perform - * expensive tasks from worker threads, and will handle thread - * management for you. - */ - PangoDirection gdk_unichar_direction (gunichar ch) { |