Bring docs in shape

svn path=/trunk/; revision=17935

ChangeLog

@@ -1,5 +1,6 @@
 2007-05-26  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkscalebutton.c:
 	* gtk/gtkrecentaction.c:
 	* gtk/gtkrange.c:
 	* gtk/gtkprinter.c:

docs/reference/gtk/Makefile.am

@@ -88,7 +88,6 @@ IGNORE_HFILES=				\
 	gtktreeprivate.h		\
 	gtktypebuiltins.h		\
 	gtkxembed.h			\
-	gtkwindow-decorate.h		\
 	gtkwin32embed.h			\
 	gtkwin32embedwidget.h		\
 	xdgmime				\

docs/reference/gtk/gtk-sections.txt

@@ -472,43 +472,6 @@ GTK_BUTTON_GET_CLASS
 gtk_button_get_type
 </SECTION>
 
-<SECTION>
-<FILE>gtkscalebutton</FILE>
-<TITLE>GtkScaleButton</TITLE>
-GtkScaleButton
-gtk_scale_button_new
-gtk_scale_button_set_icons
-gtk_scale_button_get_value
-gtk_scale_button_get_adjustment
-gtk_scale_button_set_adjustment
-<SUBSECTION Standard>
-GTK_TYPE_SCALE_BUTTON
-GTK_SCALE_BUTTON
-GTK_IS_SCALE_BUTTON
-GTK_SCALE_BUTTON_CLASS
-GTK_IS_SCALE_BUTTON_CLASS
-GTK_SCALE_BUTTON_GET_CLASS
-<SUBSECTION Private>
-gtk_scale_button_get_type
-GtkScaleButtonPrivate
-</SECTION>
-
-<SECTION>
-<FILE>gtkvolumebutton</FILE>
-<TITLE>GtkVolumeButton</TITLE>
-GtkVolumeButton
-gtk_volume_button_new
-<SUBSECTION Standard>
-GTK_VOLUME_BUTTON
-GTK_TYPE_VOLUME_BUTTON
-GTK_IS_VOLUME_BUTTON
-GTK_VOLUME_BUTTON_CLASS
-GTK_IS_VOLUME_BUTTON_CLASS
-GTK_VOLUME_BUTTON_GET_CLASS
-<SUBSECTION Private>
-gtk_volume_button_get_type
-</SECTION>
-
 <SECTION>
 <FILE>gtkcalendar</FILE>
 <TITLE>GtkCalendar</TITLE>
@@ -3091,8 +3054,10 @@ gtk_scale_button_get_adjustment
 gtk_scale_button_get_value
 <SUBSECTION Standard>
 GTK_SCALE_BUTTON
-GTK_SCALE_IS_BUTTON
+GTK_IS_SCALE_BUTTON
 GTK_TYPE_SCALE_BUTTON
+GTK_SCALE_BUTTON_CLASS
+GTK_IS_SCALE_BUTTON_CLASS
 GTK_SCALE_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_scale_button_get_type
@@ -3809,8 +3774,6 @@ GTK_TEXT_CHILD_ANCHOR_GET_CLASS
 gtk_text_view_get_type
 gtk_text_child_anchor_get_type
 GtkTextBTree
-GtkTextChildBody
-GtkTextPixbuf
 GtkTextWindow
 GtkTextPendingScroll
 </SECTION>
@@ -4137,11 +4100,6 @@ gtk_tooltip_set_icon
 gtk_tooltip_set_icon_from_stock
 gtk_tooltip_set_custom
 gtk_tooltip_trigger_tooltip_query
-gtk_tooltip_focus_in
-gtk_tooltip_focus_out
-gtk_tooltip_toggle_keyboard_mode
-gtk_tooltip_handle_event
-gtk_tooltip_hide
 <SUBSECTION Standard>
 GTK_TYPE_TOOLTIP
 <SUBSECTION Private>
@@ -4648,8 +4606,6 @@ gtk_tree_view_get_type
 <FILE>gtkcellview</FILE>
 <TITLE>GtkCellView</TITLE>
 GtkCellView
-gtk_cell_view_get_use_fg
-gtk_cell_view_set_use_fg
 gtk_cell_view_new
 gtk_cell_view_new_with_text
 gtk_cell_view_new_with_markup
@@ -4964,6 +4920,8 @@ gtk_volume_button_new
 GTK_VOLUME_BUTTON
 GTK_IS_VOLUME_BUTTON
 GTK_TYPE_VOLUME_BUTTON
+GTK_VOLUME_BUTTON_CLASS
+GTK_IS_VOLUME_BUTTON_CLASS
 GTK_VOLUME_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_volume_button_get_type

gtk/gtkscalebutton.c

@@ -408,16 +408,15 @@ gtk_scale_button_dispose (GObject *object)
 /**
  * gtk_scale_button_new
  * @size: a stock icon size
- * @lower: the minimum value of the scale (usually 0)
+ * @min: the minimum value of the scale (usually 0)
- * @upper: the maximum value of the scale (usually 100)
+ * @max: the maximum value of the scale (usually 100)
- * @step_increment: the stepping of value when a scroll-wheel event,
+ * @step: the stepping of value when a scroll-wheel event,
  *        or up/down arrow event occurs (usually 2)
  * @icons: a %NULL-terminated array of icon names, or %NULL if
- * you want to set the list later with gtk_scale_button_set_icons(). See
+ *         you want to set the list later with gtk_scale_button_set_icons()
- * gtk_scale_button_set_icons() for details.
  *
- * Creates a #GtkScaleButton, with a range between lower and upper, with
+ * Creates a #GtkScaleButton, with a range between @min and @max, with
- * a stepping of step_increment.
+ * a stepping of @step.
  *
  * Return value: a new #GtkScaleButton
  *
@@ -425,9 +424,9 @@ gtk_scale_button_dispose (GObject *object)
  */
 GtkWidget *
 gtk_scale_button_new (GtkIconSize   size,
-		      gdouble       lower,
+		      gdouble       min,
-		      gdouble       upper,
+		      gdouble       max,
-		      gdouble       step_increment,
+		      gdouble       step,
 		      const gchar **icons)
 {
   GtkScaleButton *button;
@@ -439,10 +438,8 @@ gtk_scale_button_new (GtkIconSize   size,
   if (icons != NULL)
     gtk_scale_button_set_icons (button, icons);
 
-  gtk_range_set_range (GTK_RANGE (priv->scale), lower, upper);
+  gtk_range_set_range (GTK_RANGE (priv->scale), min, max);
-  gtk_range_set_increments (GTK_RANGE (priv->scale),
+  gtk_range_set_increments (GTK_RANGE (priv->scale), step, 10 * step);
-			    step_increment,
-			    10 * step_increment);
 
   if (priv->size != size)
     {
@@ -541,6 +538,8 @@ gtk_scale_button_set_icons (GtkScaleButton  *button,
  * Gets the #GtkAdjustment associated with the #GtkScaleButton's scale.
  * See gtk_range_get_adjustment() for details.
  *
+ * Returns: the adjustment associated with the scale
+ *
  * Since: 2.12
  */
 GtkAdjustment*