+<!-- ##### SECTION ./tmpl/gtkarg.sgml:Long_Description ##### -->
+<para>
+All the functions in here are marked a Non-public.
+We describe it anyway because it is occasionally useful
+to understand how the work is done.
+</para>
+<para>
+Arguments are a way of describing a named parameter to a function.
+They have two important roles within gtk+:
+<itemizedlist>
+<listitem>
+<para>
+they describe <wordasword>object properties</wordasword>.
+This means that they present an interface to get and set a named-type
+for any type of object in a consistent way.
+(All the relevant functions to do this start with gtk_object_set
+or gtk_object_get).
+</para>
+</listitem>
+<listitem>
+<para>
+they describe <wordasword>signal arguments</wordasword>.
+This is a lot less often needed but still useful.
+Usually if you are just emitting or creating a particular signal
+it is more convenient to just use gtk_signal_emit() or gtk_signal_new().
+However if you are writing a function to emit or create an arbitrary
+signal, you must use gtk_signal_emitv() or gtk_signal_newv().
+</para>
+</listitem>
+</itemizedlist>
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkarg.sgml:See_Also ##### -->
+<para>
+#GtkObject.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkarg.sgml:Short_Description ##### -->
+Utility function to manipulate lists of named, typed arguments.
+
+
+<!-- ##### SECTION ./tmpl/gtkarg.sgml:Title ##### -->
+Implementation of Object Properties
+
+
+<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Title ##### -->
+GtkCellRendererTextPixbuf
+
+
+<!-- ##### SECTION ./tmpl/gtkdata.sgml:Long_Description ##### -->
+<para>
+The #GtkData object is a very simple object intended to be used as a base
+class for objects which contain data (i.e. the 'Model' in the object-oriented
+Model/View/Controller framework).
+</para>
+<para>
+Currently it is not very useful since all it provides is a "disconnect" signal.
+This signal could be emitted by a #GtkData subclass to notify any 'Views'
+that they should disconnect from the #GtkData (the 'Model'), possibly just
+before the #GtkData is destroyed.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkdata.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkdata.sgml:Short_Description ##### -->
+abstract base class for objects containing data.
+
+
+<!-- ##### SECTION ./tmpl/gtkdata.sgml:Title ##### -->
+GtkData
+
+
<!-- ##### SECTION ./tmpl/gtkdebug.sgml:Title ##### -->
Debugging
gtkenums.sgml
-<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Title ##### -->
-GtkIMContextSimple
-
-
<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Long_Description ##### -->
<refsect2>
<title>What are Signal Marshallers?</title>
Signal Marshallers
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:Title ##### -->
+GtkPacker
+
+
<!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### -->
Private Information
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Title ##### -->
+GtkModelSimple
+
+
<!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### -->
<para>
A macro to check whether a child widget of the CList
@clist: The #GtkCList widget to check.
+<!-- ##### MACRO GTK_ICON_SIZE_BUTTON ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_ICON_SIZE_DIALOG ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_ICON_SIZE_LARGE_TOOLBAR ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_ICON_SIZE_MENU ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_ICON_SIZE_SMALL_TOOLBAR ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_IS_TIPS_QUERY ##### -->
+<para>
+
+</para>
+
+@obj:
+
+<!-- ##### MACRO GTK_IS_TIPS_QUERY_CLASS ##### -->
+<para>
+
+</para>
+
+@klass:
+
+<!-- ##### MACRO GTK_OBJECT_CONNECTED ##### -->
+<para>
+Tests whether a #GtkObject has had a signal connected to it.
+</para>
+
+@obj: the object to examine.
+
<!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### -->
<para>
Test whether a GtkObject's arguments have been prepared.
@obj: the object to examine.
+<!-- ##### MACRO GTK_OBJECT_DESTROYED ##### -->
+<para>
+Test whether a GtkObject has had gtk_object_destroy() invoked on it.
+</para>
+
+@obj: the object to examine.
+
<!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
<para>
Get the number of signals defined by this object.
@obj: the object to query.
+<!-- ##### MACRO GTK_OBJECT_SET_FLAGS ##### -->
+<para>
+Turns on certain object flags. (Private)
+</para>
+
+@obj: the object to affect.
+@flag: the flags to set.
+
<!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
<para>
Get the array of signals defined for this object.
@obj: the object to fetch the signals from.
+<!-- ##### MACRO GTK_OBJECT_UNSET_FLAGS ##### -->
+<para>
+Turns off certain object flags. (Private)
+</para>
+
+@obj: the object to affect.
+@flag: the flags to unset.
+
+<!-- ##### MACRO GTK_STOCK_BUTTON_APPLY ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_STOCK_BUTTON_CANCEL ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_STOCK_BUTTON_CLOSE ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_STOCK_BUTTON_NO ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_STOCK_BUTTON_OK ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_STOCK_BUTTON_YES ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_TIPS_QUERY ##### -->
+<para>
+
+</para>
+
+@obj:
+
+<!-- ##### MACRO GTK_TIPS_QUERY_CLASS ##### -->
+<para>
+
+</para>
+
+@klass:
+
+<!-- ##### MACRO GTK_TIPS_QUERY_GET_CLASS ##### -->
+<para>
+
+</para>
+
+@obj:
+
+<!-- ##### MACRO GTK_TREE_MODEL_GET_IFACE ##### -->
+<para>
+
+</para>
+
+@obj:
+
<!-- ##### MACRO GTK_TREE_SELECTION ##### -->
<para>
A macro that returns a GList that contains the selection of the root tree of @obj.
</para>
+<!-- ##### MACRO GTK_TYPE_TIPS_QUERY ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_TYPE_TREE_COLUMN ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_TYPE_TREE_VIEW_COLUMN ##### -->
+<para>
+
+</para>
+
+
<!-- ##### MACRO GTK_VALUE_ARGS ##### -->
<para>
Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
@a:
-<!-- ##### SIGNAL GtkEditable::activate ##### -->
+<!-- ##### USER_FUNCTION GValueCompareFunc ##### -->
<para>
-Indicates that the user has activated the widget
-in some fashion. Generally, this will be done
-with a keystroke. (The default binding for this
-action is Return for #GtkEntry and
-Control-Return for #GtkText.)
+
</para>
-@editable: the object which received the signal.
+@a:
+@b:
+@Returns:
-<!-- ##### SIGNAL GtkEditable::changed ##### -->
+<!-- ##### STRUCT GtkAccelEntry ##### -->
<para>
-Indicates that the user has changed the contents
-of the widget.
+This is a private struct used by GTK+ internally, don't worry about it.
</para>
-@editable: the object which received the signal.
+@accel_group:
+@accelerator_key:
+@accelerator_mods:
+@accel_flags:
+@object:
+@signal_id:
-<!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
+<!-- ##### ARG GtkAccelLabel:accel-object ##### -->
<para>
-An action signal. Causes the characters in the current selection to
-be copied to the clipboard.
+
</para>
-@editable: the object which received the signal.
-<!-- ##### SIGNAL GtkEditable::cut-clipboard ##### -->
+<!-- ##### ARG GtkAccelLabel:accel-width ##### -->
<para>
-An action signal. Causes the characters in the current
-selection to be copied to the clipboard and then deleted from
-the widget.
+
</para>
-@editable: the object which received the signal.
-<!-- ##### SIGNAL GtkEditable::delete-text ##### -->
+<!-- ##### USER_FUNCTION GtkAccelMapNotify ##### -->
<para>
-This signal is emitted when text is deleted from
-the widget by the user. The default handler for
-this signal will normally be responsible for inserting
-the text, so by connecting to this signal and then
-stopping the signal with gtk_signal_emit_stop(), it
-is possible to modify the inserted text, or prevent
-it from being inserted entirely. The @start_pos
-and @end_pos parameters are interpreted as for
-gtk_editable_delete_text()
+
</para>
-@editable: the object which received the signal.
-@start_pos: the starting position.
-@end_pos: the end position.
+@data:
+@accel_path_quark:
+@accel_key:
+@accel_mods:
+@accel_group:
+@old_accel_key:
+@old_accel_mods:
-<!-- ##### SIGNAL GtkEditable::insert-text ##### -->
+<!-- ##### USER_FUNCTION GtkArgGetFunc ##### -->
<para>
-This signal is emitted when text is inserted into
-the widget by the user. The default handler for
-this signal will normally be responsible for inserting
-the text, so by connecting to this signal and then
-stopping the signal with gtk_signal_emit_stop(), it
-is possible to modify the inserted text, or prevent
-it from being inserted entirely.
+Define a function pointer. Deprecated.
</para>
-@editable: the object which received the signal.
-@new_text: the new text to insert.
-@new_text_length: the length of the new text.
-@position: the position at which to insert the new text.
- this is an in-out paramter. After the signal
- emission is finished, it should point after
- the newly inserted text.
+@object:
+@arg:
+@arg_id:
-<!-- ##### SIGNAL GtkEditable::kill-char ##### -->
+<!-- ##### STRUCT GtkArgInfo ##### -->
<para>
-An action signal. Delete a single character.
+A structure containing information about the argument.
+Returned by gtk_arg_get_info().
</para>
-@editable: the object which received the signal.
-@direction: the direction in which to delete. Positive
- indicates forward deletion, negative, backwards deletion.
+@class_type: if the argument is an object, this is the object class type.
+@name: the name of the argument.
+@type: the type of the argument; it may be an object's type
+or a fundamental type.
+@arg_flags: flags applicable to the argument (i.e. readable, writable,
+and whether it needs to be constructed).
+@full_name: the object name and argument name separated by ::,
+e.g. "GtkObject::user_data" or "GtkButton::label".
+@arg_id: the unique argument identified.
+@seq_id: ???
-<!-- ##### SIGNAL GtkEditable::kill-line ##### -->
+<!-- ##### USER_FUNCTION GtkArgSetFunc ##### -->
<para>
-An action signal. Delete a single line.
+Define a function pointer. Deprecated.
</para>
-@editable: the object which received the signal.
-@direction: the direction in which to delete. Positive
- indicates forward deletion, negative, backwards deletion.
+@object:
+@arg:
+@arg_id:
-<!-- ##### SIGNAL GtkEditable::kill-word ##### -->
+<!-- ##### STRUCT GtkCellRendererTextPixbuf ##### -->
<para>
-An action signal. Delete a single word.
+
</para>
-@editable: the object which received the signal.
-@direction: the direction in which to delete. Positive
- indicates forward deletion, negative, backwards deletion.
+@parent:
-<!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
+<!-- ##### ARG GtkColorSelection:previous-alpha ##### -->
<para>
-An action signal. Move the cursor position.
+
</para>
-@editable: the object which received the signal.
-@x: horizontal distance to move the cursor.
-@y: vertical distance to move the cursor.
-<!-- ##### SIGNAL GtkEditable::move-page ##### -->
+<!-- ##### ARG GtkColorSelection:previous-color ##### -->
<para>
-An action signal. Move the cursor by pages.
+
</para>
-@editable: the object which received the signal.
-@x: Number of pages to move the cursor horizontally.
-@y: Number of pages to move the cursor vertically.
-<!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
+<!-- ##### SIGNAL GtkContainer::focus ##### -->
+<para>
+
+</para>
+
+@container: the object which received the signal.
+@direction:
+@Returns:
+
+<!-- ##### ARG GtkContainer:reallocate-redraws ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT GtkData ##### -->
+<para>
+The #GtkData-struct struct contains no public fields.
+</para>
+
+
+<!-- ##### SIGNAL GtkData::disconnect ##### -->
+<para>
+Emitted to notify any views on the #GtkData object to disconnect from it,
+possibly because the #GtkData object is about to be destroyed.
+</para>
+
+@data: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEditable::activate ##### -->
+<para>
+Indicates that the user has activated the widget
+in some fashion. Generally, this will be done
+with a keystroke. (The default binding for this
+action is Return for #GtkEntry and
+Control-Return for #GtkText.)
+</para>
+
+@editable: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
+<para>
+An action signal. Causes the characters in the current selection to
+be copied to the clipboard.
+</para>
+
+@editable: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEditable::cut-clipboard ##### -->
+<para>
+An action signal. Causes the characters in the current
+selection to be copied to the clipboard and then deleted from
+the widget.
+</para>
+
+@editable: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEditable::kill-char ##### -->
+<para>
+An action signal. Delete a single character.
+</para>
+
+@editable: the object which received the signal.
+@direction: the direction in which to delete. Positive
+ indicates forward deletion, negative, backwards deletion.
+
+<!-- ##### SIGNAL GtkEditable::kill-line ##### -->
+<para>
+An action signal. Delete a single line.
+</para>
+
+@editable: the object which received the signal.
+@direction: the direction in which to delete. Positive
+ indicates forward deletion, negative, backwards deletion.
+
+<!-- ##### SIGNAL GtkEditable::kill-word ##### -->
+<para>
+An action signal. Delete a single word.
+</para>
+
+@editable: the object which received the signal.
+@direction: the direction in which to delete. Positive
+ indicates forward deletion, negative, backwards deletion.
+
+<!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
+<para>
+An action signal. Move the cursor position.
+</para>
+
+@editable: the object which received the signal.
+@x: horizontal distance to move the cursor.
+@y: vertical distance to move the cursor.
+
+<!-- ##### SIGNAL GtkEditable::move-page ##### -->
+<para>
+An action signal. Move the cursor by pages.
+</para>
+
+@editable: the object which received the signal.
+@x: Number of pages to move the cursor horizontally.
+@y: Number of pages to move the cursor vertically.
+
+<!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
<para>
An action signal. Move the cursor to the given column.
</para>
</para>
+<!-- ##### USER_FUNCTION GtkEmissionHook ##### -->
+<para>
+A simple function pointer to get invoked when the
+signal is emitted. This allows you tie a hook to the signal type,
+so that it will trap all emissions of that signal, from any object.
+</para>
+<para>
+You may not attach these to signals created with the
+#GTK_RUN_NO_HOOKS flag.
+</para>
+
+@object:
+@signal_id:
+@n_params:
+@params:
+@data:
+@Returns:
+
+<!-- ##### SIGNAL GtkEntry::changed ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEntry::delete-text ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkEntry::insert-text ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### ARG GtkEntry:text-position ##### -->
+<para>
+
+</para>
+
+
<!-- ##### ENUM GtkFontFilterType ##### -->
<para>
A set of bit flags used to specify the filter being set
@GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
@GTK_FONT_ALL: a bitwise combination of all of the above.
-<!-- ##### STRUCT GtkIMContextSimple ##### -->
+<!-- ##### ARG GtkHScale:adjustment ##### -->
+<para>
+the #GtkAdjustment which sets the range of the scale.
+</para>
+
+
+<!-- ##### ARG GtkHScrollbar:adjustment ##### -->
<para>
</para>
-@object:
-@tables:
-@compose_buffer:
-@tentative_match:
-@tentative_match_len:
+
+<!-- ##### USER_FUNCTION GtkImageLoader ##### -->
+<para>
+A GtkImageLoader is used to load a filename found in
+a RC file.
+</para>
+
+@window: the window for creating image
+@colormap: the colormap for this image
+@mask: a pointer to the location to store the mask
+@transparent_color: the transparent color for the image
+@filename: filename to load
+@Returns: a #GtkPixmap representing @filename
+
+<!-- ##### STRUCT GtkImageMenuItemClass ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkLabel:accel-keyval ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GtkMenuBar::cycle-focus ##### -->
+<para>
+
+</para>
+
+@menubar: the object which received the signal.
+@arg1:
<!-- ##### ARG GtkObject:object-signal ##### -->
<para>
</para>
-<!-- ##### ENUM GtkPrivateFlags ##### -->
+<!-- ##### SIGNAL GtkOldEditable::changed ##### -->
<para>
</para>
-@PRIVATE_GTK_USER_STYLE:
-@PRIVATE_GTK_RESIZE_PENDING:
-@PRIVATE_GTK_RESIZE_NEEDED:
-@PRIVATE_GTK_LEAVE_PENDING:
-@PRIVATE_GTK_HAS_SHAPE_MASK:
-@PRIVATE_GTK_IN_REPARENT:
-@PRIVATE_GTK_DIRECTION_SET:
-@PRIVATE_GTK_DIRECTION_LTR:
+@oldeditable: the object which received the signal.
-<!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
-<para>
-A function which you can use to clean up when the
-signal handler is destroyed.
-</para>
+<!-- ##### SIGNAL GtkOldEditable::delete-text ##### -->
<para>
-For example, if your handler requires a few variables
-that you made into a struct and allocated (using g_new()
-or something), then you will probably want to free
-it as soon as the hook is destroyed. This will
-allow you to do that. (For this in particular
-it is convenient to pass g_free() as a #GtkSignalDestroy
-function).
+
</para>
-@data: The user data associated with the hook that is being
-destroyed.
+@oldeditable: the object which received the signal.
+@arg1:
+@arg2:
-<!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
+<!-- ##### SIGNAL GtkOldEditable::insert-text ##### -->
<para>
-This is currently a hack left in for a scheme wrapper library.
-It may be removed.
+
</para>
+
+@oldeditable: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### STRUCT GtkPacker ##### -->
<para>
-Don't use it.
+
</para>
-@object: The object which emits the signal.
-@data: The user data associated with the hook.
-@nparams: The number of parameters to the function.
-@args: The actual values of the arguments.
-@arg_types: The types of the arguments.
-@return_type: The type of the return value from the function
-or #GTK_TYPE_NONE for no return value.
+@parent:
+@children:
+@spacing:
+@default_border_width:
+@default_pad_x:
+@default_pad_y:
+@default_i_pad_x:
+@default_i_pad_y:
-<!-- ##### STRUCT GtkSignalQuery ##### -->
+<!-- ##### ARG GtkPacker:default-border-width ##### -->
<para>
-This structure contains all the information about a particular
-signal: its name, the type it affects, the signature of the handlers,
-and its unique identifying integer.
+
</para>
-@object_type:
-@signal_id:
-@signal_name:
-@is_user_signal:
-@signal_flags:
-@return_val:
-@nparams:
-@params:
-<!-- ##### STRUCT GtkStatusbarMsg ##### -->
+<!-- ##### ARG GtkPacker:default-ipad-x ##### -->
<para>
-Holds the data for a statusbar message. <structfield>text</structfield> holds the actual text string. <structfield>context_id</structfield> is the context that this message is associated with, and <structfield>message_id</structfield> is this particular message's identifier. However, these fields should not be modified directly.
+
</para>
-@text:
-@context_id:
-@message_id:
-<!-- ##### ARG GtkTextTag:justify ##### -->
+<!-- ##### ARG GtkPacker:default-ipad-y ##### -->
<para>
-A #GtkJustification for the text. This is only used when the tag is
-applied to the first character in a paragraph.
+
</para>
-<!-- ##### ARG GtkTextTag:left-wrapped-line-margin ##### -->
+<!-- ##### ARG GtkPacker:default-pad-x ##### -->
<para>
-Pixel width of the left margin of the text for lines after the first
-line in a wrapped paragraph.
+
</para>
-<!-- ##### ARG GtkTextTag:left-wrapped-line-margin-set ##### -->
+<!-- ##### ARG GtkPacker:default-pad-y ##### -->
<para>
</para>
-<!-- ##### ARG GtkTextTag:offset ##### -->
+<!-- ##### ARG GtkPacker:spacing ##### -->
<para>
-Pixels to offset the text horizontally or vertically, useful to
-produce superscript and subscript.
+
</para>
-<!-- ##### SIGNAL GtkWidget::debug-msg ##### -->
+<!-- ##### STRUCT GtkPackerChild ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@message:
+@widget:
+@anchor:
+@side:
+@options:
+@use_default:
+@border_width:
+@pad_x:
+@pad_y:
+@i_pad_x:
+@i_pad_y:
-<!-- ##### SIGNAL GtkWidget::draw ##### -->
+<!-- ##### ENUM GtkPackerOptions ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@area:
+@GTK_PACK_EXPAND:
+@GTK_FILL_X:
+@GTK_FILL_Y:
-<!-- ##### SIGNAL GtkWidget::draw-default ##### -->
+<!-- ##### STRUCT GtkPatternSpec ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@match_type:
+@pattern_length:
+@pattern:
+@pattern_reversed:
+@user_data:
+@seq_id:
-<!-- ##### SIGNAL GtkWidget::draw-focus ##### -->
+<!-- ##### ENUM GtkPrivateFlags ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@PRIVATE_GTK_USER_STYLE:
+@PRIVATE_GTK_RESIZE_PENDING:
+@PRIVATE_GTK_RESIZE_NEEDED:
+@PRIVATE_GTK_LEAVE_PENDING:
+@PRIVATE_GTK_HAS_SHAPE_MASK:
+@PRIVATE_GTK_IN_REPARENT:
+@PRIVATE_GTK_DIRECTION_SET:
+@PRIVATE_GTK_DIRECTION_LTR:
+
+<!-- ##### STRUCT GtkRcStyleClass ##### -->
+<para>
-<!-- ##### FUNCTION gtk_button_box_child_requisition ##### -->
-<para>\r
-This is an internally used function and should never be called from an\r
-application.\r
</para>
-@widget:
-@nvis_children:
-@width:
-@height:
-<!-- ##### FUNCTION gtk_button_box_get_child_ipadding_default ##### -->
-<para>\r
-The internal padding of a button is the amount of space between the outside\r
-of the button and the widget it contains. This function gets the default\r
-amount of horizontal and vertical padding, placing the results in @ipad_x\r
-and @ipad_y, respectively.\r
+<!-- ##### ARG GtkScrolledWindow:shadow ##### -->
+<para>
+
</para>
-@ipad_x: the default horizontal internal button padding.
-@ipad_y: the default vertical internal button padding.
-<!-- ##### FUNCTION gtk_button_box_get_child_size_default ##### -->
-<para>\r
-Retrieves the default minimum width and height for all button boxes, and\r
-places the values in @min_width and @min_height, respectively.\r
+<!-- ##### ARG GtkSettings:gtk-can-change-accels ##### -->
+<para>
+
</para>
-@min_width: the default minimum width of a child widget.
-@min_height: the default minimum height of a child widget.
-<!-- ##### FUNCTION gtk_button_box_set_child_ipadding_default ##### -->
-<para>\r
-Sets the default number of pixels that pad each button in every button box.\r
+<!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
+<para>
+
</para>
-@ipad_x: new default horizontal padding.
-@ipad_y: new default vertical padding.
-<!-- ##### FUNCTION gtk_button_box_set_child_size_default ##### -->
-<para>\r
-Sets the default size of child buttons.\r
+<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
+<para>
+
</para>
-@min_width: minimum default width for child buttons.
-@min_height: minimum default height for child buttons.
-<!-- ##### FUNCTION gtk_clist_construct ##### -->
+<!-- ##### ARG GtkSettings:gtk-cursor-blink-time ##### -->
<para>
-Initializes a previously allocated #GtkCList widget for use. This should not
-normally be used to create a #GtkCList widget. Use gtk_clist_new() instead.
+
</para>
-@clist: A pointer to an uninitialized #GtkCList widget.
-@columns: The number of columns the #GtkCList should have.
-@titles: An array of strings that should be used as the titles i
-of the columns. There should be enough strings in the array for
-the number of columns specified.
-<!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
+<!-- ##### ARG GtkSettings:gtk-dnd-drag-threshold ##### -->
<para>
-Controls whether opacity can be set with the #GtkColorSelection.
-If this functionality is enabled, the necessary additional widgets
-are added to the #GtkColorSelection and the opacity value can be
-retrieved via the fourth value in the color array returned by
-the gtk_color_selection_get_color() function.
+
</para>
-@colorsel: a #GtkColorSelection.
-@use_opacity: a boolean indicating whether the opacity selection
-is enabled.
-<!-- ##### FUNCTION gtk_ctree_construct ##### -->
+<!-- ##### ARG GtkSettings:gtk-double-click-time ##### -->
<para>
-This function is not usually used by users.
+
</para>
-@ctree:
-@columns:
-@tree_column:
-@titles:
-<!-- ##### FUNCTION gtk_editable_changed ##### -->
+<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
<para>
-Causes the "changed" signal to be emitted.
+
</para>
-@editable: a #GtkEditable widget.
-<!-- ##### FUNCTION gtk_editable_claim_selection ##### -->
+<!-- ##### ARG GtkSettings:gtk-font-name ##### -->
<para>
-Claim or disclaim ownership of the PRIMARY X selection.
+
</para>
-@editable: a #GtkEditable widget.
-@claim: if %TRUE, claim the selection, otherwise, disclaim it.
-@time: the timestamp for claiming the selection.
-<!-- ##### FUNCTION gtk_font_selection_dialog_set_filter ##### -->
+<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
<para>
-Sets one of the two font filters, to limit the fonts shown.
+
</para>
-@fsd: a #GtkFontSelectionDialog.
-@filter_type: which of the two font filters to set, either
-#GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
-can be changed by the user, but the base filter is permanent.
-@font_type: the types of font to be shown. This is a bitwise combination of
-#GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
-or #GTK_FONT_ALL to show all three font types.
-@foundries: a NULL-terminated array of strings containing foundry names which
-will be shown, or NULL to show all foundries.
-@weights: a NULL-terminated array of strings containing weight names which
-will be shown, or NULL to show all weights.
-@slants: a NULL-terminated array of strings containing slant names which
-will be shown, or NULL to show all slants.
-@setwidths: a NULL-terminated array of strings containing setwidth names which
-will be shown, or NULL to show all setwidths.
-@spacings: a NULL-terminated array of strings containing spacings which
-will be shown, or NULL to show all spacings.
-@charsets: a NULL-terminated array of strings containing charset names which
-will be shown, or NULL to show all charsets.
-<!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
+<!-- ##### ARG GtkSettings:gtk-key-theme-name ##### -->
<para>
-Sets one of the two font filters, to limit the fonts shown.
+
</para>
-@fontsel: a #GtkFontSelection.
-@filter_type: which of the two font filters to set, either
-#GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
-can be changed by the user, but the base filter is permanent.
-@font_type: the types of font to be shown. This is a bitwise combination of
-#GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
-or #GTK_FONT_ALL to show all three font types.
-@foundries: a NULL-terminated array of strings containing foundry names which
-will be shown, or NULL to show all foundries.
-@weights: a NULL-terminated array of strings containing weight names which
-will be shown, or NULL to show all weights.
-@slants: a NULL-terminated array of strings containing slant names which
-will be shown, or NULL to show all slants.
-@setwidths: a NULL-terminated array of strings containing setwidth names which
-will be shown, or NULL to show all setwidths.
-@spacings: a NULL-terminated array of strings containing spacings which
-will be shown, or NULL to show all spacings.
-@charsets: a NULL-terminated array of strings containing charset names which
-will be shown, or NULL to show all charsets.
-<!-- ##### FUNCTION gtk_identifier_get_type ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-bar-accel ##### -->
<para>
-Get the type of GtkIdentifier.
+
</para>
-@Returns: GtkType -- the enumerated type of something.
-<!-- ##### FUNCTION gtk_object_arg_get ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-bar-popout-delay ##### -->
<para>
-Private function to get an argument and argument info from an object.
+
</para>
-@object: the object whose argument should be retrieved.
-@arg: the argument, for the name on input, the rest is filled on output.
-@info: a #GtkArgInfo structure to optionally fill in.
-<!-- ##### FUNCTION gtk_object_arg_get_info ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-bar-popup-delay ##### -->
<para>
-Query information about an argument type.
+
</para>
-@object_type: type of object to query about.
-@arg_name: name of the argument.
-@info_p: pointer to be filled in with a pointer to the GtkArgInfo.
-@Returns: an error message, or NULL on success.
-It is the caller's responsibility to call g_free() in the event of error.
-<!-- ##### FUNCTION gtk_object_arg_set ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-popdown-delay ##### -->
<para>
-Private function to set an argument and argument info to an object.
+
</para>
-@object: the object whose argument should be set.
-@arg: the argument.
-@info: infomation about this type of argument in general.
-<!-- ##### FUNCTION gtk_object_args_collect ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-popout-delay ##### -->
<para>
-Private: Gets an array of #GtkArgs from a va_list C structure.
+
</para>
-@object_type: the type of object to collect arguments for.
-@arg_list_p: pointer to be filled in with a list of parsed arguments.
-@info_list_p: optional pointer for a returned list #GtkArgInfos.
-@first_arg_name: name of first argument.
-@var_args: value of first argument, followed by more key/value pairs,
-terminated by NULL.
-@Returns: an error message, or NULL on success.
-It is the caller's responsibility to call g_free() in the event of error.
-<!-- ##### FUNCTION gtk_object_class_add_signals ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-popup-delay ##### -->
<para>
-Add an array of signals to a #GtkObjectClass.
-Usually this is called when registering a new type of object.
+
</para>
-@klass: the object class to append signals to.
-@signals: the signals to append.
-@nsignals: the number of signals being appended.
-<!-- ##### FUNCTION gtk_object_class_user_signal_new ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-submenu-hysteresis ##### -->
<para>
-Define a signal-handler for a new signal on an already defined
-object.
+
</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
<para>
-See the signal documentation for more general information.
+
</para>
-@klass: the object class to define the signal for.
-@name: the name of the signal.
-@signal_flags: the default emission behavior for the signal.
-See gtk_signal_new().
-@marshaller: a function that will take an array of GtkArgs
-and invoke the appropriate handler with the normal calling
-conventions.
-@return_val: specify the return-value type for the signal
-(or GTK_TYPE_NONE for no return-value).
-@nparams: specify the number of parameters the signal
-receives from the caller of gtk_signal_emit().
-@Varargs: list of nparams #GtkTypes to pass to the signal handlers.
-@Returns: the signal id. (See #GtkSignals)
-<!-- ##### FUNCTION gtk_object_class_user_signal_newv ##### -->
+<!-- ##### ARG GtkSettings:gtk-theme-name ##### -->
<para>
-Define a signal-handler for a new signal on an already defined
-object.
+
</para>
-@klass: the object class to define the signal for.
-@name: the name of the signal.
-@signal_flags: the default emission behavior for the signal.
-See gtk_signal_new().
-@marshaller: takes a GtkObject, a #GtkSignalFunc, and an array
-of arguments, and invokes the function using the appropriate
-calling conventions. Usually just select a function
-out of gtkmarshal.h.
-@return_val: specify the return-value type for the signal (possibly
-#GTK_TYPE_NONE).
-@nparams: specify the number of parameters the signal
-receives from the caller of gtk_signal_emit().
-@params: array of #GtkTypes the signal handlers for this signal
-should have in their prototype (of length nparams).
-@Returns: the signal id. (See #GtkSignals)
-<!-- ##### FUNCTION gtk_object_constructed ##### -->
+<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
<para>
-Mark an allocated object as constructed.
-This is used for situations
-that require precise control of the construction process.
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-toolbar-style ##### -->
+<para>
+
</para>
+
+
+<!-- ##### STRUCT GtkSettingsClass ##### -->
<para>
-This is done when gtk_object_default_construct() is inadequate.
-In #GtkCList the need arises because #GtkCList does construction work that
-must happen <emphasis>after</emphasis> its derivers. This work
-cannot be done in an initializer function, so an alternate
-constructor is mandatory. It calls gtk_object_constructed() to
-indicate it has done its job, so that no other constructor will
-be invoked.
+
+</para>
+
+
+<!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
+<para>
+A function which you can use to clean up when the
+signal handler is destroyed.
</para>
<para>
-Normally this function is just automatically run from
-gtk_object_default_construct().
+For example, if your handler requires a few variables
+that you made into a struct and allocated (using g_new()
+or something), then you will probably want to free
+it as soon as the hook is destroyed. This will
+allow you to do that. (For this in particular
+it is convenient to pass g_free() as a #GtkSignalDestroy
+function).
</para>
-@object: object which has been constructed. This is usually
-done automatically by gtk_object_new() and gtk_object_newv().
+@data: The user data associated with the hook that is being
+destroyed.
-<!-- ##### FUNCTION gtk_object_default_construct ##### -->
+<!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
<para>
-This function is called to construct arguments that haven't been initialized
-but have the #GTK_ARG_CONSTRUCT flag set.
+This is currently a hack left in for a scheme wrapper library.
+It may be removed.
</para>
<para>
-All number arguments are set to 0. All pointers and strings
-are set to NULL.
+Don't use it.
+</para>
+
+@object: The object which emits the signal.
+@data: The user data associated with the hook.
+@nparams: The number of parameters to the function.
+@args: The actual values of the arguments.
+@arg_types: The types of the arguments.
+@return_type: The type of the return value from the function
+or #GTK_TYPE_NONE for no return value.
+
+<!-- ##### STRUCT GtkSignalQuery ##### -->
+<para>
+This structure contains all the information about a particular
+signal: its name, the type it affects, the signature of the handlers,
+and its unique identifying integer.
</para>
+
+@object_type:
+@signal_id:
+@signal_name:
+@is_user_signal:
+@signal_flags:
+@return_val:
+@nparams:
+@params:
+
+<!-- ##### STRUCT GtkStatusbarMsg ##### -->
+<para>
+Holds the data for a statusbar message. <structfield>text</structfield> holds the actual text string. <structfield>context_id</structfield> is the context that this message is associated with, and <structfield>message_id</structfield> is this particular message's identifier. However, these fields should not be modified directly.
+</para>
+
+@text:
+@context_id:
+@message_id:
+
+<!-- ##### STRUCT GtkStyleClass ##### -->
+<para>
+
+</para>
+
+@parent_class:
+@realize:
+@unrealize:
+@copy:
+@clone:
+@init_from_rc:
+@set_background:
+@render_icon:
+@draw_hline:
+@draw_vline:
+@draw_shadow:
+@draw_polygon:
+@draw_arrow:
+@draw_diamond:
+@draw_string:
+@draw_box:
+@draw_flat_box:
+@draw_check:
+@draw_option:
+@draw_tab:
+@draw_shadow_gap:
+@draw_box_gap:
+@draw_extension:
+@draw_focus:
+@draw_slider:
+@draw_handle:
+@draw_expander:
+@draw_layout:
+@draw_resize_grip:
+@_gtk_reserved1:
+@_gtk_reserved2:
+@_gtk_reserved3:
+@_gtk_reserved4:
+@_gtk_reserved5:
+@_gtk_reserved6:
+@_gtk_reserved7:
+@_gtk_reserved8:
+@_gtk_reserved9:
+@_gtk_reserved10:
+@_gtk_reserved11:
+@_gtk_reserved12:
+
+<!-- ##### STRUCT GtkTextBTreeNode ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT GtkTextChildAnchorClass ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkTextTag:justify ##### -->
+<para>
+A #GtkJustification for the text. This is only used when the tag is
+applied to the first character in a paragraph.
+</para>
+
+
+<!-- ##### ARG GtkTextTag:left-wrapped-line-margin ##### -->
+<para>
+Pixel width of the left margin of the text for lines after the first
+line in a wrapped paragraph.
+</para>
+
+
+<!-- ##### ARG GtkTextTag:left-wrapped-line-margin-set ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkTextTag:offset ##### -->
+<para>
+Pixels to offset the text horizontally or vertically, useful to
+produce superscript and subscript.
+</para>
+
+
+<!-- ##### ARG GtkTextView:height-lines ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkTextView:justify ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkTextView:width-columns ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkToolButton:show-label-horizontally ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT GtkTreeSelectionClass ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM GtkTreeSelectionMode ##### -->
+<para>
+
+</para>
+
+@GTK_TREE_SELECTION_SINGLE:
+@GTK_TREE_SELECTION_MULTI:
+
+<!-- ##### SIGNAL GtkTreeView::focus-column-header ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+
+<!-- ##### USER_FUNCTION GtkTreeViewDraggableFunc ##### -->
+<para>
+
+</para>
+
+@tree_view:
+@context:
+@path:
+@user_data:
+@Returns:
+
+<!-- ##### USER_FUNCTION GtkTreeViewDroppableFunc ##### -->
+<para>
+
+</para>
+
+@tree_view:
+@context:
+@path:
+@pos:
+@user_data:
+@Returns:
+
+<!-- ##### SIGNAL GtkUIManager::changed ##### -->
+<para>
+
+</para>
+
+@uimanager: the object which received the signal.
+
+<!-- ##### ARG GtkVScale:adjustment ##### -->
+<para>
+the #GtkAdjustment which sets the range of the scale.
+</para>
+
+
+<!-- ##### ARG GtkVScrollbar:adjustment ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GtkWidget::activate-mnemonic ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkWidget::add-accelerator ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@accel_signal_id:
+@accel_group:
+@accel_key:
+@accel_mods:
+@accel_flags:
+
+<!-- ##### SIGNAL GtkWidget::debug-msg ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@message:
+
+<!-- ##### SIGNAL GtkWidget::draw ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@area:
+
+<!-- ##### SIGNAL GtkWidget::draw-default ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+
+<!-- ##### SIGNAL GtkWidget::draw-focus ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+
+<!-- ##### SIGNAL GtkWidget::remove-accelerator ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@accel_group:
+@accel_key:
+@accel_mods:
+
+<!-- ##### ARG GtkWidget:height ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkWidget:width ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkWidget:x ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkWidget:y ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GtkWindow::accels-changed ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+
+<!-- ##### ARG GtkWindow:auto-shrink ##### -->
+<para>
+If the window shrinks automatically when widgets within it shrink.
+</para>
+
+
+<!-- ##### ARG GtkWindow:icon-list ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gtk_accel_group_activate ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@accel_key:
+@accel_mods:
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_group_add ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@path:
+@accel_key:
+@accel_mods:
+@accel_flags:
+@object:
+@accel_signal:
+
+<!-- ##### FUNCTION gtk_accel_group_attach ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@object:
+
+<!-- ##### FUNCTION gtk_accel_group_create_add ##### -->
+<para>
+
+</para>
+
+@class_type:
+@signal_flags:
+@handler_offset:
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_group_create_remove ##### -->
+<para>
+
+</para>
+
+@class_type:
+@signal_flags:
+@handler_offset:
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_group_detach ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@object:
+
+<!-- ##### FUNCTION gtk_accel_group_entries_from_object ##### -->
+<para>
+
+</para>
+
+@object:
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_group_get_default ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_group_get_entry ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@accel_key:
+@accel_mods:
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_group_get_type ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_group_handle_add ##### -->
+<para>
+
+</para>
+
+@object:
+@accel_signal_id:
+@accel_group:
+@accel_key:
+@accel_mods:
+@accel_flags:
+
+<!-- ##### FUNCTION gtk_accel_group_handle_remove ##### -->
+<para>
+
+</para>
+
+@object:
+@accel_group:
+@accel_key:
+@accel_mods:
+
+<!-- ##### FUNCTION gtk_accel_group_lock_entry ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@accel_key:
+@accel_mods:
+
+<!-- ##### FUNCTION gtk_accel_group_remove ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@accel_key:
+@accel_mods:
+@object:
+
+<!-- ##### FUNCTION gtk_accel_group_unlock_entry ##### -->
+<para>
+
+</para>
+
+@accel_group:
+@accel_key:
+@accel_mods:
+
+<!-- ##### FUNCTION gtk_accel_label_get_accel_object ##### -->
+<para>
+
+</para>
+
+@accel_label:
+@Returns:
+
+<!-- ##### FUNCTION gtk_accel_label_set_accel_object ##### -->
+<para>
+
+</para>
+
+@accel_label:
+@accel_object:
+
+<!-- ##### FUNCTION gtk_accel_map_add_notifer ##### -->
+<para>
+
+</para>
+
+@accel_path:
+@notify_data:
+@notify_func:
+@accel_group:
+
+<!-- ##### FUNCTION gtk_accel_map_remove_notifer ##### -->
+<para>
+
+</para>
+
+@accel_path:
+@notify_data:
+@notify_func:
+
+<!-- ##### FUNCTION gtk_arg_copy ##### -->
+<para>
+It will either copy data into an existing argument or allocate a new argument
+and copy the data. Strings are duplicated. All other pointers and
+values are copied (shallowly-- that is the pointers themselves are
+copied, not the data they point to.)
+</para>
+<para>
+You should call gtk_arg_reset() on dest_arg before calling this
+if the argument may contain string data that you want freed.
+</para>
+
+@src_arg: the argument to duplicate.
+@dest_arg: the argument to copy over (or NULL to create a new #GtkArg).
+@Returns: the new #GtkArg (or dest_arg, if it was not NULL).
+
+<!-- ##### FUNCTION gtk_arg_free ##### -->
+<para>
+Frees the argument, and optionally its contents.
+</para>
+
+@arg: the argument to free.
+@free_contents: whether to free the string, if it is a string.
+
+<!-- ##### FUNCTION gtk_arg_get_info ##### -->
+<para>
+Private: get information about an argument.
+</para>
+
+@object_type: the type of object.
+@arg_info_hash_table: the hashtable of #GtkArgInfos.
+@arg_name: the name of the argument to lookup.
+@info_p: the argument info.
+@Returns: an error message on failure, or NULL otherwise.
+
+<!-- ##### FUNCTION gtk_arg_info_equal ##### -->
+<para>
+A #GCompareFunc for hashing #GtkArgInfos.
+</para>
+
+@arg_info_1: a #GtkArgInfo.
+@arg_info_2: a #GtkArgInfo.
+@Returns: whether the arguments are the same.
+
+<!-- ##### FUNCTION gtk_arg_info_hash ##### -->
+<para>
+A #GHashFunc for hashing #GtkArgInfos.
+</para>
+
+@arg_info: a #GtkArgInfo.
+@Returns: a hash value for that #GtkArgInfo.
+
+<!-- ##### FUNCTION gtk_arg_name_strip_type ##### -->
+<para>
+Given a fully qualified argument name (e.g. "GtkButton::label")
+it returns just the argument name (e.g. "label") unless
+the argument name was invalid, in which case it returns NULL.
+</para>
+
+@arg_name: the fully-qualified argument name.
+@Returns: the base argument name.
+
+<!-- ##### FUNCTION gtk_arg_new ##### -->
+<para>
+Creates a new argument of a certain type, set to 0 or NULL.
+</para>
+
+@arg_type: the type of the argument.
+@Returns: the newly created #GtkArg.
+
+<!-- ##### FUNCTION gtk_arg_reset ##### -->
+<para>
+
+</para>
+
+@arg:
+
+<!-- ##### FUNCTION gtk_arg_to_valueloc ##### -->
+<para>
+
+</para>
+
+@arg:
+@value_pointer:
+
+<!-- ##### FUNCTION gtk_arg_type_new_static ##### -->
+<para>
+Create a new argument registered with a class.
+</para>
+
+@base_class_type: the basic type having the arguments, almost alway
+GTK_TYPE_OBJECT, except if your defining a different type argument
+that gets a different namespace. #GtkContainer does this to define
+per-child arguments of the container.
+@arg_name: name of the argument to create. (must be a static constant string)
+@class_n_args_offset: offset into the base class structure that tells
+the number of arguments.
+@arg_info_hash_table: hashtable of #GtkArgInfos.
+@arg_type: type of the argument.
+@arg_flags: flags of the argument.
+@arg_id: ???
+@Returns: the new #GtkArgInfo.
+
+<!-- ##### FUNCTION gtk_arg_values_equal ##### -->
+<para>
+
+</para>
+
+@arg1:
+@arg2:
+@Returns:
+
+<!-- ##### FUNCTION gtk_args_collect ##### -->
+<para>
+Private: given a hashtable of argument information it takes a vararg
+list and parses it into arguments (in the form of lists of #GtkArgs
+and lists of #GtkArgInfos.
+</para>
+<para>
+The list of arguments starts with first_arg_name then the first argument's
+value. Followed by any number of additional name/argument pairs,
+terminated with NULL.
+</para>
+
+@object_type: the type of object we are collecting arguments for.
+@arg_info_hash_table: a hashtable mapping from names of arguments
+to their #GtkArgInfos.
+@arg_list_p: a returned list of arguments obtained from parsing the
+varargs.
+@info_list_p: a returned list of the #GtkArgInfos.
+@first_arg_name: the name of the first argument.
+@var_args: a va_list containing the value of the first argument,
+followed by name/value pairs, followed by NULL.
+@Returns: an error message on failure, or NULL otherwise.
+
+<!-- ##### FUNCTION gtk_args_collect_cleanup ##### -->
+<para>
+Private: erase lists of arguments returned from gtk_args_collect().
+</para>
+
+@arg_list: arg_list_p returned from gtk_args_collect().
+@info_list: info_list_p returned from gtk_args_collect().
+
+<!-- ##### FUNCTION gtk_args_query ##### -->
+<para>
+Private: from a class type and its arginfo hashtable,
+get an array of #GtkArgs that this object accepts.
+</para>
+
+@class_type: the class type.
+@arg_info_hash_table: the hashtable of #GtkArgInfos.
+@arg_flags: returned array of argument flags.
+@n_args_p: the number of arguments this object accepts.
+@Returns: the array of arguments (or NULL on error).
+
+<!-- ##### FUNCTION gtk_button_box_child_requisition ##### -->
+<para>\r
+This is an internally used function and should never be called from an\r
+application.\r
+</para>
+
+@widget:
+@nvis_children:
+@width:
+@height:
+
+<!-- ##### FUNCTION gtk_button_box_get_child_ipadding_default ##### -->
+<para>\r
+The internal padding of a button is the amount of space between the outside\r
+of the button and the widget it contains. This function gets the default\r
+amount of horizontal and vertical padding, placing the results in @ipad_x\r
+and @ipad_y, respectively.\r
+</para>
+
+@ipad_x: the default horizontal internal button padding.
+@ipad_y: the default vertical internal button padding.
+
+<!-- ##### FUNCTION gtk_button_box_get_child_size_default ##### -->
+<para>\r
+Retrieves the default minimum width and height for all button boxes, and\r
+places the values in @min_width and @min_height, respectively.\r
+</para>
+
+@min_width: the default minimum width of a child widget.
+@min_height: the default minimum height of a child widget.
+
+<!-- ##### FUNCTION gtk_button_box_set_child_ipadding_default ##### -->
+<para>\r
+Sets the default number of pixels that pad each button in every button box.\r
+</para>
+
+@ipad_x: new default horizontal padding.
+@ipad_y: new default vertical padding.
+
+<!-- ##### FUNCTION gtk_button_box_set_child_size_default ##### -->
+<para>\r
+Sets the default size of child buttons.\r
+</para>
+
+@min_width: minimum default width for child buttons.
+@min_height: minimum default height for child buttons.
+
+<!-- ##### FUNCTION gtk_button_new_accel ##### -->
+<para>
+
+</para>
+
+@uline_label:
+@accel_group:
+@Returns:
+
+<!-- ##### FUNCTION gtk_button_new_stock ##### -->
+<para>
+
+</para>
+
+@stock_id:
+@accel_group:
+@Returns:
+
+<!-- ##### FUNCTION gtk_cell_renderer_event ##### -->
+<para>
+
+</para>
+
+@cell:
+@event:
+@widget:
+@path:
+@background_area:
+@cell_area:
+@flags:
+@Returns:
+
+<!-- ##### FUNCTION gtk_cell_renderer_text_pixbuf_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_clist_construct ##### -->
+<para>
+Initializes a previously allocated #GtkCList widget for use. This should not
+normally be used to create a #GtkCList widget. Use gtk_clist_new() instead.
+</para>
+
+@clist: A pointer to an uninitialized #GtkCList widget.
+@columns: The number of columns the #GtkCList should have.
+@titles: An array of strings that should be used as the titles i
+of the columns. There should be enough strings in the array for
+the number of columns specified.
+
+<!-- ##### FUNCTION gtk_color_selection_get_old_color ##### -->
+<para>
+
+</para>
+
+@colorsel:
+@color:
+
+<!-- ##### FUNCTION gtk_color_selection_get_use_opacity ##### -->
+<para>
+
+</para>
+
+@colorsel:
+@Returns:
+
+<!-- ##### FUNCTION gtk_color_selection_get_use_palette ##### -->
+<para>
+
+</para>
+
+@colorsel:
+@Returns:
+
+<!-- ##### FUNCTION gtk_color_selection_set_old_color ##### -->
+<para>
+
+</para>
+
+@colorsel:
+@color:
+
+<!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
+<para>
+Controls whether opacity can be set with the #GtkColorSelection.
+If this functionality is enabled, the necessary additional widgets
+are added to the #GtkColorSelection and the opacity value can be
+retrieved via the fourth value in the color array returned by
+the gtk_color_selection_get_color() function.
+</para>
+
+@colorsel: a #GtkColorSelection.
+@use_opacity: a boolean indicating whether the opacity selection
+is enabled.
+
+<!-- ##### FUNCTION gtk_color_selection_set_use_opacity ##### -->
+<para>
+
+</para>
+
+@colorsel:
+@use_opacity:
+
+<!-- ##### FUNCTION gtk_color_selection_set_use_palette ##### -->
+<para>
+
+</para>
+
+@colorsel:
+@use_palette:
+
+<!-- ##### FUNCTION gtk_container_add_child_arg_type ##### -->
+<para>
+
+</para>
+
+@arg_name:
+@arg_type:
+@arg_flags:
+@arg_id:
+
+<!-- ##### FUNCTION gtk_container_add_with_args ##### -->
+<para>
+
+</para>
+
+@container:
+@widget:
+@first_arg_name:
+@Varargs:
+
+<!-- ##### FUNCTION gtk_container_addv ##### -->
+<para>
+
+</para>
+
+@container:
+@widget:
+@n_args:
+@args:
+
+<!-- ##### FUNCTION gtk_container_arg_get ##### -->
+<para>
+
+</para>
+
+@container:
+@child:
+@arg:
+@info:
+
+<!-- ##### FUNCTION gtk_container_arg_set ##### -->
+<para>
+
+</para>
+
+@container:
+@child:
+@arg:
+@info:
+
+<!-- ##### FUNCTION gtk_container_child_arg_get_info ##### -->
+<para>
+
+</para>
+
+@object_type:
+@arg_name:
+@info_p:
+@Returns:
+
+<!-- ##### FUNCTION gtk_container_child_args_collect ##### -->
+<para>
+
+</para>
+
+@object_type:
+@arg_list_p:
+@info_list_p:
+@first_arg_name:
+@args:
+@Returns:
+
+<!-- ##### FUNCTION gtk_container_child_getv ##### -->
+<para>
+
+</para>
+
+@container:
+@child:
+@n_args:
+@args:
+
+<!-- ##### FUNCTION gtk_container_child_setv ##### -->
+<para>
+
+</para>
+
+@container:
+@child:
+@n_args:
+@args:
+
+<!-- ##### FUNCTION gtk_container_dequeue_resize_handler ##### -->
+<para>
+
+</para>
+
+@container:
+
+<!-- ##### FUNCTION gtk_container_focus ##### -->
+<para>
+
+</para>
+
+@container:
+@direction:
+@Returns:
+
+<!-- ##### FUNCTION gtk_container_query_child_args ##### -->
+<para>
+
+</para>
+
+@class_type:
+@arg_flags:
+@nargs:
+@Returns:
+
+<!-- ##### FUNCTION gtk_ctree_construct ##### -->
+<para>
+This function is not usually used by users.
+</para>
+
+@ctree:
+@columns:
+@tree_column:
+@titles:
+
+<!-- ##### FUNCTION gtk_drag_dest_handle_event ##### -->
+<para>
+Internal function.
+</para>
+
+@toplevel:
+@event:
+
+<!-- ##### FUNCTION gtk_drag_source_handle_event ##### -->
+<para>
+Internal function.
+</para>
+
+@widget:
+@event:
+
+<!-- ##### FUNCTION gtk_editable_changed ##### -->
+<para>
+Causes the "changed" signal to be emitted.
+</para>
+
+@editable: a #GtkEditable widget.
+
+<!-- ##### FUNCTION gtk_editable_claim_selection ##### -->
+<para>
+Claim or disclaim ownership of the PRIMARY X selection.
+</para>
+
+@editable: a #GtkEditable widget.
+@claim: if %TRUE, claim the selection, otherwise, disclaim it.
+@time: the timestamp for claiming the selection.
+
+<!-- ##### FUNCTION gtk_font_selection_dialog_set_filter ##### -->
+<para>
+Sets one of the two font filters, to limit the fonts shown.
+</para>
+
+@fsd: a #GtkFontSelectionDialog.
+@filter_type: which of the two font filters to set, either
+#GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
+can be changed by the user, but the base filter is permanent.
+@font_type: the types of font to be shown. This is a bitwise combination of
+#GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
+or #GTK_FONT_ALL to show all three font types.
+@foundries: a NULL-terminated array of strings containing foundry names which
+will be shown, or NULL to show all foundries.
+@weights: a NULL-terminated array of strings containing weight names which
+will be shown, or NULL to show all weights.
+@slants: a NULL-terminated array of strings containing slant names which
+will be shown, or NULL to show all slants.
+@setwidths: a NULL-terminated array of strings containing setwidth names which
+will be shown, or NULL to show all setwidths.
+@spacings: a NULL-terminated array of strings containing spacings which
+will be shown, or NULL to show all spacings.
+@charsets: a NULL-terminated array of strings containing charset names which
+will be shown, or NULL to show all charsets.
+
+<!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
+<para>
+Sets one of the two font filters, to limit the fonts shown.
+</para>
+
+@fontsel: a #GtkFontSelection.
+@filter_type: which of the two font filters to set, either
+#GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
+can be changed by the user, but the base filter is permanent.
+@font_type: the types of font to be shown. This is a bitwise combination of
+#GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
+or #GTK_FONT_ALL to show all three font types.
+@foundries: a NULL-terminated array of strings containing foundry names which
+will be shown, or NULL to show all foundries.
+@weights: a NULL-terminated array of strings containing weight names which
+will be shown, or NULL to show all weights.
+@slants: a NULL-terminated array of strings containing slant names which
+will be shown, or NULL to show all slants.
+@setwidths: a NULL-terminated array of strings containing setwidth names which
+will be shown, or NULL to show all setwidths.
+@spacings: a NULL-terminated array of strings containing spacings which
+will be shown, or NULL to show all spacings.
+@charsets: a NULL-terminated array of strings containing charset names which
+will be shown, or NULL to show all charsets.
+
+<!-- ##### FUNCTION gtk_identifier_get_type ##### -->
+<para>
+Get the type of GtkIdentifier.
+</para>
+
+@Returns: GtkType -- the enumerated type of something.
+
+<!-- ##### FUNCTION gtk_image_menu_item_add_image ##### -->
+<para>
+
+</para>
+
+@image_menu_item:
+@child:
+
+<!-- ##### FUNCTION gtk_image_menu_item_get_type ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_item_factory_dump_items ##### -->
+<para>
+
+</para>
+
+@path_pspec:
+@modified_only:
+@print_func:
+@func_data:
+
+<!-- ##### FUNCTION gtk_item_factory_dump_rc ##### -->
+<para>
+
+</para>
+
+@file_name:
+@path_pspec:
+@modified_only:
+
+<!-- ##### FUNCTION gtk_item_factory_parse_rc ##### -->
+<para>
+
+</para>
+
+@file_name:
+
+<!-- ##### FUNCTION gtk_item_factory_parse_rc_scanner ##### -->
+<para>
+
+</para>
+
+@scanner:
+
+<!-- ##### FUNCTION gtk_item_factory_parse_rc_string ##### -->
+<para>
+
+</para>
+
+@rc_string:
+
+<!-- ##### FUNCTION gtk_item_factory_print_func ##### -->
+<para>
+
+</para>
+
+@FILE_pointer:
+@string:
+
+<!-- ##### FUNCTION gtk_label_set_markup_with_accel ##### -->
+<para>
+
+</para>
+
+@label:
+@str:
+@Returns:
+
+<!-- ##### FUNCTION gtk_list_store_move ##### -->
+<para>
+
+</para>
+
+@store:
+@iter:
+@position:
+
+<!-- ##### FUNCTION gtk_list_store_new_with_types ##### -->
+<para>
+
+</para>
+
+@n_columns:
+@Varargs:
+@Returns:
+
+<!-- ##### FUNCTION gtk_list_store_set_cell ##### -->
+<para>
+
+</para>
+
+@store:
+@iter:
+@column:
+@value:
+
+<!-- ##### FUNCTION gtk_list_store_set_column_type ##### -->
+<para>
+
+</para>
+
+@store:
+@column:
+@type:
+
+<!-- ##### FUNCTION gtk_list_store_set_n_columns ##### -->
+<para>
+
+</para>
+
+@store:
+@n_columns:
+
+<!-- ##### FUNCTION gtk_menu_ensure_uline_accel_group ##### -->
+<para>
+
+</para>
+
+@menu:
+@Returns:
+
+<!-- ##### FUNCTION gtk_menu_get_uline_accel_group ##### -->
+<para>
+
+</para>
+
+@menu:
+@Returns:
+
+<!-- ##### FUNCTION gtk_menu_item_configure ##### -->
+<para>
+Sets whether the menu item should show a submenu indicator, which is a right
+arrow.
+</para>
+
+@menu_item: the menu item
+@show_toggle_indicator: unused
+@show_submenu_indicator: whether to show the arrow or not
+
+<!-- ##### FUNCTION gtk_menu_item_set_placement ##### -->
+<para>
+Specifies the placement of the submenu around the menu item. The placement
+is usually #GTK_LEFT_RIGHT for menu items in a popup menu and
+#GTK_TOP_BOTTOM in menu bars.
+</para>
+<para>
+This function is useless in usual applications.
+</para>
+
+@menu_item: the menu item
+@placement: the submenu placement
+
+<!-- ##### FUNCTION gtk_object_arg_get ##### -->
+<para>
+Private function to get an argument and argument info from an object.
+</para>
+
+@object: the object whose argument should be retrieved.
+@arg: the argument, for the name on input, the rest is filled on output.
+@info: a #GtkArgInfo structure to optionally fill in.
+
+<!-- ##### FUNCTION gtk_object_arg_get_info ##### -->
+<para>
+Query information about an argument type.
+</para>
+
+@object_type: type of object to query about.
+@arg_name: name of the argument.
+@info_p: pointer to be filled in with a pointer to the GtkArgInfo.
+@Returns: an error message, or NULL on success.
+It is the caller's responsibility to call g_free() in the event of error.
+
+<!-- ##### FUNCTION gtk_object_arg_set ##### -->
+<para>
+Private function to set an argument and argument info to an object.
+</para>
+
+@object: the object whose argument should be set.
+@arg: the argument.
+@info: infomation about this type of argument in general.
+
+<!-- ##### FUNCTION gtk_object_args_collect ##### -->
+<para>
+Private: Gets an array of #GtkArgs from a va_list C structure.
+</para>
+
+@object_type: the type of object to collect arguments for.
+@arg_list_p: pointer to be filled in with a list of parsed arguments.
+@info_list_p: optional pointer for a returned list #GtkArgInfos.
+@first_arg_name: name of first argument.
+@var_args: value of first argument, followed by more key/value pairs,
+terminated by NULL.
+@Returns: an error message, or NULL on success.
+It is the caller's responsibility to call g_free() in the event of error.
+
+<!-- ##### FUNCTION gtk_object_class_add_signals ##### -->
+<para>
+Add an array of signals to a #GtkObjectClass.
+Usually this is called when registering a new type of object.
+</para>
+
+@klass: the object class to append signals to.
+@signals: the signals to append.
+@nsignals: the number of signals being appended.
+
+<!-- ##### FUNCTION gtk_object_class_user_signal_new ##### -->
+<para>
+Define a signal-handler for a new signal on an already defined
+object.
+</para>
+<para>
+See the signal documentation for more general information.
+</para>
+
+@klass: the object class to define the signal for.
+@name: the name of the signal.
+@signal_flags: the default emission behavior for the signal.
+See gtk_signal_new().
+@marshaller: a function that will take an array of GtkArgs
+and invoke the appropriate handler with the normal calling
+conventions.
+@return_val: specify the return-value type for the signal
+(or GTK_TYPE_NONE for no return-value).
+@nparams: specify the number of parameters the signal
+receives from the caller of gtk_signal_emit().
+@Varargs: list of nparams #GtkTypes to pass to the signal handlers.
+@Returns: the signal id. (See #GtkSignals)
+
+<!-- ##### FUNCTION gtk_object_class_user_signal_newv ##### -->
+<para>
+Define a signal-handler for a new signal on an already defined
+object.
+</para>
+
+@klass: the object class to define the signal for.
+@name: the name of the signal.
+@signal_flags: the default emission behavior for the signal.
+See gtk_signal_new().
+@marshaller: takes a GtkObject, a #GtkSignalFunc, and an array
+of arguments, and invokes the function using the appropriate
+calling conventions. Usually just select a function
+out of gtkmarshal.h.
+@return_val: specify the return-value type for the signal (possibly
+#GTK_TYPE_NONE).
+@nparams: specify the number of parameters the signal
+receives from the caller of gtk_signal_emit().
+@params: array of #GtkTypes the signal handlers for this signal
+should have in their prototype (of length nparams).
+@Returns: the signal id. (See #GtkSignals)
+
+<!-- ##### FUNCTION gtk_object_constructed ##### -->
+<para>
+Mark an allocated object as constructed.
+This is used for situations
+that require precise control of the construction process.
+</para>
+<para>
+This is done when gtk_object_default_construct() is inadequate.
+In #GtkCList the need arises because #GtkCList does construction work that
+must happen <emphasis>after</emphasis> its derivers. This work
+cannot be done in an initializer function, so an alternate
+constructor is mandatory. It calls gtk_object_constructed() to
+indicate it has done its job, so that no other constructor will
+be invoked.
+</para>
+<para>
+Normally this function is just automatically run from
+gtk_object_default_construct().
+</para>
+
+@object: object which has been constructed. This is usually
+done automatically by gtk_object_new() and gtk_object_newv().
+
+<!-- ##### FUNCTION gtk_object_default_construct ##### -->
+<para>
+This function is called to construct arguments that haven't been initialized
+but have the #GTK_ARG_CONSTRUCT flag set.
+</para>
+<para>
+All number arguments are set to 0. All pointers and strings
+are set to NULL.
+</para>
+<para>
+Normally invoked by gtk_object_new() automatically; gtk_type_new() can
+be used to bypass it.
+</para>
+
+@object: the object to initialize.
+
+<!-- ##### FUNCTION gtk_object_getv ##### -->
+<para>
+Gets an array of argument values from an object.
+</para>
+
+@object: the object to get arguments from.
+@n_args: the number of arguments to query.
+@args: the arguments to fill in.
+
+<!-- ##### FUNCTION gtk_object_newv ##### -->
+<para>
+Construct an object with an array of arguments.
+</para>
+
+@object_type: the type of the object to create.
+@n_args: the number of arguments to set.
+@args: an array of n_args arguments (which are name and value pairs).
+@Returns: the new GtkObject.
+
+<!-- ##### FUNCTION gtk_object_query_args ##### -->
+<para>
+Get all the arguments that may be used for a given type.
+</para>
+<para>
+In Java, this type of mechanism is called
+<wordasword>introspection</wordasword>. It is used by applications
+like Glade, that have to determine what can be done to an object
+at run-time.
+</para>
+
+@class_type: the GtkType of the ObjectClass
+(returned from GTK_OBJECT_CLASS(class)->type for example).
+@arg_flags: if non-NULL, obtains the #GtkArgFlags that apply to
+each argument. You must g_free() this if you request it.
+@n_args: the number of arguments is returned in this field.
+@Returns: an array of arguments, that you must deallocate with g_free().
+
+<!-- ##### FUNCTION gtk_object_setv ##### -->
+<para>
+Set an array of arguments.
+</para>
+
+@object: the object whose arguments should be set.
+@n_args: the number of arguments to set.
+@args: the desired values, as an array of #GtkArgs (which contain
+the names, types, and values of the arguments).
+
+<!-- ##### FUNCTION gtk_packer_add ##### -->
+<para>
+
+</para>
+
+@packer:
+@child:
+@side:
+@anchor:
+@options:
+@border_width:
+@pad_x:
+@pad_y:
+@i_pad_x:
+@i_pad_y:
+
+<!-- ##### FUNCTION gtk_packer_add_defaults ##### -->
+<para>
+
+</para>
+
+@packer:
+@child:
+@side:
+@anchor:
+@options:
+
+<!-- ##### MACRO gtk_packer_configure ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gtk_packer_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_packer_reorder_child ##### -->
+<para>
+
+</para>
+
+@packer:
+@child:
+@position:
+
+<!-- ##### FUNCTION gtk_packer_set_child_packing ##### -->
+<para>
+
+</para>
+
+@packer:
+@child:
+@side:
+@anchor:
+@options:
+@border_width:
+@pad_x:
+@pad_y:
+@i_pad_x:
+@i_pad_y:
+
+<!-- ##### FUNCTION gtk_packer_set_default_border_width ##### -->
+<para>
+
+</para>
+
+@packer:
+@border:
+
+<!-- ##### FUNCTION gtk_packer_set_default_ipad ##### -->
+<para>
+
+</para>
+
+@packer:
+@i_pad_x:
+@i_pad_y:
+
+<!-- ##### FUNCTION gtk_packer_set_default_pad ##### -->
+<para>
+
+</para>
+
+@packer:
+@pad_x:
+@pad_y:
+
+<!-- ##### FUNCTION gtk_packer_set_spacing ##### -->
+<para>
+
+</para>
+
+@packer:
+@spacing:
+
+<!-- ##### FUNCTION gtk_paned_compute_position ##### -->
+<para>
+Internal function used by #GtkHPaned and #GtkVPaned
+</para>
+
+@paned:
+@allocation:
+@child1_req:
+@child2_req:
+
+<!-- ##### MACRO gtk_paned_handle_size ##### -->
+<para>
+Old name for gtk_paned_set_handle_size().
+</para>
+
+
+<!-- ##### FUNCTION gtk_paned_set_handle_size ##### -->
+<para>
+Set the the handle size to @size x @size pixels.
+</para>
+
+@paned: a paned widget
+@size: the size in pixels
+
+<!-- ##### FUNCTION gtk_pattern_match ##### -->
+<para>
+
+</para>
+
+@pspec:
+@string_length:
+@string:
+@string_reversed:
+@Returns:
+
+<!-- ##### FUNCTION gtk_pattern_match_simple ##### -->
+<para>
+
+</para>
+
+@pattern:
+@string:
+@Returns:
+
+<!-- ##### FUNCTION gtk_pattern_match_string ##### -->
+<para>
+
+</para>
+
+@pspec:
+@string:
+@Returns:
+
+<!-- ##### FUNCTION gtk_pattern_spec_free_segs ##### -->
+<para>
+
+</para>
+
+@pspec:
+
+<!-- ##### FUNCTION gtk_pattern_spec_init ##### -->
+<para>
+
+</para>
+
+@pspec:
+@pattern:
+
+<!-- ##### FUNCTION gtk_rc_init ##### -->
+<para>
+Internal function.
+</para>
+
+
+<!-- ##### FUNCTION gtk_rc_load_image ##### -->
+<para>
+Internal function. Loads an image using the current
+image loader.
+</para>
+
+@colormap: the colormap to use for the image
+@transparent_color: the transparent color for the image
+@filename: the filename of the image file
+@Returns: a #GtkPixmap representing @filename
+
+<!-- ##### FUNCTION gtk_rc_set_image_loader ##### -->
+<para>
+Sets the function that GTK+ will use to load images
+</para>
+
+@loader: the #GtkImageLoader to use
+
+<!-- ##### FUNCTION gtk_ruler_draw_pos ##### -->
+<para>
+
+</para>
+
+@ruler: the gtkruler
+
+<!-- ##### FUNCTION gtk_ruler_draw_ticks ##### -->
+<para>
+
+</para>
+
+@ruler: the gtkruler
+
+<!-- ##### FUNCTION gtk_selection_incr_event ##### -->
+<para>
+Internal function.
+</para>
+
+@window:
+@event:
+@Returns:
+
+<!-- ##### FUNCTION gtk_selection_notify ##### -->
+<para>
+Internal function.
+</para>
+
+@widget:
+@event:
+@Returns:
+
+<!-- ##### FUNCTION gtk_selection_property_notify ##### -->
+<para>
+Internal function.
+</para>
+
+@widget:
+@event:
+@Returns:
+
+<!-- ##### FUNCTION gtk_selection_request ##### -->
+<para>
+Internal function.
+</para>
+
+@widget:
+@event:
+@Returns:
+
+<!-- ##### FUNCTION gtk_settings_get_global ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_signal_add_emission_hook ##### -->
+<para>
+Add an emission hook for a type of signal, for any object.
+</para>
+
+@signal_id: the type of signal to hook for.
+@hook_func: the function to invoke to handle the emission hook.
+@data: the user data passed in to hook_func.
+@Returns: the id (that you may pass as a parameter
+to gtk_signal_remove_emission_hook()).
+@i:
+@h:
+@d:
+
+<!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
+<para>
+Add an emission hook for a type of signal, for any object.
+(with control of what happens when the hook is
+destroyed).
+</para>
+
+@signal_id: the type of signal add the hook for.
+@hook_func: the function to invoke to handle the hook.
+@data: the user data passed in to hook_func.
+@destroy: a function to invoke when the hook is destroyed,
+to clean up any allocation done just for this
+signal handler.
+@Returns: the id (that you may pass as a parameter
+to gtk_signal_remove_emission_hook()).
+
+<!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
+<para>
+Returns whether a connection id is valid (and optionally not blocked).
+</para>
+
+@object: the object to search for the desired handler.
+@handler_id: the connection id.
+@may_be_blocked: whether it is acceptable to return a blocked
+handler.
+@Returns: TRUE if the signal exists and wasn't blocked,
+unless #may_be_blocked was specified. FALSE otherwise.
+
+<!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
+<para>
+Destroy all the signal handlers connected to an object.
+This is done automatically when the object is destroyed.
+</para>
+<para>
+This function is labeled private.
+</para>
+
+@object: the object whose signal handlers should be destroyed.
+
+<!-- ##### FUNCTION gtk_signal_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gtk_signal_n_emissions ##### -->
+<para>
+Find out the recursion depth of emissions for a particular type
+of signal and object. (So it will
+always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified)
+This is a way to avoid recursion: you can see if
+you are currently running in that signal handler and emit it only
+if you are.
+</para>
+<para>Another way to look at it is that this number increases
+by one when #gtk_signal_emit(), et al, are called,
+and decreases by one when #gtk_signal_emit() returns.
+</para>
+
+@object: the object with the signal handler.
+@signal_id: the signal id.
+@Returns: the recursion depth of emissions of this signal for this
+object.
+
+<!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
+<para>
+Find out the recursion depth of emissions for a particular type
+of signal and object. Just like gtk_signal_n_emissions()
+except it will lookup the signal id for you.
+</para>
+
+@object: the object with the signal handler.
+@name: the signal name.
+@Returns: the recursion depth of emissions of this signal for this
+object.
+
+<!-- ##### FUNCTION gtk_signal_query ##### -->
+<para>
+Obtain information about a signal.
+</para>
+
+@signal_id: the signal type identifier.
+@Returns: a pointer to a GtkSignalQuery structure
+which contains all the information, or NULL.
+The pointer is allocated just for you: you must g_free() it.
+
+<!-- ##### FUNCTION gtk_signal_remove_emission_hook ##### -->
+<para>
+Delete an emission hook. (see gtk_signal_add_emission_hook())
+</para>
+
+@signal_id: the id of the signal type.
+@hook_id: the id of the emission handler, returned by add_emission_hook().
+@i:
+@h:
+
+<!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
+<para>
+These set default functions to call when the user didn't
+supply a function when connecting. (These are rarely
+used, and probably only for language bindings)
+</para>
+<para>
+By default, there are no such functions.
+</para>
+
+@marshal_func: the function to invoke on every handlers for which there
+isn't a function pointer. May be NULL.
+@destroy_func: the function to invoke when each hook is destroyed.
+May be NULL.
+
+<!-- ##### FUNCTION gtk_spin_button_set_shadow_type ##### -->
+<para>
+Creates a border around the arrows of a #GtkSpinButton. The type of border is determined by @shadow_type.
+</para>
+
+@spin_button: a #GtkSpinButton
+@shadow_type: the new border type.
+
+<!-- ##### FUNCTION gtk_stock_list_items ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_style_get_font_for_display ##### -->
+<para>
+
+</para>
+
+@display:
+@style:
+@Returns:
+
+<!-- ##### FUNCTION gtk_text_buffer_paste_primary ##### -->
+<para>
+
+</para>
+
+@buffer:
+@override_location:
+@default_editable:
+
+<!-- ##### FUNCTION gtk_text_iter_reorder ##### -->
+<para>
+
+</para>
+
+@first:
+@second:
+
+<!-- ##### FUNCTION gtk_text_iter_spew ##### -->
+<para>
+
+</para>
+
+@iter:
+@desc:
+
+<!-- ##### FUNCTION gtk_text_view_set_text_window_size ##### -->
+<para>
+
+</para>
+
+@text_view:
+@width:
+@height:
+
+<!-- ##### FUNCTION gtk_tips_query_get_type ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_tool_item_toolbar_reconfigured ##### -->
+<para>
+
+</para>
+
+@tool_item:
+
+<!-- ##### FUNCTION gtk_trace_referencing ##### -->
<para>
-Normally invoked by gtk_object_new() automatically; gtk_type_new() can
-be used to bypass it.
+Private: print debugging information while doing a gtk_object_ref() or
+a gtk_object_unref().
</para>
-@object: the object to initialize.
+@object: object to reference or unreference.
+@func: name of caller's function to print (used within macros).
+@dummy: unused.
+@line: line number (used within macros).
+@do_ref: whether to reference or unreference.
-<!-- ##### FUNCTION gtk_object_getv ##### -->
+<!-- ##### FUNCTION gtk_tree_model_ref_iter ##### -->
<para>
-Gets an array of argument values from an object.
+
</para>
-@object: the object to get arguments from.
-@n_args: the number of arguments to query.
-@args: the arguments to fill in.
+@tree_model:
+@iter:
-<!-- ##### FUNCTION gtk_object_newv ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_convert_iter ##### -->
<para>
-Construct an object with an array of arguments.
+
</para>
-@object_type: the type of the object to create.
-@n_args: the number of arguments to set.
-@args: an array of n_args arguments (which are name and value pairs).
-@Returns: the new GtkObject.
+@tree_model_sort:
+@sort_iter:
+@child_iter:
-<!-- ##### FUNCTION gtk_object_query_args ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_convert_path ##### -->
<para>
-Get all the arguments that may be used for a given type.
+
</para>
+
+@tree_model_sort:
+@child_path:
+@Returns:
+@path:
+
+<!-- ##### FUNCTION gtk_tree_model_sort_new ##### -->
<para>
-In Java, this type of mechanism is called
-<wordasword>introspection</wordasword>. It is used by applications
-like Glade, that have to determine what can be done to an object
-at run-time.
+
</para>
-@class_type: the GtkType of the ObjectClass
-(returned from GTK_OBJECT_CLASS(class)->type for example).
-@arg_flags: if non-NULL, obtains the #GtkArgFlags that apply to
-each argument. You must g_free() this if you request it.
-@n_args: the number of arguments is returned in this field.
-@Returns: an array of arguments, that you must deallocate with g_free().
+@Returns:
-<!-- ##### FUNCTION gtk_object_setv ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_set_compare ##### -->
<para>
-Set an array of arguments.
+
</para>
-@object: the object whose arguments should be set.
-@n_args: the number of arguments to set.
-@args: the desired values, as an array of #GtkArgs (which contain
-the names, types, and values of the arguments).
+@tree_model_sort:
+@func:
-<!-- ##### FUNCTION gtk_paned_compute_position ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_set_model ##### -->
<para>
-Internal function used by #GtkHPaned and #GtkVPaned
+
</para>
-@paned:
-@allocation:
-@child1_req:
-@child2_req:
+@tree_model_sort:
+@child_model:
+@model:
-<!-- ##### FUNCTION gtk_rc_init ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_set_sort_column ##### -->
<para>
-Internal function.
+
</para>
+@tree_model_sort:
+@sort_col:
-<!-- ##### FUNCTION gtk_ruler_draw_pos ##### -->
+<!-- ##### FUNCTION gtk_tree_model_unref_iter ##### -->
<para>
</para>
-@ruler: the gtkruler
+@tree_model:
+@iter:
-<!-- ##### FUNCTION gtk_ruler_draw_ticks ##### -->
+<!-- ##### FUNCTION gtk_tree_store_move ##### -->
<para>
</para>
-@ruler: the gtkruler
+@tree_store:
+@iter:
+@position:
-<!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
+<!-- ##### FUNCTION gtk_tree_store_new_with_types ##### -->
<para>
-Add an emission hook for a type of signal, for any object.
-(with control of what happens when the hook is
-destroyed).
+
</para>
-@signal_id: the type of signal add the hook for.
-@hook_func: the function to invoke to handle the hook.
-@data: the user data passed in to hook_func.
-@destroy: a function to invoke when the hook is destroyed,
-to clean up any allocation done just for this
-signal handler.
-@Returns: the id (that you may pass as a parameter
-to gtk_signal_remove_emission_hook()).
+@n_columns:
+@Varargs:
+@Returns:
-<!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
+<!-- ##### FUNCTION gtk_tree_store_set_cell ##### -->
<para>
-Returns whether a connection id is valid (and optionally not blocked).
+
</para>
-@object: the object to search for the desired handler.
-@handler_id: the connection id.
-@may_be_blocked: whether it is acceptable to return a blocked
-handler.
-@Returns: TRUE if the signal exists and wasn't blocked,
-unless #may_be_blocked was specified. FALSE otherwise.
+@tree_store:
+@iter:
+@column:
+@value:
-<!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
+<!-- ##### FUNCTION gtk_tree_store_set_column_type ##### -->
<para>
-Destroy all the signal handlers connected to an object.
-This is done automatically when the object is destroyed.
+
</para>
+
+@tree_store:
+@column:
+@type:
+@store:
+
+<!-- ##### FUNCTION gtk_tree_store_set_n_columns ##### -->
<para>
-This function is labeled private.
+
</para>
-@object: the object whose signal handlers should be destroyed.
+@tree_store:
+@n_columns:
-<!-- ##### FUNCTION gtk_signal_n_emissions ##### -->
+<!-- ##### FUNCTION gtk_tree_view_column_cell_event ##### -->
<para>
-Find out the recursion depth of emissions for a particular type
-of signal and object. (So it will
-always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified)
-This is a way to avoid recursion: you can see if
-you are currently running in that signal handler and emit it only
-if you are.
-</para>
-<para>Another way to look at it is that this number increases
-by one when #gtk_signal_emit(), et al, are called,
-and decreases by one when #gtk_signal_emit() returns.
+
</para>
-@object: the object with the signal handler.
-@signal_id: the signal id.
-@Returns: the recursion depth of emissions of this signal for this
-object.
+@tree_column:
+@event:
+@path_string:
+@background_area:
+@cell_area:
+@flags:
+@Returns:
-<!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
+<!-- ##### FUNCTION gtk_tree_view_column_set_cell_data ##### -->
<para>
-Find out the recursion depth of emissions for a particular type
-of signal and object. Just like gtk_signal_n_emissions()
-except it will lookup the signal id for you.
+
</para>
-@object: the object with the signal handler.
-@name: the signal name.
-@Returns: the recursion depth of emissions of this signal for this
-object.
+@tree_column:
+@tree_model:
+@iter:
-<!-- ##### FUNCTION gtk_signal_query ##### -->
+<!-- ##### FUNCTION gtk_tree_view_column_set_cell_renderer ##### -->
<para>
-Obtain information about a signal.
+
</para>
-@signal_id: the signal type identifier.
-@Returns: a pointer to a GtkSignalQuery structure
-which contains all the information, or NULL.
-The pointer is allocated just for you: you must g_free() it.
+@tree_column:
+@cell:
-<!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
+<!-- ##### FUNCTION gtk_tree_view_column_set_width ##### -->
<para>
-These set default functions to call when the user didn't
-supply a function when connecting. (These are rarely
-used, and probably only for language bindings)
+
</para>
+
+@tree_column:
+@width:
+@size:
+
+<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_dest ##### -->
<para>
-By default, there are no such functions.
+
</para>
-@marshal_func: the function to invoke on every handlers for which there
-isn't a function pointer. May be NULL.
-@destroy_func: the function to invoke when each hook is destroyed.
-May be NULL.
+@tree_view:
+@targets:
+@n_targets:
+@actions:
+@location_droppable_func:
+@user_data:
-<!-- ##### FUNCTION gtk_trace_referencing ##### -->
+<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_source ##### -->
<para>
-Private: print debugging information while doing a gtk_object_ref() or
-a gtk_object_unref().
+
</para>
-@object: object to reference or unreference.
-@func: name of caller's function to print (used within macros).
-@dummy: unused.
-@line: line number (used within macros).
-@do_ref: whether to reference or unreference.
+@tree_view:
+@start_button_mask:
+@targets:
+@n_targets:
+@actions:
+@row_draggable_func:
+@user_data:
<!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
<para>
fundamental type.
@varargs_type: Must be a GtkType which is either structured or flag, or NONE.
+<!-- ##### FUNCTION gtk_widget_accelerator_signal ##### -->
+<para>
+
+</para>
+
+@widget:
+@accel_group:
+@accel_key:
+@accel_mods:
+@Returns:
+
+<!-- ##### FUNCTION gtk_widget_accelerators_locked ##### -->
+<para>
+
+</para>
+
+@widget:
+@Returns:
+
+<!-- ##### FUNCTION gtk_widget_activate_mnemonic ##### -->
+<para>
+
+</para>
+
+@widget:
+@group_cycling:
+@Returns:
+
+<!-- ##### FUNCTION gtk_widget_get_usize ##### -->
+<para>
+
+</para>
+
+@widget:
+@width:
+@height:
+
+<!-- ##### FUNCTION gtk_widget_lock_accelerators ##### -->
+<para>
+
+</para>
+
+@widget:
+
+<!-- ##### FUNCTION gtk_widget_pop_style ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gtk_widget_popup ##### -->
+<para>
+
+</para>
+
+@widget:
+@x:
+@y:
+
+<!-- ##### FUNCTION gtk_widget_push_style ##### -->
+<para>
+
+</para>
+
+@style:
+
+<!-- ##### FUNCTION gtk_widget_remove_accelerators ##### -->
+<para>
+
+</para>
+
+@widget:
+@accel_signal:
+@visible_only:
+
+<!-- ##### FUNCTION gtk_widget_set_default_style ##### -->
+<para>
+
+</para>
+
+@style:
+
+<!-- ##### FUNCTION gtk_widget_unlock_accelerators ##### -->
+<para>
+
+</para>
+
+@widget:
+
+<!-- ##### FUNCTION gtk_window_activate_mnemonic ##### -->
+<para>
+
+</para>
+
+@window:
+@keyval:
+@modifier:
+@Returns:
+
+<!-- ##### FUNCTION gtk_window_get_default_accel_group ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+<!-- ##### FUNCTION gtk_window_get_resizeable ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+<!-- ##### FUNCTION gtk_window_set_decorations_hint ##### -->
+<para>
+
+</para>
+
+@window:
+@decorations:
+
+<!-- ##### FUNCTION gtk_window_set_functions_hint ##### -->
+<para>
+
+</para>
+
+@window:
+@functions:
+
+<!-- ##### FUNCTION gtk_window_set_resizeable ##### -->
+<para>
+
+</para>
+
+@window:
+@setting:
+@resizeable:
+