summaryrefslogtreecommitdiff
path: root/gtk/gtkplug.c
diff options
context:
space:
mode:
authorPatrick Bernaud <patrickb@chez.com>2010-03-05 05:34:16 +0100
committerJavier Jardón <jjardon@gnome.org>2010-03-05 05:37:16 +0100
commit7ab2155aef8e2069a9e5680ca2cd68f70eec43fd (patch)
tree9c28f17e28048880c8976e3bda09823f06f11418 /gtk/gtkplug.c
parent3f579a7a936b9b6cbd08aa2331eae932b1a68491 (diff)
downloadgtk+-7ab2155aef8e2069a9e5680ca2cd68f70eec43fd.tar.gz
Move documentation to inline comments: GtkPlug
https://bugzilla.gnome.org/show_bug.cgi?id=611707 Signed-off-by: Javier Jardón <jjardon@gnome.org>
Diffstat (limited to 'gtk/gtkplug.c')
-rw-r--r--gtk/gtkplug.c21
1 files changed, 21 insertions, 0 deletions
diff --git a/gtk/gtkplug.c b/gtk/gtkplug.c
index 95e6224eb3..45352f250f 100644
--- a/gtk/gtkplug.c
+++ b/gtk/gtkplug.c
@@ -36,6 +36,27 @@
#include "gtkalias.h"
+/**
+ * SECTION:gtkplug
+ * @Short_description: Toplevel for embedding into other processes
+ * @Title: GtkPlug
+ * @See_also: #GtkSocket
+ *
+ * Together with #GtkSocket, #GtkPlug provides the ability
+ * to embed widgets from one process into another process
+ * in a fashion that is transparent to the user. One
+ * process creates a #GtkSocket widget and passes the
+ * ID of that widget's window to the other process,
+ * which then creates a #GtkPlug with that window ID.
+ * Any widgets contained in the #GtkPlug then will appear
+ * inside the first application's window.
+ *
+ * <note>
+ * The #GtkPlug and #GtkSocket widgets are currently not available
+ * on all platforms supported by GTK+.
+ * </note>
+ */
+
static void gtk_plug_get_property (GObject *object,
guint prop_id,
GValue *value,