2009-01-28 Claudio Saavedra <csaavedra@igalia.com>

* src/hildon-touch-selector.c: Document
	hildon_touch_selector_center_on_selected()

diff --git a/ChangeLog b/ChangeLog
index 0f0ca44..6094250 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2009-01-28  Claudio Saavedra  <csaavedra@igalia.com>
+
+       * src/hildon-touch-selector.c: Document
+       hildon_touch_selector_center_on_selected()
+
 2009-01-28  Alberto Garcia  <agarcia@igalia.com>
 
        * src/hildon-app-menu.c (+hildon_app_menu_show_all)

diff --git a/src/hildon-touch-selector.c b/src/hildon-touch-selector.c
index 02b570f..d002741 100644 (file)
--- a/src/hildon-touch-selector.c
+++ b/src/hildon-touch-selector.c
@@ -1985,6 +1985,18 @@ hildon_touch_selector_get_column (HildonTouchSelector * selector,
 }
 
 
+/**
+ * hildon_touch_selector_center_on_selected:
+ * @selector: a #HildonTouchSelector
+ *
+ * Ensures all the columns in a #HildonTouchSelector show a selected
+ * item. If one of the columns is in
+ * %HILDON_TOUCH_SELECTOR_SELECTION_MODE_MULTIPLE mode, that column
+ * will be scrolled to ensure the selected item that is closest to the
+ * currently visible area is shown.
+ *
+ * Since: 2.2
+ **/
 void
 hildon_touch_selector_center_on_selected         (HildonTouchSelector *selector)
 {