[gtk+/treeview-refactor] Mention actions in the libunique migration guide
- From: Tristan Van Berkom <tvb src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+/treeview-refactor] Mention actions in the libunique migration guide
- Date: Tue, 2 Nov 2010 03:01:25 +0000 (UTC)
commit 0c8df06f731cf8dc387065b4b45dd60e4a355860
Author: Matthias Clasen <mclasen redhat com>
Date: Sun Oct 31 22:14:53 2010 -0400
Mention actions in the libunique migration guide
docs/reference/gtk/migrating-GtkApplication.xml | 26 ++++++++++++++--------
1 files changed, 16 insertions(+), 10 deletions(-)
---
diff --git a/docs/reference/gtk/migrating-GtkApplication.xml b/docs/reference/gtk/migrating-GtkApplication.xml
index 0598456..712d521 100644
--- a/docs/reference/gtk/migrating-GtkApplication.xml
+++ b/docs/reference/gtk/migrating-GtkApplication.xml
@@ -106,22 +106,28 @@ main (int argc, char *argv[])
<section><title>Commands and Messages</title>
<para>
libunique lets you send messages with commands to a running
- instance using unique_app_send_message(). GApplication does not
- have a direct equivalent for this feature at this time, but
- some of the predefined libunique commands have equivalents in
- GApplication. Instead of sending the %UNIQUE_ACTIVATE command,
- call g_application_activate(), instead of sending the
+ instance using unique_app_send_message(). The commands can be either
+ predefined or custom. Some of the predefined libunique commands have
+ equivalents in GApplication. Instead of sending the %UNIQUE_ACTIVATE
+ command, call g_application_activate(), instead of sending the
%UNIQUE_OPEN command, call g_application_open(). The
%UNIQUE_NEW and %UNIQUE_CLOSE and user-defined commands don't
have direct replacement at this time.
</para>
<para>
- On the other hand, GApplication supports passing entire
- commandlines to the running instance, which reduces the need
- for user-defined commands. And GDBus makes it very easy to
- implement D-Bus interfaces for communication between
- application instances, see e.g. g_dbus_connection_register_object().
+ As a replacement for custom commands, GApplication implements the
+ #GActionGroup interface and lets you add a group of actions with
+ g_application_set_action_group(). The actions can then be invoked,
+ either by using the D-Bus interface for #GAction directly, or by
+ calling g_action_group_activate_action() from another instance of
+ the GApplication. The #GApplication documentation contains an
+ example for using GApplication with actions.
+ </para>
+
+ <para>
+ For more complex needs, GApplication supports passing entire
+ commandlines to the running instance.
</para>
</section>
</chapter>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]