Documentation updates

[hildon] / hildon / hildon-seekbar.c

diff --git a/hildon/hildon-seekbar.c b/hildon/hildon-seekbar.c
index 19c8351..cc77140 100644 (file)
--- a/hildon/hildon-seekbar.c
+++ b/hildon/hildon-seekbar.c
@@ -32,6 +32,9 @@
  * stream/the amount currently downloaded).  The position is clamped
  * between zero and the total time, or zero and the fraction in case of
  * a stream.
+ *
+ * #HildonSeekbar has been deprecated since hildon 2.2. Use #GtkScale
+ * instead. See hildon_gtk_hscale_new() and hildon_gtk_vscale_new().
  */
 
 #undef                                          HILDON_DISABLE_DEPRECATED
@@ -325,9 +328,11 @@ hildon_seekbar_new                              (void)
 
 /**
  * hildon_seekbar_get_total_time:
- * @seekbar: pointer to #HildonSeekbar widget
+ * @seekbar: a #HildonSeekbar
  *
- * Returns: total playing time of media in seconds.
+ * Gets the total playing time of the media (in seconds).
+ *
+ * Returns: total playing time.
  */
 gint
 hildon_seekbar_get_total_time                   (HildonSeekbar *seekbar)
@@ -341,7 +346,7 @@ hildon_seekbar_get_total_time                   (HildonSeekbar *seekbar)
 
 /**
  * hildon_seekbar_set_total_time:
- * @seekbar: pointer to #HildonSeekbar widget
+ * @seekbar: a #HildonSeekbar
  * @time: integer greater than zero
  *
  * Set total playing time of media in seconds.