[gtk+/font-chooser-api: 15/15] Clarify conditions when get_font_{family, face} return NULL

[Christian Persch <chpe src gnome org>]

commit 8c3cd13a21958596b6d95a05d25cd1f92d1ab6c6
Author: Christian Persch <chpe gnome org>
Date:   Mon Sep 12 01:21:04 2011 +0200

    Clarify conditions when get_font_{family,face} return NULL

 gtk/gtkfontchooser.c |    8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtkfontchooser.c b/gtk/gtkfontchooser.c
index ed60f43..3abfb69 100644
--- a/gtk/gtkfontchooser.c
+++ b/gtk/gtkfontchooser.c
@@ -136,8 +136,10 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
  * Gets the #PangoFontFamily representing the selected font family.
  * Font families are a collection of font faces.
  *
+ * If the selected font is not installed, returns %NULL.
+ *
  * Return value: (transfer none): A #PangoFontFamily representing the
- *     selected font family. The returned object is owned by @fontchooser
+ *     selected font family, or %NULL. The returned object is owned by @fontchooser
  *     and must not be modified or freed.
  *
  * Since: 3.2
@@ -157,8 +159,10 @@ gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser)
  * Gets the #PangoFontFace representing the selected font group
  * details (i.e. family, slant, weight, width, etc).
  *
+ * If the selected font is not installed, returns %NULL.
+ *
  * Return value: (transfer none): A #PangoFontFace representing the
- *     selected font group details. The returned object is owned by
+ *     selected font group details, or %NULL. The returned object is owned by
  *     @fontchooser and must not be modified or freed.
  *
  * Since: 3.2