text: Document and annotate :font-name for NULL values

Update the documentation of :font-name, to make it clear that by setting
it to NULL the Text actor will use the default font.

Also, set the annotation for the @font_name argument of the setter to be
allow-none, and allow passing NULL through bindings.
This commit is contained in:
Emmanuele Bassi 2010-06-26 23:05:36 +01:00
parent 809211588d
commit 31fc8e9664

View File

@ -2479,6 +2479,8 @@ clutter_text_class_init (ClutterTextClass *klass)
* The font to be used by the #ClutterText, as a string
* that can be parsed by pango_font_description_from_string().
*
* If set to %NULL, the default system font will be used instead.
*
* Since: 1.0
*/
pspec = g_param_spec_string ("font-name",
@ -3768,7 +3770,7 @@ clutter_text_get_font_name (ClutterText *text)
/**
* clutter_text_set_font_name:
* @self: a #ClutterText
* @font_name: a font name, or %NULL to set the default font name
* @font_name: (allow-none): a font name, or %NULL to set the default font name
*
* Sets the font used by a #ClutterText. The @font_name string
* must either be %NULL, which means that the font name from the