From c71076d867a30c61164f29e6a9ea6e5f06b9aa8e Mon Sep 17 00:00:00 2001
From: Matthias Clasen <maclas@gmx.de>
Date: Mon, 5 May 2003 18:16:06 +0000
Subject: [PATCH] Improve the docs about cross-process embedding a bit.
 (#112101, #112006)

2003-05-05  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtk-docs.sgml:
	* gtk/tmpl/gtksocket.sgml: Improve the docs about cross-process
	embedding a bit.  (#112101, #112006)
---
 docs/reference/ChangeLog               | 6 ++++++
 docs/reference/gtk/gtk-docs.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtksocket.sgml | 7 +++++--
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 99530e8b12..9bec491770 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2003-05-05  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtk-docs.sgml: 
+	* gtk/tmpl/gtksocket.sgml: Improve the docs about cross-process
+	embedding a bit.  (#112101, #112006)
+
 2003-04-13  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtk-sections.txt: Add gtk_tree_view_column_cell_get_position().
diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 11a0dae728..2321bf37ff 100644
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -294,7 +294,6 @@ that is, GUI components such as #GtkButton or #GtkTextView.
         &GtkDialog;
         &GtkInvisible;
         &GtkMessageDialog;
-        &GtkPlug;
         &GtkWindow;
         &GtkWindowGroup;
     </chapter>
@@ -447,6 +446,7 @@ that is, GUI components such as #GtkButton or #GtkTextView.
 
     <chapter id="PlugSocket">
       <title>Cross-process Embedding</title>
+        &GtkPlug;
         &GtkSocket;
     </chapter>
 
diff --git a/docs/reference/gtk/tmpl/gtksocket.sgml b/docs/reference/gtk/tmpl/gtksocket.sgml
index e870c989a3..7bb277802b 100644
--- a/docs/reference/gtk/tmpl/gtksocket.sgml
+++ b/docs/reference/gtk/tmpl/gtksocket.sgml
@@ -137,7 +137,8 @@ never be set by an application.)
 
 <!-- ##### SIGNAL GtkSocket::plug-added ##### -->
 <para>
-
+This signal is emitted when a client is successfully
+added to the socket.
 </para>
 
 @socket: the object which received the signal.
@@ -146,7 +147,9 @@ never be set by an application.)
 
 <!-- ##### SIGNAL GtkSocket::plug-removed ##### -->
 <para>
-
+This signal is emitted when a client is removed from the socket. The
+default action is to destroy the #GtkSocket widget, so if you want to
+reuse it you must add a signal handler that returns %TRUE.
 </para>
 
 @socket: the object which received the signal.