Commit f2685563 authored by Matthias Clasen's avatar Matthias Clasen
Browse files

Updates

parent a800cb79
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.
......
......@@ -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
used directly &mdash; consider it private.
gdk_threads_enter()/gdk_threads_leave().
</para>
@Deprecated: 2.4: This variable should not be used directly
&mdash; consider it private.
<!-- ##### FUNCTION gdk_threads_set_lock_functions ##### -->
<para>
......
......@@ -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.
......@@ -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>
......
......@@ -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>
......
......@@ -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:
......@@ -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.
</para></note>
@Deprecated: 2.4: This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
......@@ -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 ##### -->
......
......@@ -129,6 +129,11 @@ should be accessed using the functions below.
</para>
<!-- ##### ARG GtkMenu:horizontal-padding ##### -->
<para>
</para>
<!-- ##### ARG GtkMenu:vertical-offset ##### -->
<para>
......
......@@ -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>
......
......@@ -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 ##### -->
......
......@@ -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 ##### -->
......
......@@ -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>
......
......@@ -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>
......
......@@ -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>
......
......@@ -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>
......
......@@ -136,6 +136,11 @@ types related to the text widget and how they work together.
@arg2:
@arg3:
<!-- ##### ARG GtkTextBuffer:has-selection ##### -->
<para>