X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=atk%2Fatkplug.c;h=8a7a36218d046b0b210bc9a36cca696de2f64bda;hb=1a153063a4750ad164aea87d4e872a75434ecac9;hp=4ceb11dc04ee1bce32a78454f87d04e0bdb1731b;hpb=86c9c7f27de046049620ab8ebcbfc713d02da38a;p=platform%2Fupstream%2Fatk.git

diff --git a/atk/atkplug.c b/atk/atkplug.c
index 4ceb11d..8a7a362 100644
--- a/atk/atkplug.c
+++ b/atk/atkplug.c
@@ -20,10 +20,23 @@
 #include "atk.h"
 #include "atkplug.h"
 
-G_DEFINE_TYPE (AtkPlug, atk_plug, ATK_TYPE_OBJECT);
+/**
+ * SECTION:atkplug
+ * @Short_description: Toplevel for embedding into other processes
+ * @Title: AtkPlug
+ * @See_also: #AtkPlug
+ *
+ * See #AtkSocket
+ *
+ */
+
+static void atk_component_interface_init (AtkComponentIface *iface);
 
 static void atk_plug_class_init (AtkPlugClass *klass);
 
+G_DEFINE_TYPE_WITH_CODE (AtkPlug, atk_plug, ATK_TYPE_OBJECT,
+                         G_IMPLEMENT_INTERFACE (ATK_TYPE_COMPONENT, atk_component_interface_init))
+
 static void
 atk_plug_init (AtkPlug* obj)
 {
@@ -35,6 +48,11 @@ atk_plug_class_init (AtkPlugClass* klass)
   klass->get_object_id = NULL;
 }
 
+static void
+atk_component_interface_init (AtkComponentIface *iface)
+{
+}
+
 AtkObject*
 atk_plug_new (void)
 {
@@ -50,13 +68,21 @@ atk_plug_new (void)
 }
 
 /**
- * atk_plug_get_plug_id:
+ * atk_plug_get_id:
  * @obj: an #AtkPlug
  *
- * Gets the unique ID of an #AtkPlug object, which can be used to embed inside
- * of an #AtkSocket using atk_socket_embed().
+ * Gets the unique ID of an #AtkPlug object, which can be used to
+ * embed inside of an #AtkSocket using atk_socket_embed().
+ *
+ * Internally, this calls a class function that should be registered
+ * by the IPC layer (usually at-spi2-atk). The implementor of an
+ * #AtkPlug object should call this function (after atk-bridge is
+ * loaded) and pass the value to the process implementing the
+ * #AtkSocket, so it could embed the plug.
  *
  * Returns: the unique ID for the plug
+ *
+ * Since: 1.30
  **/
 gchar*
 atk_plug_get_id (AtkPlug* obj)