docs/reference/gtk/tmpl/gtkdialog.sgml

2002-09-01  Soeren Sandmann  <ssp@localhost.localdomain>

	* docs/reference/gtk/tmpl/gtkdialog.sgml
	docs/reference/gtk/tmpl/gtkhbbox.sgml
	docs/reference/gtk/tmpl/gtkvbbox.sgml
	docs/reference/gtk/tmpl/gtktogglebutton.sgml
	docs/reference/gtk/tmpl/gtktreeselection.sgml
	gtk/gtktextbuffer.c
	gtk/gtktogglebutton.c
	gtk/gtktreesortable.c

	Minor documentation fixes:

	#79107, #82854, #76398, Vitaly Tishkov;
	#88627, Brian Tarricone;
	#81046, Owen Taylor

diff --git a/ChangeLog b/ChangeLog
index 39608d8884e0d715a2c9d2677ef5894f4e4ebcd3..7a1ca56d19bfd7b64fb3e021f94768925f850766 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,20 @@
+2002-09-01  Soeren Sandmann  <ssp@localhost.localdomain>
+
+       * docs/reference/gtk/tmpl/gtkdialog.sgml
+       docs/reference/gtk/tmpl/gtkhbbox.sgml
+       docs/reference/gtk/tmpl/gtkvbbox.sgml
+       docs/reference/gtk/tmpl/gtktogglebutton.sgml
+       docs/reference/gtk/tmpl/gtktreeselection.sgml
+       gtk/gtktextbuffer.c
+       gtk/gtktogglebutton.c
+       gtk/gtktreesortable.c
+
+       Minor documentation fixes:
+       
+       #79107, #82854, #76398, Vitaly Tishkov; 
+       #88627, Brian Tarricone;
+       #81046, Owen Taylor
+
 2002-08-31  Tor Lillqvist  <tml@iki.fi>
 
        * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 39608d8884e0d715a2c9d2677ef5894f4e4ebcd3..7a1ca56d19bfd7b64fb3e021f94768925f850766 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,20 @@
+2002-09-01  Soeren Sandmann  <ssp@localhost.localdomain>
+
+       * docs/reference/gtk/tmpl/gtkdialog.sgml
+       docs/reference/gtk/tmpl/gtkhbbox.sgml
+       docs/reference/gtk/tmpl/gtkvbbox.sgml
+       docs/reference/gtk/tmpl/gtktogglebutton.sgml
+       docs/reference/gtk/tmpl/gtktreeselection.sgml
+       gtk/gtktextbuffer.c
+       gtk/gtktogglebutton.c
+       gtk/gtktreesortable.c
+
+       Minor documentation fixes:
+       
+       #79107, #82854, #76398, Vitaly Tishkov; 
+       #88627, Brian Tarricone;
+       #81046, Owen Taylor
+
 2002-08-31  Tor Lillqvist  <tml@iki.fi>
 
        * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open

diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2
index 39608d8884e0d715a2c9d2677ef5894f4e4ebcd3..7a1ca56d19bfd7b64fb3e021f94768925f850766 100644 (file)
--- a/ChangeLog.pre-2-2
+++ b/ChangeLog.pre-2-2
@@ -1,3 +1,20 @@
+2002-09-01  Soeren Sandmann  <ssp@localhost.localdomain>
+
+       * docs/reference/gtk/tmpl/gtkdialog.sgml
+       docs/reference/gtk/tmpl/gtkhbbox.sgml
+       docs/reference/gtk/tmpl/gtkvbbox.sgml
+       docs/reference/gtk/tmpl/gtktogglebutton.sgml
+       docs/reference/gtk/tmpl/gtktreeselection.sgml
+       gtk/gtktextbuffer.c
+       gtk/gtktogglebutton.c
+       gtk/gtktreesortable.c
+
+       Minor documentation fixes:
+       
+       #79107, #82854, #76398, Vitaly Tishkov; 
+       #88627, Brian Tarricone;
+       #81046, Owen Taylor
+
 2002-08-31  Tor Lillqvist  <tml@iki.fi>
 
        * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open

diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index 39608d8884e0d715a2c9d2677ef5894f4e4ebcd3..7a1ca56d19bfd7b64fb3e021f94768925f850766 100644 (file)
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,20 @@
+2002-09-01  Soeren Sandmann  <ssp@localhost.localdomain>
+
+       * docs/reference/gtk/tmpl/gtkdialog.sgml
+       docs/reference/gtk/tmpl/gtkhbbox.sgml
+       docs/reference/gtk/tmpl/gtkvbbox.sgml
+       docs/reference/gtk/tmpl/gtktogglebutton.sgml
+       docs/reference/gtk/tmpl/gtktreeselection.sgml
+       gtk/gtktextbuffer.c
+       gtk/gtktogglebutton.c
+       gtk/gtktreesortable.c
+
+       Minor documentation fixes:
+       
+       #79107, #82854, #76398, Vitaly Tishkov; 
+       #88627, Brian Tarricone;
+       #81046, Owen Taylor
+
 2002-08-31  Tor Lillqvist  <tml@iki.fi>
 
        * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open

diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 39608d8884e0d715a2c9d2677ef5894f4e4ebcd3..7a1ca56d19bfd7b64fb3e021f94768925f850766 100644 (file)
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,20 @@
+2002-09-01  Soeren Sandmann  <ssp@localhost.localdomain>
+
+       * docs/reference/gtk/tmpl/gtkdialog.sgml
+       docs/reference/gtk/tmpl/gtkhbbox.sgml
+       docs/reference/gtk/tmpl/gtkvbbox.sgml
+       docs/reference/gtk/tmpl/gtktogglebutton.sgml
+       docs/reference/gtk/tmpl/gtktreeselection.sgml
+       gtk/gtktextbuffer.c
+       gtk/gtktogglebutton.c
+       gtk/gtktreesortable.c
+
+       Minor documentation fixes:
+       
+       #79107, #82854, #76398, Vitaly Tishkov; 
+       #88627, Brian Tarricone;
+       #81046, Owen Taylor
+
 2002-08-31  Tor Lillqvist  <tml@iki.fi>
 
        * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 39608d8884e0d715a2c9d2677ef5894f4e4ebcd3..7a1ca56d19bfd7b64fb3e021f94768925f850766 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,20 @@
+2002-09-01  Soeren Sandmann  <ssp@localhost.localdomain>
+
+       * docs/reference/gtk/tmpl/gtkdialog.sgml
+       docs/reference/gtk/tmpl/gtkhbbox.sgml
+       docs/reference/gtk/tmpl/gtkvbbox.sgml
+       docs/reference/gtk/tmpl/gtktogglebutton.sgml
+       docs/reference/gtk/tmpl/gtktreeselection.sgml
+       gtk/gtktextbuffer.c
+       gtk/gtktogglebutton.c
+       gtk/gtktreesortable.c
+
+       Minor documentation fixes:
+       
+       #79107, #82854, #76398, Vitaly Tishkov; 
+       #88627, Brian Tarricone;
+       #81046, Owen Taylor
+
 2002-08-31  Tor Lillqvist  <tml@iki.fi>
 
        * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open

diff --git a/docs/reference/gdk/tmpl/colors.sgml b/docs/reference/gdk/tmpl/colors.sgml
index 28b9af0a393ed131eec48de1b87378f6a10540d8..381452b71c214418bfb29118ab925e01e6e529bd 100644 (file)
--- a/docs/reference/gdk/tmpl/colors.sgml
+++ b/docs/reference/gdk/tmpl/colors.sgml
@@ -197,6 +197,15 @@ Returns the visual for which a given colormap was created.
 @Returns: the visual of the colormap.
 
 
+<!-- ##### FUNCTION gdk_colormap_get_screen ##### -->
+<para>
+
+</para>
+
+@cmap: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_colors_store ##### -->
 <para>
 Changes the value of the first @ncolors colors in

diff --git a/docs/reference/gdk/tmpl/visuals.sgml b/docs/reference/gdk/tmpl/visuals.sgml
index a0597cc02ea7ba7f7a85a843678ceac65bf9ddf2..fe15ff7e09738740eb15f177928c24ccbaf5aa6f 100644 (file)
--- a/docs/reference/gdk/tmpl/visuals.sgml
+++ b/docs/reference/gdk/tmpl/visuals.sgml
@@ -248,3 +248,12 @@ Deprecated equivalent of g_object_unref().
 @v: 
 
 
+<!-- ##### FUNCTION gdk_visual_get_screen ##### -->
+<para>
+
+</para>
+
+@visual: 
+@Returns: 
+
+

diff --git a/docs/reference/gtk/tmpl/gtkbbox.sgml b/docs/reference/gtk/tmpl/gtkbbox.sgml
index ceec7a0916bed1d2b8e1da84b71e5065c3d576ab..d48f2ae8904992109d1764985fe159b57d2344c3 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkbbox.sgml
@@ -162,22 +162,22 @@ box.
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-internal-pad-y ##### -->
+<!-- ##### ARG GtkButtonBox:child-min-height ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-internal-pad-x ##### -->
+<!-- ##### ARG GtkButtonBox:child-internal-pad-y ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-min-width ##### -->
+<!-- ##### ARG GtkButtonBox:child-internal-pad-x ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-min-height ##### -->
+<!-- ##### ARG GtkButtonBox:child-min-width ##### -->
 <para>
 
 </para>

diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml
index ecc477c1deafae2a026562f2e253e573eecb1ae1..1b60ff31a06dae289fa0ae3e76e06f46ff44d058 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkbutton.sgml
@@ -248,17 +248,17 @@ mouse cursor is.
 
 </para>
 
-<!-- ##### ARG GtkButton:child-displacement-y ##### -->
+<!-- ##### ARG GtkButton:default-border ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButton:child-displacement-x ##### -->
+<!-- ##### ARG GtkButton:child-displacement-y ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButton:default-border ##### -->
+<!-- ##### ARG GtkButton:child-displacement-x ##### -->
 <para>
 
 </para>

diff --git a/docs/reference/gtk/tmpl/gtkdialog.sgml b/docs/reference/gtk/tmpl/gtkdialog.sgml
index 3a5480f415f5916deb05a5802fee13c1d1219bf5..24dc48ecd3898f5ed39477460bfa377d605b2b07 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkdialog.sgml
@@ -132,13 +132,13 @@ dialog box.
 </para>
 <para>
 
-<structfield>action_area</structfield> is a #GtkHBox packed below the
+<structfield>action_area</structfield> is a #GtkHButtonBox packed below the
 dividing #GtkHSeparator in the dialog. It is treated exactly the same
-as any other #GtkHBox.
+as any other #GtkHButtonBox.
 </para>
 
-@action_area: 
 @vbox: 
+@action_area: 
 
 <!-- ##### ENUM GtkDialogFlags ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkhbbox.sgml b/docs/reference/gtk/tmpl/gtkhbbox.sgml
index 80da5b50af53740f4db08fec97fd86eac107bdd1..a35245aec57d85057b2596f9c025ba405fafbaa8 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkhbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkhbbox.sgml
@@ -2,32 +2,30 @@
 GtkHButtonBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a container for arranging button horizontally.
+a container for arranging buttons horizontally
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 A button box should be used to provide a consistent layout of buttons
-throughout your application. There is one default layout and a default
-spacing value that are persistant across all #GtkHButtonBox widgets.
+throughout your application. The layout/spacing can be altered by the
+programmer, or if desired, by the user to alter the 'feel' of a
+program to a small degree.
 </para>
 <para>
-The layout/spacing can then be altered by the programmer, or if desired, by
-the user to alter the 'feel' of a program to a small degree.
-</para>
-<para>
-A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are packed into
-a button box the same way as any other box, using gtk_box_pack_start() or
-gtk_box_pack_end().
-</para>
-<para>
-The default spacing between buttons can be set with
-gtk_hbutton_box_set_spacing_default() and queried with
-gtk_hbutton_box_get_spacing_default().
+A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are
+packed into a button box the same way widgets are added to any other
+container, using gtk_container_add(). You can also use
+gtk_box_pack_start() or gtk_box_pack_end(), but for button boxes both
+these functions work just like gtk_container_add(), ie., they pack the
+button in a way that depends on the current layout style and on
+whether the button has had gtk_button_box_set_child_secondary() called
+on it.
 </para>
+
 <para>
-The arrangement and layout of the buttons can be changed using
-gtk_hbutton_box_set_layout_default() and queried with
-gtk_hbutton_box_get_layout_default().
+The spacing between buttons can be set with gtk_box_set_spacing(). The
+arrangement and layout of the buttons can be changed with
+gtk_button_box_set_layout().
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -49,11 +47,9 @@ gtk_hbutton_box_get_layout_default().
 
 <!-- ##### STRUCT GtkHButtonBox ##### -->
 <para>
-<structfield>button_box</structfield> is the #GtkHButtonBox widget itself and
-should not be modified directly.
+GtkHButtonBox does not contain any public fields.
 </para>
 
-
 <!-- ##### FUNCTION gtk_hbutton_box_new ##### -->
 <para>
 Creates a new horizontal button box.

diff --git a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
index 31debc57f83ac7dc9e013263c3a9c1b3a61fea7b..876a046a5d08d5130023c2f4298d3111263a7037 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
@@ -100,12 +100,12 @@ selected value for the option menu.
 
 </para>
 
-<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
+<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
+<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
 <para>
 
 </para>

diff --git a/docs/reference/gtk/tmpl/gtkrange.sgml b/docs/reference/gtk/tmpl/gtkrange.sgml
index 153dbaaa36a0f133fd714da1dc6f1ab56440a695..caa4ee43682d024be2e2f13fd8e2dbf5abca862b 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkrange.sgml
+++ b/docs/reference/gtk/tmpl/gtkrange.sgml
@@ -153,32 +153,32 @@ Emitted when the range value changes.
 
 </para>
 
-<!-- ##### ARG GtkRange:slider-width ##### -->
+<!-- ##### ARG GtkRange:stepper-size ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:arrow-displacement-y ##### -->
+<!-- ##### ARG GtkRange:trough-border ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
+<!-- ##### ARG GtkRange:stepper-spacing ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:stepper-spacing ##### -->
+<!-- ##### ARG GtkRange:slider-width ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:trough-border ##### -->
+<!-- ##### ARG GtkRange:arrow-displacement-y ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:stepper-size ##### -->
+<!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
 <para>
 
 </para>

diff --git a/docs/reference/gtk/tmpl/gtkscrollbar.sgml b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
index e5cbe8e03905b9befe4d600bb0adc9129ce94381..330691b46684ee561789dfc5e27ce836ac606e03 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkscrollbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
@@ -54,32 +54,32 @@ The #GtkScrollbar struct does not contain any public data.
 </para>
 
 
-<!-- ##### ARG GtkScrollbar:has-secondary-backward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:has-forward-stepper ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:has-secondary-forward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:has-secondary-backward-stepper ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:fixed-slider-length ##### -->
+<!-- ##### ARG GtkScrollbar:has-backward-stepper ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:min-slider-length ##### -->
+<!-- ##### ARG GtkScrollbar:has-secondary-forward-stepper ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:has-forward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:min-slider-length ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:has-backward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:fixed-slider-length ##### -->
 <para>
 
 </para>

diff --git a/docs/reference/gtk/tmpl/gtktogglebutton.sgml b/docs/reference/gtk/tmpl/gtktogglebutton.sgml
index 11cf051702495012fe7549d7d55bfbfec14ed0c5..03a51e8a0c78e58cfe5d2b9b71f76e3d19e63a47 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktogglebutton.sgml
+++ b/docs/reference/gtk/tmpl/gtktogglebutton.sgml
@@ -107,11 +107,10 @@ Creates a new toggle button with a text label.
 
 <!-- ##### FUNCTION gtk_toggle_button_set_mode ##### -->
 <para>
-Determines whether or not the toggle button is drawn on screen. The default mode is %FALSE, which results in the button being displayed. To make the button invisible, set <structfield>draw_indicator</structfield> to %TRUE.
 </para>
 
-@toggle_button: a #GtkToggleButton.
-@draw_indicator: %TRUE or %FALSE.
+@toggle_button: 
+@draw_indicator: 
 
 
 <!-- ##### FUNCTION gtk_toggle_button_get_mode ##### -->

diff --git a/docs/reference/gtk/tmpl/gtktoolbar.sgml b/docs/reference/gtk/tmpl/gtktoolbar.sgml
index 0e12b5d3c076e94f66bb24ee430bd86b34ad289a..9ebf2d6d86dee78426ebceb9f971dd573f225b66 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktoolbar.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolbar.sgml
@@ -386,11 +386,6 @@ Should be used if you wish to perform an action when ever the style of a toolbar
 
 </para>
 
-<!-- ##### ARG GtkToolbar:space-size ##### -->
-<para>
-
-</para>
-
 <!-- ##### ARG GtkToolbar:shadow-type ##### -->
 <para>
 
@@ -411,3 +406,8 @@ Should be used if you wish to perform an action when ever the style of a toolbar
 
 </para>
 
+<!-- ##### ARG GtkToolbar:space-size ##### -->
+<para>
+
+</para>
+

diff --git a/docs/reference/gtk/tmpl/gtktreeselection.sgml b/docs/reference/gtk/tmpl/gtktreeselection.sgml
index a9a050e2c61d789254f8db7ec4defb678104eaa5..efb2dd085d978f3008523da32a3e0b1484e90137 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreeselection.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeselection.sgml
@@ -227,7 +227,9 @@ selected rows.  It will be called on every selected row in the view.
 <!-- ##### SIGNAL GtkTreeSelection::changed ##### -->
 <para>
 Emitted whenever the selection has (possibly) changed.  Please note that
-this signal is 
+this signal is mostly a hint.  It may only be emitted once when a range
+of rows are selected, and it may occasionally be emitted when nothing
+has happened.
 </para>
 
 @treeselection: the object which received the signal.

diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index cf97b8fb2543095703050d7ab43204639413dca7..62f5fc3ac31db024319e0c72ddc1eda56f770aac 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -901,27 +901,27 @@ Function used for #gtk_tree_view_map_expanded_rows.
 
 </para>
 
-<!-- ##### ARG GtkTreeView:vertical-separator ##### -->
+<!-- ##### ARG GtkTreeView:horizontal-separator ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkTreeView:expander-size ##### -->
+<!-- ##### ARG GtkTreeView:indent-expanders ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkTreeView:horizontal-separator ##### -->
+<!-- ##### ARG GtkTreeView:allow-rules ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkTreeView:allow-rules ##### -->
+<!-- ##### ARG GtkTreeView:expander-size ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkTreeView:indent-expanders ##### -->
+<!-- ##### ARG GtkTreeView:vertical-separator ##### -->
 <para>
 
 </para>

diff --git a/docs/reference/gtk/tmpl/gtkvbbox.sgml b/docs/reference/gtk/tmpl/gtkvbbox.sgml
index d8c312d856614c604f0d737300da86c9a8a61a6f..977da2ff95905dfd37c3c47bb717d68b7fec8cc4 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkvbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkvbbox.sgml
@@ -2,32 +2,30 @@
 GtkVButtonBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a container for arranging buttons vertically.
+a container for arranging buttons vertically
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 A button box should be used to provide a consistent layout of buttons
-throughout your application. There is one default layout and a default
-spacing value that are persistant across all #GtkVButtonBox widgets.
+throughout your application. The layout/spacing can be altered by the
+programmer, or if desired, by the user to alter the 'feel' of a
+program to a small degree.
 </para>
 <para>
-The layout/spacing can then be altered by the programmer, or if desired, by
-the user to alter the 'feel' of a program to a small degree.
-</para>
-<para>
-A #GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons are packed into
-a button box the same way as any other box, using gtk_box_pack_start() or
-gtk_box_pack_end().
-</para>
-<para>
-The default spacing between buttons can be set with
-gtk_vbutton_box_set_spacing_default() and queried with
-gtk_vbutton_box_get_spacing_default().
+A #GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons are
+packed into a button box the same way widgets are added to any other
+container, using gtk_container_add(). You can also use
+gtk_box_pack_start() or gtk_box_pack_end(), but for button boxes both
+these functions work just like gtk_container_add(), ie., they pack the
+button in a way that depends on the current layout style and on
+whether the button has had gtk_button_box_set_child_secondary() called
+on it.
 </para>
+
 <para>
-The arrangement and layout of the buttons can be changed using
-gtk_vbutton_box_set_layout_default() and queried with
-gtk_vbutton_box_get_layout_default().
+The spacing between buttons can be set with gtk_box_set_spacing(). The
+arrangement and layout of the buttons can be changed with
+gtk_button_box_set_layout().
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -42,17 +40,16 @@ gtk_vbutton_box_get_layout_default().
 </varlistentry>
 <varlistentry>
 <term>#GtkHButtonBox</term>
-<listitem><para>Pack buttons horizontally.</para></listitem>
+<listitem><para>Pack buttons horizontally</para></listitem>
 </varlistentry>
 </variablelist>
 </para>
 
 <!-- ##### STRUCT GtkVButtonBox ##### -->
 <para>
-
+GtkVButtonBox does not contain any public fields.
 </para>
 
-
 <!-- ##### FUNCTION gtk_vbutton_box_new ##### -->
 <para>
 Creates a new vertical button box.

diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml
index 750e4493be7ebcddd572500c0eb0b19ba08671d8..ab7a967a577082374bbad2cf7070cc23e8878190 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkwidget.sgml
+++ b/docs/reference/gtk/tmpl/gtkwidget.sgml
@@ -2158,12 +2158,12 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 </para>
 
-<!-- ##### ARG GtkWidget:has-focus ##### -->
+<!-- ##### ARG GtkWidget:is-focus ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:is-focus ##### -->
+<!-- ##### ARG GtkWidget:has-focus ##### -->
 <para>
 
 </para>
@@ -2203,12 +2203,12 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 </para>
 
-<!-- ##### ARG GtkWidget:interior-focus ##### -->
+<!-- ##### ARG GtkWidget:focus-padding ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
+<!-- ##### ARG GtkWidget:cursor-color ##### -->
 <para>
 
 </para>
@@ -2218,22 +2218,22 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 </para>
 
-<!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
+<!-- ##### ARG GtkWidget:interior-focus ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:cursor-color ##### -->
+<!-- ##### ARG GtkWidget:focus-line-width ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:focus-padding ##### -->
+<!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:focus-line-width ##### -->
+<!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
 <para>
 
 </para>

diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index 45fd70c54820b7c2e3da42a92187cb51f280ebd3..58138f8af400d2ba77849e868e99ebffdd9f718a 100644 (file)
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -2412,11 +2412,12 @@ gtk_text_buffer_get_iter_at_line    (GtkTextBuffer      *buffer,
  * gtk_text_buffer_get_iter_at_offset:
  * @buffer: a #GtkTextBuffer 
  * @iter: iterator to initialize
- * @char_offset: char offset from start of buffer, counting from 0
+ * @char_offset: char offset from start of buffer, counting from 0, or -1
  *
  * Initializes @iter to a position @char_offset chars from the start
- * of the entire buffer.
- * 
+ * of the entire buffer. If @char_offset is -1 or greater than the number
+ * of characters in the buffer, @iter is initialized to the end iterator,
+ * the iterator one past the last valid character in the buffer.
  **/
 void
 gtk_text_buffer_get_iter_at_offset         (GtkTextBuffer      *buffer,
@@ -2437,7 +2438,6 @@ gtk_text_buffer_get_iter_at_offset         (GtkTextBuffer      *buffer,
  * Initialized @iter with the first position in the text buffer. This
  * is the same as using gtk_text_buffer_get_iter_at_offset() to get
  * the iter at character offset 0.
- * 
  **/
 void
 gtk_text_buffer_get_start_iter (GtkTextBuffer *buffer,

diff --git a/gtk/gtktogglebutton.c b/gtk/gtktogglebutton.c
index 907f4a64c09d20bf88722f13e03e9e691f0d2c29..45aaae9252cce87a6da806ce54b666f01818c1f3 100644 (file)
--- a/gtk/gtktogglebutton.c
+++ b/gtk/gtktogglebutton.c
@@ -250,6 +250,20 @@ gtk_toggle_button_get_property (GObject      *object,
     }
 }
 
+/**
+ * gtk_toggle_button_set_mode:
+ * @toggle_button: a #GtkToggleButton
+ * @draw_indicator: if %TRUE, draw the button as a separate indicator
+ * and label; if %FALSE, draw the button like a normal button
+ *
+ * Sets whether the button is displayed as a separate indicator and label.
+ * You can call this function on a checkbutton or a radiobutton with
+ * @draw_indicator = %FALSE to make the button look like a normal button
+ *
+ * This function only effects instances of classes like #GtkCheckButton
+ * and #GtkRadioButton that derive from #GtkToggleButton,
+ * not instances of #GtkToggleButton itself.
+ */
 void
 gtk_toggle_button_set_mode (GtkToggleButton *toggle_button,
                            gboolean         draw_indicator)

diff --git a/gtk/gtktreesortable.c b/gtk/gtktreesortable.c
index 383b9032fc032c647b316bf68d2159fce5f3eccf..7e4ce5ab322bea953559abf7dae328db2dd4bba0 100644 (file)
--- a/gtk/gtktreesortable.c
+++ b/gtk/gtktreesortable.c
@@ -151,7 +151,7 @@ gtk_tree_sortable_set_sort_column_id (GtkTreeSortable  *sortable,
  * 
  * Sets the comparison function used when sorting to be @sort_func.  If the
  * current sort column id of @sortable is the same as @sort_column_id, then the
- * model will sort.
+ * model will sort using this function.
  **/
 void
 gtk_tree_sortable_set_sort_func (GtkTreeSortable        *sortable,
@@ -182,9 +182,12 @@ gtk_tree_sortable_set_sort_func (GtkTreeSortable        *sortable,
  * 
  * Sets the default comparison function used when sorting to be @sort_func.  If
  * the current sort column id of @sortable is
- * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort.  If
- * @sort_func is %NULL, then the default sort_func, and there will be no default
- * sort_func.  In this case, the model is unsorted.
+ * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort using this function.
+ *
+ * If @sort_func is %NULL, then there will be no default comparison function.
+ * This means that once the model  has been sorted, it can't go back to the
+ * default state. In this case, when the current sort column id of @sortable is
+ * GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.
  **/
 void
 gtk_tree_sortable_set_default_sort_func (GtkTreeSortable        *sortable,