[gtksourceview] buffer: improve docs of the ::highlight-updated signal

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

commit 9c99ebca3562cfdbf6dc6ed84c61379a7838e8db
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Thu Oct 20 15:17:26 2016 +0200

    buffer: improve docs of the ::highlight-updated signal
    
    https://bugzilla.gnome.org/show_bug.cgi?id=767702

 gtksourceview/gtksourcebuffer.c |    5 ++---
 1 files changed, 2 insertions(+), 3 deletions(-)
---
diff --git a/gtksourceview/gtksourcebuffer.c b/gtksourceview/gtksourcebuffer.c
index a053352..977870a 100644
--- a/gtksourceview/gtksourcebuffer.c
+++ b/gtksourceview/gtksourcebuffer.c
@@ -424,9 +424,8 @@ gtk_source_buffer_class_init (GtkSourceBufferClass *klass)
         * @end: the end of the updated region
         *
         * The ::highlight-updated signal is emitted when the syntax
-        * highlighting is updated in a certain region of the @buffer. This
-        * signal is useful to be notified when a context class region is
-        * updated (e.g. the no-spell-check context class).
+        * highlighting and [context classes][context-classes] are updated in a
+        * certain region of the @buffer.
         */
        buffer_signals[HIGHLIGHT_UPDATED] =
            g_signal_new_class_handler ("highlight-updated",