[gtksourceview] Fix and improve the SearchContext documentation

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

commit 38cdc347d1d26b4656e597bce9da314e0c319f22
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Tue Dec 10 20:38:09 2013 +0100

    Fix and improve the SearchContext documentation
    
    "but at most one search context per buffer can
    highlight its search occurrences"
    
    This limitation has been lifted, and the doc was not updated. Anyway it
    is explained in more details in a next paragraph.

 gtksourceview/gtksourcesearchcontext.c |    8 ++++----
 1 files changed, 4 insertions(+), 4 deletions(-)
---
diff --git a/gtksourceview/gtksourcesearchcontext.c b/gtksourceview/gtksourcesearchcontext.c
index a978a28..e81d72d 100644
--- a/gtksourceview/gtksourcesearchcontext.c
+++ b/gtksourceview/gtksourcesearchcontext.c
@@ -40,10 +40,10 @@
  *
  * A #GtkSourceSearchContext is used for the search and replace in a
  * #GtkSourceBuffer. The search settings are represented by a
- * #GtkSourceSearchSettings object, that can be shared between several
- * #GtkSourceSearchContext<!-- -->s. A buffer can contain several search
- * contexts at the same time, but at most one search context per buffer can
- * highlight its search occurrences.
+ * #GtkSourceSearchSettings object. There can be a many-to-many relationship
+ * between buffers and search settings, with the search contexts in-between: a
+ * search settings object can be shared between several search contexts; and a
+ * buffer can contain several search contexts at the same time.
  *
  * The total number of search occurrences can be retrieved with
  * gtk_source_search_context_get_occurrences_count(). To know the position of a