[maemo-commits] [maemo-commits] r19346 - in projects/haf/trunk/gtk+: . docs/reference/gtk docs/reference/gtk/tmpl gtk

[From: subversion at stage.maemo.org]

Author: berto
Date: 2009-09-11 18:08:08 +0300 (Fri, 11 Sep 2009)
New Revision: 19346

Modified:
   projects/haf/trunk/gtk+/ChangeLog
   projects/haf/trunk/gtk+/docs/reference/gtk/gtk-sections.txt
   projects/haf/trunk/gtk+/docs/reference/gtk/tmpl/gtkwidget.sgml
   projects/haf/trunk/gtk+/gtk/gtkwidget.c
Log:
2009-09-10  Alberto Garcia  <agarcia at igalia.com>

	* docs/reference/gtk/gtk-sections.txt
	* docs/reference/gtk/tmpl/gtkwidget.sgml
	* gtk/gtkwidget.c:
	Documentation updates.

	Fixes: MB#4462 (Hildon API docs: HildonSizeType is not linked or
	documented.)

Modified: projects/haf/trunk/gtk+/ChangeLog
===================================================================
--- projects/haf/trunk/gtk+/ChangeLog	2009-09-11 13:41:42 UTC (rev 19345)
+++ projects/haf/trunk/gtk+/ChangeLog	2009-09-11 15:08:08 UTC (rev 19346)
@@ -1,3 +1,13 @@
+2009-09-10  Alberto Garcia  <agarcia at igalia.com>
+
+	* docs/reference/gtk/gtk-sections.txt
+	* docs/reference/gtk/tmpl/gtkwidget.sgml
+	* gtk/gtkwidget.c:
+	Documentation updates.
+
+	Fixes: MB#4462 (Hildon API docs: HildonSizeType is not linked or
+	documented.)
+
 2009-09-08  Claudio Saavedra  <csaavedra at igalia.com>
 
 	* debian/changelog: Release 2.14.7-1maemo11

Modified: projects/haf/trunk/gtk+/docs/reference/gtk/gtk-sections.txt
===================================================================
--- projects/haf/trunk/gtk+/docs/reference/gtk/gtk-sections.txt	2009-09-11 13:41:42 UTC (rev 19345)
+++ projects/haf/trunk/gtk+/docs/reference/gtk/gtk-sections.txt	2009-09-11 15:08:08 UTC (rev 19346)
@@ -5427,6 +5427,8 @@
 gtk_widget_get_window
 gtk_widget_get_allocation
 <SUBSECTION Hildon>
+HildonSizeType
+hildon_gtk_widget_set_theme_size
 gtk_widget_tap_and_hold_flags_get_type
 gtk_widget_tap_and_hold_menu_position_top
 gtk_widget_tap_and_hold_setup

Modified: projects/haf/trunk/gtk+/docs/reference/gtk/tmpl/gtkwidget.sgml
===================================================================
--- projects/haf/trunk/gtk+/docs/reference/gtk/tmpl/gtkwidget.sgml	2009-09-11 13:41:42 UTC (rev 19345)
+++ projects/haf/trunk/gtk+/docs/reference/gtk/tmpl/gtkwidget.sgml	2009-09-11 15:08:08 UTC (rev 19346)
@@ -2677,6 +2677,31 @@
 @Returns: 
 
 
+<!-- ##### ENUM HildonSizeType ##### -->
+<para>
+Predefined sizes for widgets. Note that these values are flags, not
+macros for actual pixel sizes, so they can only be used in functions
+that expect a #HildonSizeType parameter.
+</para>
+
+ at HILDON_SIZE_AUTO_WIDTH: The widget requests its natural width.
+ at HILDON_SIZE_HALFSCREEN_WIDTH: The widget requests half of the screen width.
+ at HILDON_SIZE_FULLSCREEN_WIDTH: The widget requests the full screen width.
+ at HILDON_SIZE_AUTO_HEIGHT: The widget requests its natural height.
+ at HILDON_SIZE_FINGER_HEIGHT: The widget requests a height suitable for finger use.
+ at HILDON_SIZE_THUMB_HEIGHT: The widget requests a height suitable for thumb use.
+ at HILDON_SIZE_AUTO: Short for HILDON_SIZE_AUTO_WIDTH | HILDON_SIZE_AUTO_HEIGHT
+
+
+<!-- ##### FUNCTION hildon_gtk_widget_set_theme_size ##### -->
+<para>
+
+</para>
+
+ at widget: 
+ at size: 
+
+
 <!-- ##### FUNCTION gtk_widget_tap_and_hold_menu_position_top ##### -->
 <para>
 

Modified: projects/haf/trunk/gtk+/gtk/gtkwidget.c
===================================================================
--- projects/haf/trunk/gtk+/gtk/gtkwidget.c	2009-09-11 13:41:42 UTC (rev 19345)
+++ projects/haf/trunk/gtk+/gtk/gtkwidget.c	2009-09-11 15:08:08 UTC (rev 19346)
@@ -11044,10 +11044,14 @@
 /**
  * hildon_gtk_widget_set_theme_size:
  * @widget: A #GtkWidget
- * @size: Flags indicating the size of the widget
+ * @size: #HildonSizeType flags indicating the size of the widget
  *
- * This function sets the requested size of a widget.
+ * This function sets the requested size of a widget using one of the
+ * predefined sizes.
  *
+ * It also changes the widget name (see gtk_widget_set_name()) so it
+ * can be themed accordingly.
+ *
  * Since: maemo 2.0
  * Stability: Unstable
  **/