[gtksourceview/wip/docs: 1/3] docs: improve slightly the doc of set_highlight_syntax()

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

commit 2b18e5a8e127e289e33818286299967dc8d93e76
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Sun Jun 19 13:35:42 2016 +0200

    docs: improve slightly the doc of set_highlight_syntax()

 gtksourceview/gtksourcebuffer.c |   15 +++++++++------
 1 files changed, 9 insertions(+), 6 deletions(-)
---
diff --git a/gtksourceview/gtksourcebuffer.c b/gtksourceview/gtksourcebuffer.c
index d802133..4145800 100644
--- a/gtksourceview/gtksourcebuffer.c
+++ b/gtksourceview/gtksourcebuffer.c
@@ -1695,12 +1695,15 @@ gtk_source_buffer_get_highlight_syntax (GtkSourceBuffer *buffer)
  * @buffer: a #GtkSourceBuffer.
  * @highlight: %TRUE to enable syntax highlighting, %FALSE to disable it.
  *
- * Controls whether syntax is highlighted in the buffer. If @highlight
- * is %TRUE, the text will be highlighted according to the syntax
- * patterns specified in the language set with
- * gtk_source_buffer_set_language(). If @highlight is %FALSE, syntax highlighting
- * is disabled and all the GtkTextTag objects that have been added by the
- * syntax highlighting engine are removed from the buffer.
+ * Controls whether syntax is highlighted in the buffer.
+ *
+ * If @highlight is %TRUE, the text will be highlighted according to the syntax
+ * patterns specified in the #GtkSourceLanguage set with
+ * gtk_source_buffer_set_language().
+ *
+ * If @highlight is %FALSE, syntax highlighting is disabled and all the
+ * #GtkTextTag objects that have been added by the syntax highlighting engine
+ * are removed from the buffer.
  */
 void
 gtk_source_buffer_set_highlight_syntax (GtkSourceBuffer *buffer,