Updates

docs/reference/ChangeLog

@@ -1,5 +1,9 @@
-2005-12-19  Matthias Clasen  <mclasen@redhat.com>
+2005-12-20  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/tmpl/gtkcombo.sgml: Small additions
+
+2005-12-19  Matthias Clasen  <mclasen@redhat.com>
+	
 	* gdk-pixbuf/tmpl/module_interface.sgml: 
 	* gdk-pixbuf/gdk-pixbuf-sections.txt: 
 	* gdk-pixbuf/tmpl/animation.sgml: Small additions/fixes.

docs/reference/gdk/tmpl/threads.sgml

@@ -290,10 +290,12 @@ Leaves a critical region begun with gdk_threads_enter().
 <!-- ##### VARIABLE gdk_threads_mutex ##### -->
 <para>
 The #GMutex used to implement the critical region for
-gdk_threads_enter()/gdk_threads_leave(). This variable should not be
+gdk_threads_enter()/gdk_threads_leave(). 
-used directly &mdash; consider it private.
 </para>
 
+@Deprecated: 2.4: This variable should not be used directly 
+  &mdash; consider it private.
+
 
 <!-- ##### FUNCTION gdk_threads_set_lock_functions ##### -->
 <para>

docs/reference/gtk/tmpl/gtkcombo.sgml

@@ -95,7 +95,7 @@ an application.)
 
 @entry: the text entry field.
 @list: the list shown in the drop-down window.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 <!-- ##### ARG GtkCombo:allow-empty ##### -->
 <para>
@@ -128,7 +128,7 @@ Creates a new #GtkCombo.
 </para>
 
 @Returns: a new #GtkCombo.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_combo_set_popdown_strings ##### -->
@@ -139,7 +139,7 @@ Convenience function to set all of the items in the popup list.
 
 @combo: a #GtkCombo.
 @strings: a list of strings, or %NULL to clear the popup list
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_combo_set_value_in_list ##### -->
@@ -155,7 +155,7 @@ If an empty field is acceptable, the @ok_if_empty parameter should be %TRUE.
 @combo: a #GtkCombo.
 @val: %TRUE if the value entered must match one of the values in the list.
 @ok_if_empty: %TRUE if an empty value is considered valid.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_combo_set_use_arrows ##### -->
@@ -167,7 +167,7 @@ the list. This is on by default.
 @combo: a #GtkCombo.
 @val: %TRUE if the arrow keys can be used to step through the items in 
      the list.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_combo_set_use_arrows_always ##### -->
@@ -177,7 +177,7 @@ Obsolete function, does nothing.
 
 @combo: a #GtkCombo.
 @val: unused
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_combo_set_case_sensitive ##### -->
@@ -193,7 +193,7 @@ worried about differences in case.
 
 @combo: a #GtkCombo.
 @val: %TRUE if the text in the list items is case sensitive.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_combo_set_item_string ##### -->
@@ -205,7 +205,7 @@ selected. This is needed if the list item is not a simple label.
 @combo: a #GtkCombo.
 @item: a #GtkItem.
 @item_value: the string to place in the #GtkEntry when @item is selected.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_combo_disable_activate ##### -->
@@ -217,6 +217,6 @@ instead.
 </para>
 
 @combo: a #GtkCombo.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 

docs/reference/gtk/tmpl/gtkcombobox.sgml

@@ -55,6 +55,20 @@ gtk_combo_box_get_active_text().
 
 @combobox: the object which received the signal.
 
+<!-- ##### SIGNAL GtkComboBox::popup-hide ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
+<!-- ##### SIGNAL GtkComboBox::popup-show ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
 <!-- ##### ARG GtkComboBox:active ##### -->
 <para>
 
@@ -90,6 +104,11 @@ gtk_combo_box_get_active_text().
 
 </para>
 
+<!-- ##### ARG GtkComboBox:tearoff-title ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkComboBox:wrap-width ##### -->
 <para>
 
@@ -347,6 +366,24 @@ gtk_combo_box_get_active_text().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_set_title ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@title: 
+
+
+<!-- ##### FUNCTION gtk_combo_box_get_title ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_combo_box_set_focus_on_click ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkfilechooser.sgml

@@ -773,6 +773,7 @@ gtk_widget_destroy (chooser);
 
 @GTK_FILE_CHOOSER_ERROR_NONEXISTENT: Indicates that a file does not exist.
 @GTK_FILE_CHOOSER_ERROR_BAD_FILENAME: Indicates a malformed filename.
+@GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS: 
 
 <!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
 <para>

docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml

@@ -62,6 +62,11 @@ This should not be accessed directly.  Use the accessor functions below.
 
 </para>
 
+<!-- ##### ARG GtkFileChooserButton:focus-on-click ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkFileChooserButton:title ##### -->
 <para>
 
@@ -138,3 +143,21 @@ This should not be accessed directly.  Use the accessor functions below.
 @n_chars: 
 
 
+<!-- ##### FUNCTION gtk_file_chooser_button_get_focus_on_click ##### -->
+<para>
+
+</para>
+
+@button: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_file_chooser_button_set_focus_on_click ##### -->
+<para>
+
+</para>
+
+@button: 
+@focus_on_click: 
+
+

docs/reference/gtk/tmpl/gtkmain.sgml

@@ -492,7 +492,7 @@ point the timeout is destroyed and will not be called again.
 @data: The data to pass to the function.
 @destroy: Function to call when the timeout is destroyed or %NULL.
 @Returns: A unique id for the event source.
-@Deprecated: Use g_timeout_add_full() instead.
+@Deprecated: 2.4: Use g_timeout_add_full() instead.
 
 
 <!-- ##### FUNCTION gtk_timeout_add ##### -->
@@ -507,7 +507,7 @@ point the timeout is destroyed and will not be called again.
 @function: The function to call periodically.
 @data: The data to pass to the function.
 @Returns: A unique id for the event source.
-@Deprecated: Use g_timeout_add() instead.
+@Deprecated: 2.4: Use g_timeout_add() instead.
 
 
 <!-- ##### FUNCTION gtk_timeout_remove ##### -->
@@ -516,7 +516,7 @@ Removes the given timeout destroying all information about it.
 </para>
 
 @timeout_handler_id: The identifier returned when installing the timeout.
-@Deprecated: Use g_source_remove() instead.
+@Deprecated: 2.4: Use g_source_remove() instead.
 
 
 <!-- ##### FUNCTION gtk_idle_add ##### -->
@@ -529,7 +529,7 @@ higher priority are to be processed. The default priority is
 @function: The function to call.
 @data: The information to pass to the function.
 @Returns: a unique handle for this registration.
-@Deprecated: Use g_idle_add() instead.
+@Deprecated: 2.4: Use g_idle_add() instead.
 
 
 <!-- ##### FUNCTION gtk_idle_add_priority ##### -->
@@ -545,7 +545,7 @@ Note that you will interfere with GTK+ if you use a priority above
 @function: The function to call.
 @data: Data to pass to that function.
 @Returns: A unique id for the event source.
-@Deprecated: Use g_idle_add_full() instead.
+@Deprecated: 2.4: Use g_idle_add_full() instead.
 
 
 <!-- ##### FUNCTION gtk_idle_add_full ##### -->
@@ -563,7 +563,7 @@ Note that you will interfere with GTK+ if you use a priority above
 @data: Data to pass to that function.
 @destroy: Function to call when the timeout is destroyed or %NULL.
 @Returns: A unique id for the event source.
-@Deprecated: Use g_idle_add_full() instead.
+@Deprecated: 2.4: Use g_idle_add_full() instead.
 
 
 <!-- ##### FUNCTION gtk_idle_remove ##### -->
@@ -572,7 +572,7 @@ Removes the idle function with the given id.
 </para>
 
 @idle_handler_id: Identifies the idle function to remove.
-@Deprecated: Use g_source_remove() instead.
+@Deprecated: 2.4: Use g_source_remove() instead.
 
 
 <!-- ##### FUNCTION gtk_idle_remove_by_data ##### -->
@@ -581,7 +581,7 @@ Removes the idle function identified by the user data.
 </para>
 
 @data: remove the idle function which was registered with this user data.
-@Deprecated: Use g_idle_remove_by_data() instead.
+@Deprecated: 2.4: Use g_idle_remove_by_data() instead.
 
 
 <!-- ##### FUNCTION gtk_input_add_full ##### -->
@@ -598,7 +598,7 @@ on a file descriptor.
 @destroy: callback function to call with @data when the input
   handler is removed, or %NULL.
 @Returns: A unique id for the event source; to be used with gtk_input_remove().
-@Deprecated: Use g_io_add_watch_full() instead.
+@Deprecated: 2.4: Use g_io_add_watch_full() instead.
 
 
 <!-- ##### FUNCTION gtk_input_remove ##### -->
@@ -607,7 +607,7 @@ Removes the function with the given id.
 </para>
 
 @input_handler_id: Identifies the function to remove.
-@Deprecated: Use g_source_remove() instead.
+@Deprecated: 2.4: Use g_source_remove() instead.
 
 
 <!-- ##### MACRO GTK_PRIORITY_REDRAW ##### -->
@@ -617,9 +617,8 @@ GTK+ to do pending redraws. This priority is lower than %GTK_PRIORITY_RESIZE
 to avoid redrawing a widget just before resizing (and therefore redrawing
 it again).
 </para>
-<note><para>
+
-This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
+@Deprecated: 2.4: This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
-</para></note>
 
 
 
@@ -637,11 +636,10 @@ GTK+ to compute the sizes of widgets. This priority is higher than
 Use this for high priority timeouts. This priority is never used inside
 GTK+ so everything running at this priority will be running before anything
 inside the toolkit.
-<note><para>
-This macro is deprecated. You should use %G_PRIORITY_HIGH instead.
-</para></note>
 </para>
 
+@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_HIGH instead.
+
 
 
 <!-- ##### MACRO GTK_PRIORITY_INTERNAL ##### -->
@@ -654,21 +652,19 @@ This priority is for GTK+ internal stuff. Don't use it in your applications.
 <!-- ##### MACRO GTK_PRIORITY_DEFAULT ##### -->
 <para>
 Default priority for idle functions.
-<note><para>
-This macro is deprecated. You should use %G_PRIORITY_DEFAULT_IDLE instead.
-</para></note>
 </para>
 
+@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_DEFAULT_IDLE instead.
+
 
 
 <!-- ##### MACRO GTK_PRIORITY_LOW ##### -->
 <para>
 Priority for very unimportant background tasks.
-<note><para>
-This macro is deprecated. You should use %G_PRIORITY_LOW instead.
-</para></note>
 </para>
 
+@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_LOW instead.
+
 
 
 <!-- ##### FUNCTION gtk_key_snooper_install ##### -->

docs/reference/gtk/tmpl/gtkmenu.sgml

@@ -129,6 +129,11 @@ should be accessed using the functions below.
 
 </para>
 
+<!-- ##### ARG GtkMenu:horizontal-padding ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkMenu:vertical-offset ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtknotebook.sgml

@@ -99,6 +99,11 @@ Emitted when the user or a function changes the current page.
 
 </para>
 
+<!-- ##### ARG GtkNotebook:reorderable ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkNotebook:scrollable ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkobject.sgml

@@ -134,12 +134,6 @@ Tells about the state of the object.
 
 @GTK_IN_DESTRUCTION: the object is currently being destroyed. This is used 
   internally by GTK+ to prevent reinvokations during destruction.
-@GTK_FLOATING: the object is orphaned.  Objects that take strong hold of an 
-  object may call g_object_ref_sink(), to convert the floating reference into
-  a regular one, if they believe they are nearly primary ownership of the 
-  object.
-GTK_CONNECTED: signals are connected to this object.
-@GTK_RESERVED_1: reserved for future use
 @GTK_RESERVED_2: reserved for future use
 
 <!-- ##### MACRO GTK_OBJECT_FLAGS ##### -->
@@ -163,7 +157,6 @@ See the overview documentation for #GtkObject.
 <!-- ##### ENUM GtkArgFlags ##### -->
 <para>
 Possible flags indicating how an argument should be treated.
-Deprecated in favor of #GParamSpec features.
 </para>
 
 @GTK_ARG_READABLE: the argument is readable. (i.e. can be queried)
@@ -175,6 +168,7 @@ set.  Hence this flag is not allowed with #GTK_ARG_WRITABLE,
 and is redundant with #GTK_ARG_CONSTRUCT.
 @GTK_ARG_CHILD_ARG: an argument type that applies to (and may be different for)
 each child.  Used by #GtkContainer.
+@Deprecated: Use corresponding #GParamSpec features instead
 
 <!-- ##### FUNCTION gtk_object_new ##### -->
 <para>
@@ -201,7 +195,7 @@ the top of the page.
 </para>
 
 @object: the object to sink.
-@Deprecated: Use g_object_ref_sink() instead
+@Deprecated: 2.10: Use g_object_ref_sink() instead
 
 
 <!-- ##### FUNCTION gtk_object_ref ##### -->

docs/reference/gtk/tmpl/gtkoptionmenu.sgml

@@ -38,7 +38,7 @@ The #GtkOptionMenu-struct struct contains private data only, and
 should be accessed using the functions below.
 </para>
 
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 <!-- ##### SIGNAL GtkOptionMenu::changed ##### -->
 <para>
@@ -68,7 +68,7 @@ Creates a new #GtkOptionMenu.
 </para>
 
 @Returns: a new #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_option_menu_get_menu ##### -->
@@ -78,7 +78,7 @@ Returns the #GtkMenu associated with the #GtkOptionMenu.
 
 @option_menu: a #GtkOptionMenu.
 @Returns: the #GtkMenu associated with the #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_option_menu_set_menu ##### -->
@@ -90,7 +90,7 @@ use of tearoff menu items, submenus, and accelerators.
 
 @option_menu: a #GtkOptionMenu.
 @menu: the #GtkMenu to associate with the #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_option_menu_remove_menu ##### -->
@@ -99,7 +99,7 @@ Removes the menu from the option menu.
 </para>
 
 @option_menu: a #GtkOptionMenu.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_option_menu_set_history ##### -->
@@ -110,7 +110,7 @@ selected value for the option menu.
 
 @option_menu: a #GtkOptionMenu.
 @index_: the index of the menu item to select.  Index values are from 0 to n-1.
-@Deprecated: Use #GtkComboBox instead.
+@Deprecated: 2.4: Use #GtkComboBox instead.
 
 
 <!-- ##### FUNCTION gtk_option_menu_get_history ##### -->

docs/reference/gtk/tmpl/gtkrange.sgml

@@ -69,11 +69,21 @@ Emitted when the range value changes.
 
 </para>
 
+<!-- ##### ARG GtkRange:lower-stepper-sensitivity ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkRange:update-policy ##### -->
 <para>
 
 </para>
 
+<!-- ##### ARG GtkRange:upper-stepper-sensitivity ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtksettings.sgml

@@ -23,6 +23,11 @@ Sharing settings between applications
 </para>
 
 
+<!-- ##### ARG GtkSettings:color-hash ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkSettings:gtk-alternative-button-order ##### -->
 <para>
 
@@ -43,6 +48,11 @@ Sharing settings between applications
 
 </para>
 
+<!-- ##### ARG GtkSettings:gtk-color-scheme ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
 <para>
 
@@ -78,6 +88,11 @@ Sharing settings between applications
 
 </para>
 
+<!-- ##### ARG GtkSettings:gtk-enable-animations ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
 <para>
 
@@ -133,6 +148,16 @@ Sharing settings between applications
 
 </para>
 
+<!-- ##### ARG GtkSettings:gtk-show-input-method-menu ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSettings:gtk-show-unicode-menu ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
 <para>
 
@@ -143,6 +168,16 @@ Sharing settings between applications
 
 </para>
 
+<!-- ##### ARG GtkSettings:gtk-timeout-initial ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSettings:gtk-timeout-repeat ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkstatusicon.sgml

@@ -42,6 +42,76 @@ on Win32 doesn't allow to embed arbitrary widgets.
 <!-- ##### SECTION Stability_Level ##### -->
 
 
+<!-- ##### STRUCT GtkStatusIcon ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GtkStatusIcon::activate ##### -->
+<para>
+
+</para>
+
+@statusicon: the object which received the signal.
+
+<!-- ##### SIGNAL GtkStatusIcon::popup-menu ##### -->
+<para>
+
+</para>
+
+@statusicon: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkStatusIcon::size-changed ##### -->
+<para>
+
+</para>
+
+@statusicon: the object which received the signal.
+@arg1: 
+
+<!-- ##### ARG GtkStatusIcon:blinking ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:file ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:icon-name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:pixbuf ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:stock ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:storage-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusIcon:visible ##### -->
+<para>
+
+</para>
+
 <!-- ##### FUNCTION gtk_status_icon_new ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkstyle.sgml

@@ -162,6 +162,17 @@ Deprecated alias for gtk_style_apply_default_background().
 @h: 
 
 
+<!-- ##### FUNCTION gtk_style_lookup_color ##### -->
+<para>
+
+</para>
+
+@style: 
+@color_name: 
+@color: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_style_lookup_icon_set ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtktextbuffer.sgml

@@ -136,6 +136,11 @@ types related to the text widget and how they work together.
 @arg2: 
 @arg3: 
 
+<!-- ##### ARG GtkTextBuffer:has-selection ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkTextBuffer:tag-table ##### -->
 <para>
 
@@ -463,6 +468,15 @@ types related to the text widget and how they work together.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_text_buffer_get_has_selection ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_text_buffer_place_cursor ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtktexttag.sgml

@@ -510,5 +510,6 @@ modified directly.
 </para>
 
 @values: 
+@Returns: 
 
 

docs/reference/gtk/tmpl/gtktoggleaction.sgml

@@ -32,6 +32,11 @@ private members and should not be accessed directly.
 
 @toggleaction: the object which received the signal.
 
+<!-- ##### ARG GtkToggleAction:active ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkToggleAction:draw-as-radio ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtktreeview.sgml

@@ -450,6 +450,15 @@ has some similarity to strcmp() returning 0 for equal strings.
 @tree_view: 
 
 
+<!-- ##### FUNCTION gtk_tree_view_get_headers_clickable ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_tree_view_set_headers_clickable ##### -->
 <para>