Recent changes to API

API modified by Lachu

Lachu — Mon, 02 Mar 2026 19:49:42 -0000

--- v18
+++ v19
@@ -1,4 +1,9 @@
 Below I described libgreattao API
+
+void tao_initialize_set_insecure_tags(int argc, char **argv)
+-------------------
+It will checks each string pointed by argv array with size pointed by argc for matching to string given by module/shell/networking. If matched, it will asks for password. Application must be protected against debugging. I do not known how to protect debugging in good fashion, but setting suid/guid bits are bad idea, because libgreattao can work in GUI and GTK+/Qt backends are sensitive about these bits.
+This function must be called before tao_initialize.

 void \*tao_new_window(const char \*class)
 -------------------

API modified by Lachu

Lachu — Sun, 04 Oct 2015 07:03:36 -0000

--- v17
+++ v18
@@ -79,6 +79,6 @@
 -------------------
 Callback function will be called, when application exits.

-void tao_display_windows(int count, \*\* windows)
+void tao_display_windows(int count, void \*\* windows)
 -------------------
 Function created for displaying simple windows, like messages. It starts message loop and exits from it, when all given window in windows array are closed. Backend are informed that windows are working in ghost mode, which means window doesn't need interaction. Some backends, like console, will automatically close windows after displaying it, so you can wrote simple program similar to ls, which only prints results in console backend and show window in graphical mode.

API modified by Lachu

Lachu — Sun, 04 Oct 2015 07:02:50 -0000

--- v16
+++ v17
@@ -79,6 +79,6 @@
 -------------------
 Callback function will be called, when application exits.

-void tao_display_windows(int countm, \*\* windows)
+void tao_display_windows(int count, \*\* windows)
 -------------------
 Function created for displaying simple windows, like messages. It starts message loop and exits from it, when all given window in windows array are closed. Backend are informed that windows are working in ghost mode, which means window doesn't need interaction. Some backends, like console, will automatically close windows after displaying it, so you can wrote simple program similar to ls, which only prints results in console backend and show window in graphical mode.

API modified by Lachu

Lachu — Sun, 04 Oct 2015 07:02:15 -0000

--- v15
+++ v16
@@ -78,3 +78,7 @@
 void tao_set_exit_callback(int (\*callback)(void\*));
 -------------------
 Callback function will be called, when application exits.
+
+void tao_display_windows(int countm, \*\* windows)
+-------------------
+Function created for displaying simple windows, like messages. It starts message loop and exits from it, when all given window in windows array are closed. Backend are informed that windows are working in ghost mode, which means window doesn't need interaction. Some backends, like console, will automatically close windows after displaying it, so you can wrote simple program similar to ls, which only prints results in console backend and show window in graphical mode.

API modified by Lachu

Lachu — Wed, 22 Jul 2015 17:50:04 -0000

--- v14
+++ v15
@@ -59,11 +59,11 @@
 -------------------
 Set path to application depended window class. If there's no matching path for given path, then window classes from alternative path will been used.

-void tao_change_weight(void *window_, char *epath, int new_weight);
+void tao_change_weight(void \*window_, char \*epath, int new_weight);
 -------------------
 Change importance of elements in given path. While calling this function, libgreattao will recalculate window content.

-void *tao_add_timer(int miliseconds, void (*callback)(void*), void *data);
+void *tao_add_timer(int miliseconds, void (\*callback)(void\*), void \*data);
 -------------------
 Create timer and launch it. Return pointer to special structure contains timer data. Timers are invoked in tao loop.

@@ -71,10 +71,10 @@
 -------------------
 Removes given timer.

-void tao_set_modal(void *parent_, const char *spath, void *child_, char type);
+void tao_set_modal(void \*parent_, const char \*spath, void \*child_, char type);
 -------------------
 Set given child_ as modal window with given parent_.

-void tao_set_exit_callback(int (*callback)(void*));
+void tao_set_exit_callback(int (\*callback)(void\*));
 -------------------
 Callback function will be called, when application exits.

API modified by Lachu

Lachu — Wed, 22 Jul 2015 16:29:29 -0000

--- v13
+++ v14
@@ -74,3 +74,7 @@
 void tao_set_modal(void *parent_, const char *spath, void *child_, char type);
 -------------------
 Set given child_ as modal window with given parent_.
+
+void tao_set_exit_callback(int (*callback)(void*));
+-------------------
+Callback function will be called, when application exits.

API modified by Lachu

Lachu — Wed, 22 Jul 2015 16:17:45 -0000

--- v12
+++ v13
@@ -71,3 +71,6 @@
 -------------------
 Removes given timer.

+void tao_set_modal(void *parent_, const char *spath, void *child_, char type);
+-------------------
+Set given child_ as modal window with given parent_.

API modified by Lachu

Lachu — Wed, 22 Jul 2015 16:15:56 -0000

--- v11
+++ v12
@@ -65,4 +65,9 @@

 void *tao_add_timer(int miliseconds, void (*callback)(void*), void *data);
 -------------------
-Create timer and launch it. Timers are invoked in tao loop.
+Create timer and launch it. Return pointer to special structure contains timer data. Timers are invoked in tao loop.
+
+void tao_remove_timer(void *timer);
+-------------------
+Removes given timer.
+

API modified by Lachu

Lachu — Wed, 22 Jul 2015 16:13:46 -0000

--- v10
+++ v11
@@ -62,3 +62,7 @@
 void tao_change_weight(void *window_, char *epath, int new_weight);
 -------------------
 Change importance of elements in given path. While calling this function, libgreattao will recalculate window content.
+
+void *tao_add_timer(int miliseconds, void (*callback)(void*), void *data);
+-------------------
+Create timer and launch it. Timers are invoked in tao loop.

API modified by Lachu

Lachu — Wed, 22 Jul 2015 16:09:05 -0000

--- v9
+++ v10
@@ -58,3 +58,7 @@
 void tao_set_alternative_design(char *path);
 -------------------
 Set path to application depended window class. If there's no matching path for given path, then window classes from alternative path will been used.
+
+void tao_change_weight(void *window_, char *epath, int new_weight);
+-------------------
+Change importance of elements in given path. While calling this function, libgreattao will recalculate window content.