[gtk/matthiasc/for-master: 1/6] docs: Improve gtk_widget_set_font_map docs

[Matthias Clasen <matthiasc src gnome org>]

commit 81793b62d82d06d17f91c05c88f8835cfbff6dc9
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Sep 20 10:58:46 2020 -0400

    docs: Improve gtk_widget_set_font_map docs

 gtk/gtkwidget.c | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index ffd4ef4133..f9d5f079f9 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -6209,8 +6209,12 @@ gtk_widget_set_font_map_recurse (GtkWidget *widget, gpointer user_data)
  * @font_map: (allow-none): a #PangoFontMap, or %NULL to unset any previously
  *     set font map
  *
- * Sets the font map to use for Pango rendering. When not set, the widget
- * will inherit the font map from its parent.
+ * Sets the font map to use for Pango rendering. The font map is the
+ * object that is used to look up fonts. Setting a custom font map
+ * can be useful in special situations, e.g. when you need to add
+ * application-specific fonts to the set of available fonts.
+ *
+ * When not set, the widget will inherit the font map from its parent.
  */
 void
 gtk_widget_set_font_map (GtkWidget    *widget,