gtk+ r21842 - in trunk: . gtk

[herzi svn gnome org]

Author: herzi
Date: Wed Dec  3 13:15:39 2008
New Revision: 21842
URL: http://svn.gnome.org/viewvc/gtk+?rev=21842&view=rev

Log:
2008-12-03  Sven Herzberg  <sven imendio com>

	Bug 562998 â GtkFontButton documentation improvements

	* gtk/gtkfontbutton.c: mention the way the font string should be used.
	Patch by Sven Herzberg and Nelson Benitez



Modified:
   trunk/ChangeLog
   trunk/gtk/gtkfontbutton.c

Modified: trunk/gtk/gtkfontbutton.c
==============================================================================
--- trunk/gtk/gtkfontbutton.c	(original)
+++ trunk/gtk/gtkfontbutton.c	Wed Dec  3 13:15:39 2008
@@ -628,7 +628,12 @@
  * gtk_font_button_get_font_name:
  * @font_button: a #GtkFontButton
  *
- * Retrieves the name of the currently selected font.
+ * Retrieves the name of the currently selected font. This name includes
+ * style and size information as well. If you want to render something
+ * with the font, use this string with pango_font_description_from_string() .
+ * If you're interested in peeking certain values (family name,
+ * style, size, weight) just query these properties from the
+ * #PangoFontDescription object.
  *
  * Returns: an internal copy of the font name which must not be freed.
  *