From b533fc3ae5b177cabc0227fd3359a38381367405 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <maclas@gmx.de>
Date: Mon, 5 May 2003 18:13:59 +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 37e96bc599..ceb1bf6b7d 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-05-01  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtk-docs.sgml: 
diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 2a0c90aeb1..415d19bb88 100644
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -298,7 +298,6 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
         &GtkDialog;
         &GtkInvisible;
         &GtkMessageDialog;
-        &GtkPlug;
         &GtkWindow;
         &GtkWindowGroup;
     </chapter>
@@ -451,6 +450,7 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
 
     <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.