]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkfontchooser.c
stylecontext: Do invalidation on first resize container
[~andy/gtk] / gtk / gtkfontchooser.c
index ed60f435b048585a6ce895f0bdb2f5e664bf8642..21a5deb234661de771831f89f20e34f1a9c5a6bf 100644 (file)
@@ -15,9 +15,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
  */
 
 #include "config.h"
@@ -77,7 +75,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
   g_object_interface_install_property
      (iface,
       g_param_spec_boxed ("font-desc",
-                          P_("Font"),
+                          P_("Font description"),
                           P_("Font description as a PangoFontDescription struct"),
                           PANGO_TYPE_FONT_DESCRIPTION,
                           GTK_PARAM_READWRITE));
@@ -109,11 +107,11 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
                           GTK_PARAM_READWRITE));
 
   /**
-   * GtkFontChooserWidget::font-activated:
+   * GtkFontChooser::font-activated:
    * @self: the object which received the signal
    * @fontname: the font name
    *
-   * Emitted when a font is activated from the widget's list.
+   * Emitted when a font is activated.
    * This usually happens when the user double clicks an item,
    * or an item is selected and the user presses one of the keys
    * Space, Shift+Space, Return or Enter.
@@ -136,8 +134,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 +157,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