Move documentation of gtk_ruler_set_range() to source and fix nonsense.

* docs/reference/gtk/tmpl/gtkruler.sgml:
	* gtk/gtkruler.c:
	Move documentation of gtk_ruler_set_range() to source and fix nonsense.


svn path=/trunk/; revision=18599

ChangeLog

@@ -1,3 +1,9 @@
+2007-08-09  Stefan Kost  <ensonic@users.sf.net>
+
+	* docs/reference/gtk/tmpl/gtkruler.sgml:
+	* gtk/gtkruler.c:
+	Move documentation of gtk_ruler_set_range() to source and fix nonsense.
+
 2007-08-08  Mikael Hallendal  <micke@imendio.com>
 
 	* gtk/gtkcombobox.c (gtk_combo_box_class_init): 

docs/reference/gtk/tmpl/gtkruler.sgml

@@ -89,14 +89,13 @@ is GTK_PIXELS.
 
 <!-- ##### FUNCTION gtk_ruler_set_range ##### -->
 <para>
-This sets the range of the ruler using gfloat lower, gfloat upper, gfloat position, and gfloat max_size. 
-</para>
 
-@ruler: the gtkruler
+</para>
-@lower: the lower limit of the ruler
+@ruler:
-@upper: the upper limit of the ruler
+@lower:
-@position: the mark on the ruler
+@upper:
-@max_size: the maximum size of the ruler
+@position:
+@max_size:
 
 
 <!-- ##### FUNCTION gtk_ruler_get_metric ##### -->

gtk/gtkruler.c

@@ -259,6 +259,17 @@ gtk_ruler_get_metric (GtkRuler *ruler)
   return 0;
 }
 
+/**
+ * gtk_ruler_set_range:
+ * @ruler: the gtkruler
+ * @lower: the lower limit of the ruler
+ * @upper: the upper limit of the ruler
+ * @position: the mark on the ruler
+ * @max_size: the maximum size of the ruler used when calculating the space to
+ * leave for the text
+ *
+ * This sets the range of the ruler. 
+ */
 void
 gtk_ruler_set_range (GtkRuler *ruler,
 		     gdouble   lower,