[gtksourceview] Doc: purpose of gtk_source_completion_show()

[SÃbastien Wilmet <swilmet src gnome org>]

commit 1c2607be57745e15dc0fe28245942a804df0e55b
Author: SÃbastien Wilmet <swilmet gnome org>
Date:   Sun Feb 10 18:52:13 2013 +0100

    Doc: purpose of gtk_source_completion_show()

 gtksourceview/gtksourcecompletion.c |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)
---
diff --git a/gtksourceview/gtksourcecompletion.c b/gtksourceview/gtksourcecompletion.c
index defab89..f86656e 100644
--- a/gtksourceview/gtksourcecompletion.c
+++ b/gtksourceview/gtksourcecompletion.c
@@ -3251,6 +3251,13 @@ _gtk_source_completion_add_proposals (GtkSourceCompletion         *completion,
  * Starts a new completion with the specified #GtkSourceCompletionContext and
  * a list of potential candidate providers for completion.
  *
+ * It can be convenient for showing a completion on-the-fly, without the need to
+ * add or remove providers to the #GtkSourceCompletion.
+ *
+ * Another solution is to add providers with
+ * gtk_source_completion_add_provider(), and implement
+ * gtk_source_completion_provider_match() for each provider.
+ *
  * Returns: %TRUE if it was possible to the show completion window.
  */
 gboolean