[tepl] LanguageChooser docs: improvements

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

commit 595a8cc0460ea0277abcdb41d1cea083e4bd545d
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Mon Nov 9 12:59:32 2020 +0100

    LanguageChooser docs: improvements

 tepl/tepl-language-chooser-dialog.c | 7 +++++++
 tepl/tepl-language-chooser.c        | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)
---
diff --git a/tepl/tepl-language-chooser-dialog.c b/tepl/tepl-language-chooser-dialog.c
index 67e731b..bf42c48 100644
--- a/tepl/tepl-language-chooser-dialog.c
+++ b/tepl/tepl-language-chooser-dialog.c
@@ -15,6 +15,13 @@
  *
  * #TeplLanguageChooserDialog is a #GtkDialog to choose a #GtkSourceLanguage.
  * #TeplLanguageChooserDialog implements the #TeplLanguageChooser interface.
+ *
+ * The #GtkDialog contains two buttons: Cancel and Select. During the
+ * #GtkDialog::response signal emission, if the user has clicked on the Select
+ * button, then the #TeplLanguageChooser::language-activated signal is emitted.
+ *
+ * You probably want to connect to the #GtkDialog::response signal with the
+ * %G_CONNECT_AFTER flag, to destroy the dialog.
  */
 
 struct _TeplLanguageChooserDialogPrivate
diff --git a/tepl/tepl-language-chooser.c b/tepl/tepl-language-chooser.c
index f999743..9418617 100644
--- a/tepl/tepl-language-chooser.c
+++ b/tepl/tepl-language-chooser.c
@@ -81,7 +81,7 @@ tepl_language_chooser_default_init (TeplLanguageChooserInterface *interface)
  * @chooser: a #TeplLanguageChooser.
  * @language: (nullable): a #GtkSourceLanguage, or %NULL for "Plain Text".
  *
- * Selects @language in the list of available languages.
+ * Selects @language in the list.
  *
  * Since: 5.2
  */