summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--atk/atkplug.c5
-rw-r--r--atk/atksocket.c5
2 files changed, 10 insertions, 0 deletions
diff --git a/atk/atkplug.c b/atk/atkplug.c
index 242e947..9445df3 100644
--- a/atk/atkplug.c
+++ b/atk/atkplug.c
@@ -63,6 +63,11 @@ atk_plug_new (void)
*
* 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 (eg, at-spi2-atk). The implementor of an AtkSocket object
+ * should call this function (after atk-bridge is loaded) and pass the value
+ * to the process implementing the AtkPlug into which the AtkSocket is
+ * embedded.
*
* Returns: the unique ID for the plug
*
diff --git a/atk/atksocket.c b/atk/atksocket.c
index 7886e07..ff31d5d 100644
--- a/atk/atksocket.c
+++ b/atk/atksocket.c
@@ -64,6 +64,11 @@ atk_socket_new (void)
*
* Embeds the children of an #AtkPlug as the children of the #AtkSocket. The
* plug may be in the same process or in a different process.
+ * THe class item used by this function should be filled in by the IPC layer
+ * (ie, at-spi2-atk). The implementor of the AtkSocket should call this
+ * function and pass the id for the plug as returned by atk_plug_get_id.
+ * It is the responsibility of the application to pass the plug id on to
+ * the process implementing the AtkSocket as needed.
*
* Since: 1.30
**/