[pygtk] reference: pygtk-gtkentrycompletion.xml: explain how to override default "match-selected" behaviour

[John Stowers <jstowers src gnome org>]

commit 12206c5a8f944b72f5bf306d72eb22122dc29f1c
Author: Dieter Verfaillie <dieterv optionexplicit be>
Date:   Wed Mar 16 15:32:15 2011 +0100

    reference: pygtk-gtkentrycompletion.xml: explain how to override default "match-selected" behaviour (bug 593386)

 docs/reference/pygtk-gtkentrycompletion.xml |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/pygtk-gtkentrycompletion.xml b/docs/reference/pygtk-gtkentrycompletion.xml
index dc08fb2..bf69b6b 100644
--- a/docs/reference/pygtk-gtkentrycompletion.xml
+++ b/docs/reference/pygtk-gtkentrycompletion.xml
@@ -328,6 +328,12 @@
     them clearly from completion strings. When an action is selected, the
     "action-activated" signal is emitted.</para>
 
+    <para>When the user selects a completion, the content of the entry is updated.
+    By default, the content of the entry is replaced by the text column of the model,
+    but this can be overridden by connecting to the "match-selected" signal and
+    updating the entry in the signal handler. Note that you should return
+    <literal>True</literal> from the signal handler to suppress the default behaviour.</para>
+
     <para>A <link
     linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link>
     (e.g. a <link