buffer: improve docs of the ::highlight-updated signal
buffer: improve docs of the ::highlight-updated signal

https://bugzilla.gnome.org/show_bug.cgi?id=767702

uajain/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,uajain/gtksourceview,GNOME/gtksourceview,uajain/gtksourceview,uajain/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,uajain/gtksourceview,uajain/gtksourceview,GNOME/gtksourceview,uajain/gtksourceview,uajain/gtksourceview,uajain/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,GNOME/gtksourceview,uajain/gtksourceview,GNOME/gtksourceview