diff --git a/ChangeLog b/ChangeLog index 39608d8884..7a1ca56d19 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,20 @@ +2002-09-01 Soeren Sandmann + + * 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 * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 39608d8884..7a1ca56d19 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,20 @@ +2002-09-01 Soeren Sandmann + + * 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 * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 39608d8884..7a1ca56d19 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,20 @@ +2002-09-01 Soeren Sandmann + + * 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 * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 39608d8884..7a1ca56d19 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,20 @@ +2002-09-01 Soeren Sandmann + + * 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 * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 39608d8884..7a1ca56d19 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,20 @@ +2002-09-01 Soeren Sandmann + + * 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 * gdk/win32/gdkevents-win32.c (_gdk_events_init): On Cygwin, open diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 39608d8884..7a1ca56d19 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,20 @@ +2002-09-01 Soeren Sandmann + + * 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 * 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 28b9af0a39..381452b71c 100644 --- 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. + + + + + +@cmap: +@Returns: + + 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 a0597cc02e..fe15ff7e09 100644 --- 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: + + + + + +@visual: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkbbox.sgml b/docs/reference/gtk/tmpl/gtkbbox.sgml index ceec7a0916..d48f2ae890 100644 --- a/docs/reference/gtk/tmpl/gtkbbox.sgml +++ b/docs/reference/gtk/tmpl/gtkbbox.sgml @@ -162,6 +162,11 @@ box. + + + + + @@ -177,8 +182,3 @@ box. - - - - - diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml index ecc477c1de..1b60ff31a0 100644 --- a/docs/reference/gtk/tmpl/gtkbutton.sgml +++ b/docs/reference/gtk/tmpl/gtkbutton.sgml @@ -248,6 +248,11 @@ mouse cursor is. + + + + + @@ -258,11 +263,6 @@ mouse cursor is. - - - - - diff --git a/docs/reference/gtk/tmpl/gtkdialog.sgml b/docs/reference/gtk/tmpl/gtkdialog.sgml index 3a5480f415..24dc48ecd3 100644 --- a/docs/reference/gtk/tmpl/gtkdialog.sgml +++ b/docs/reference/gtk/tmpl/gtkdialog.sgml @@ -132,13 +132,13 @@ dialog box. -action_area is a #GtkHBox packed below the +action_area 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. -@action_area: @vbox: +@action_area: diff --git a/docs/reference/gtk/tmpl/gtkhbbox.sgml b/docs/reference/gtk/tmpl/gtkhbbox.sgml index 80da5b50af..a35245aec5 100644 --- a/docs/reference/gtk/tmpl/gtkhbbox.sgml +++ b/docs/reference/gtk/tmpl/gtkhbbox.sgml @@ -2,32 +2,30 @@ GtkHButtonBox -a container for arranging button horizontally. +a container for arranging buttons horizontally 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. -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. +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. + -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(). - - -The default spacing between buttons can be set with -gtk_hbutton_box_set_spacing_default() and queried with -gtk_hbutton_box_get_spacing_default(). - - -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(). @@ -49,11 +47,9 @@ gtk_hbutton_box_get_layout_default(). -button_box is the #GtkHButtonBox widget itself and -should not be modified directly. +GtkHButtonBox does not contain any public fields. - Creates a new horizontal button box. diff --git a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml index 31debc57f8..876a046a5d 100644 --- a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml +++ b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml @@ -100,13 +100,13 @@ selected value for the option menu. - - - - - + + + + + diff --git a/docs/reference/gtk/tmpl/gtkrange.sgml b/docs/reference/gtk/tmpl/gtkrange.sgml index 153dbaaa36..caa4ee4368 100644 --- a/docs/reference/gtk/tmpl/gtkrange.sgml +++ b/docs/reference/gtk/tmpl/gtkrange.sgml @@ -153,6 +153,21 @@ Emitted when the range value changes. + + + + + + + + + + + + + + + @@ -168,18 +183,3 @@ Emitted when the range value changes. - - - - - - - - - - - - - - - diff --git a/docs/reference/gtk/tmpl/gtkscrollbar.sgml b/docs/reference/gtk/tmpl/gtkscrollbar.sgml index e5cbe8e039..330691b466 100644 --- a/docs/reference/gtk/tmpl/gtkscrollbar.sgml +++ b/docs/reference/gtk/tmpl/gtkscrollbar.sgml @@ -54,33 +54,33 @@ The #GtkScrollbar struct does not contain any public data. - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + diff --git a/docs/reference/gtk/tmpl/gtktogglebutton.sgml b/docs/reference/gtk/tmpl/gtktogglebutton.sgml index 11cf051702..03a51e8a0c 100644 --- 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. -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 draw_indicator to %TRUE. -@toggle_button: a #GtkToggleButton. -@draw_indicator: %TRUE or %FALSE. +@toggle_button: +@draw_indicator: diff --git a/docs/reference/gtk/tmpl/gtktoolbar.sgml b/docs/reference/gtk/tmpl/gtktoolbar.sgml index 0e12b5d3c0..9ebf2d6d86 100644 --- 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 - - - - - @@ -411,3 +406,8 @@ Should be used if you wish to perform an action when ever the style of a toolbar + + + + + diff --git a/docs/reference/gtk/tmpl/gtktreeselection.sgml b/docs/reference/gtk/tmpl/gtktreeselection.sgml index a9a050e2c6..efb2dd085d 100644 --- 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. 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. @treeselection: the object which received the signal. diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml index cf97b8fb25..62f5fc3ac3 100644 --- a/docs/reference/gtk/tmpl/gtktreeview.sgml +++ b/docs/reference/gtk/tmpl/gtktreeview.sgml @@ -901,28 +901,28 @@ Function used for #gtk_tree_view_map_expanded_rows. - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + diff --git a/docs/reference/gtk/tmpl/gtkvbbox.sgml b/docs/reference/gtk/tmpl/gtkvbbox.sgml index d8c312d856..977da2ff95 100644 --- a/docs/reference/gtk/tmpl/gtkvbbox.sgml +++ b/docs/reference/gtk/tmpl/gtkvbbox.sgml @@ -2,32 +2,30 @@ GtkVButtonBox -a container for arranging buttons vertically. +a container for arranging buttons vertically 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. -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. +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. + -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(). - - -The default spacing between buttons can be set with -gtk_vbutton_box_set_spacing_default() and queried with -gtk_vbutton_box_get_spacing_default(). - - -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(). @@ -42,17 +40,16 @@ gtk_vbutton_box_get_layout_default(). #GtkHButtonBox -Pack buttons horizontally. +Pack buttons horizontally - +GtkVButtonBox does not contain any public fields. - Creates a new vertical button box. diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml index 750e4493be..ab7a967a57 100644 --- 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. - + - + @@ -2203,22 +2203,7 @@ a widget changes from un-anchored to anchored or vice-versa. - - - - - - - - - - - - - - - - + @@ -2228,7 +2213,12 @@ a widget changes from un-anchored to anchored or vice-versa. - + + + + + + @@ -2238,3 +2228,13 @@ a widget changes from un-anchored to anchored or vice-versa. + + + + + + + + + + diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c index 45fd70c548..58138f8af4 100644 --- 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 907f4a64c0..45aaae9252 100644 --- 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 383b9032fc..7e4ce5ab32 100644 --- 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,