-<!-- ##### SECTION ./tmpl/gtkdebug.sgml:Title ##### -->
-Debugging
+<!-- ##### 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>
-<!-- ##### SIGNAL GtkEditable::cut-clipboard ##### -->
+<!-- ##### SECTION ./tmpl/gtkarg.sgml:See_Also ##### -->
<para>
-An action signal. Causes the characters in the current
-selection to be copied to the clipboard and then deleted from
-the widget.
+#GtkObject.
</para>
-@editable: the object which received the signal.
-<!-- ##### SECTION ./tmpl/gtkdebug.sgml:Short_Description ##### -->
+<!-- ##### SECTION ./tmpl/gtkarg.sgml:Short_Description ##### -->
+Utility function to manipulate lists of named, typed arguments.
+
+<!-- ##### SECTION ./tmpl/gtkarg.sgml:Title ##### -->
+Implementation of Object Properties
-<!-- ##### MACRO gtk_marshal_NONE__BOXED ##### -->
+<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Long_Description ##### -->
<para>
</para>
-<!-- ##### FUNCTION gtk_model_simple_node_inserted ##### -->
+<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:See_Also ##### -->
<para>
</para>
-@simple:
-@path:
-@iter:
-<!-- ##### FUNCTION gtk_widget_newv ##### -->
-<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>
-@type:
-@nargs:
-@args:
-@Returns:
-<!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### -->
+<!-- ##### SECTION ./tmpl/gtkdata.sgml:See_Also ##### -->
<para>
-A macro to check whether a child widget of the CList
-has the focus.
+
</para>
-@clist: The #GtkCList widget to check.
+
+<!-- ##### 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
+
+
+<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Title ##### -->
+gtkenums.sgml
+
<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Long_Description ##### -->
<refsect2>
</refsect2>
-<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Short_Description ##### -->
-
+<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:See_Also ##### -->
+<para>
+<variablelist>
+<varlistentry>
+<term>#GtkSignal</term>
+<listitem><para>The signal handling functions (of which marshallers are
+really an implementation detail).</para></listitem>
+</varlistentry>
-<!-- ##### 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.
+</variablelist>
</para>
-@klass: the object class to append signals to.
-@signals: the signals to append.
-@nsignals: the number of signals being appended.
-<!-- ##### MACRO gtk_marshal_NONE__UINT_STRING ##### -->
-<para>
+<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Short_Description ##### -->
+Functions to adapt C structures to native calling convention.
-</para>
+<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Title ##### -->
+Signal Marshallers
-<!-- ##### MACRO GTK_PRIVATE_UNSET_FLAG ##### -->
+
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:Long_Description ##### -->
<para>
</para>
-@wid:
-@flag:
-<!-- ##### MACRO GTK_WIDGET_REDRAW_PENDING ##### -->
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:See_Also ##### -->
<para>
</para>
-@obj:
-<!-- ##### FUNCTION gtk_icon_factory_get_type ##### -->
-<para>
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:Short_Description ##### -->
-</para>
-@Returns:
-<!-- ##### ARG GtkTextTag:offset-set ##### -->
-<para>
+<!-- ##### SECTION ./tmpl/gtkpacker.sgml:Title ##### -->
+GtkPacker
-</para>
+
+<!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### -->
+Private Information
-<!-- ##### FUNCTION gtk_theme_engine_create_rc_style ##### -->
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Long_Description ##### -->
<para>
</para>
-@engine:
-@Returns:
-<!-- ##### FUNCTION gtk_tree_selection_set_type ##### -->
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:See_Also ##### -->
<para>
</para>
-@selection:
-@type:
-<!-- ##### MACRO gtk_marshal_NONE__ENUM_FLOAT ##### -->
-<para>
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Short_Description ##### -->
-</para>
-<!-- ##### FUNCTION gtk_tree_store_new_with_values ##### -->
-<para>
+<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Title ##### -->
+GtkModelSimple
+
+<!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### -->
+<para>
+A macro to check whether a child widget of the CList
+has the focus.
</para>
-@n_columns:
-@Varargs:
-@Returns:
+@clist: The #GtkCList widget to check.
-<!-- ##### SIGNAL GtkTextView::insert ##### -->
+<!-- ##### MACRO GTK_ICON_SIZE_BUTTON ##### -->
<para>
</para>
-@textview: the object which received the signal.
-@arg1:
-<!-- ##### MACRO gtk_widget_set_default_visual ##### -->
+<!-- ##### MACRO GTK_ICON_SIZE_DIALOG ##### -->
<para>
</para>
-@v:
-@visual:
-<!-- ##### FUNCTION gtk_window_set_focus ##### -->
+<!-- ##### MACRO GTK_ICON_SIZE_LARGE_TOOLBAR ##### -->
<para>
</para>
-@window:
-@focus:
-<!-- ##### SECTION ./tmpl/gtkprivate.sgml:See_Also ##### -->
+<!-- ##### MACRO GTK_ICON_SIZE_MENU ##### -->
<para>
</para>
-<!-- ##### FUNCTION gtk_widget_get ##### -->
+<!-- ##### MACRO GTK_ICON_SIZE_SMALL_TOOLBAR ##### -->
<para>
</para>
-@widget:
-@arg:
-<!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT_ENUM ##### -->
+<!-- ##### MACRO GTK_IS_TIPS_QUERY ##### -->
<para>
</para>
+@obj:
-<!-- ##### ARG GtkEditable:editable ##### -->
+<!-- ##### MACRO GTK_IS_TIPS_QUERY_CLASS ##### -->
<para>
-A boolean indicating whether the widget is editable by
-the user.
+
</para>
+@klass:
-<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:See_Also ##### -->
+<!-- ##### MACRO GTK_OBJECT_CONNECTED ##### -->
<para>
-
+Tests whether a #GtkObject has had a signal connected to it.
</para>
+@obj: the object to examine.
-<!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
+<!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### -->
<para>
-Sets one of the two font filters, to limit the fonts shown.
+Test whether a GtkObject's arguments have been prepared.
</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.
+@obj: the object to examine.
-<!-- ##### FUNCTION gtk_container_unregister_toplevel ##### -->
+<!-- ##### MACRO GTK_OBJECT_DESTROYED ##### -->
<para>
-
+Test whether a GtkObject has had gtk_object_destroy() invoked on it.
</para>
-@container:
+@obj: the object to examine.
-<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Title ##### -->
-Signal Marshallers
+<!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
+<para>
+Get the number of signals defined by this object.
+</para>
+@obj: the object to query.
-<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Long_Description ##### -->
+<!-- ##### MACRO GTK_OBJECT_SET_FLAGS ##### -->
<para>
-
+Turns on certain object flags. (Private)
</para>
+@obj: the object to affect.
+@flag: the flags to set.
-<!-- ##### STRUCT GtkTypeQuery ##### -->
+<!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
<para>
-A structure used to return values from @gtk_type_query.
+Get the array of signals defined for this object.
</para>
-@type:
-@type_name:
-@object_size:
-@class_size:
+@obj: the object to fetch the signals from.
-<!-- ##### MACRO gtk_widget_pop_visual ##### -->
+<!-- ##### MACRO GTK_OBJECT_UNSET_FLAGS ##### -->
<para>
-
+Turns off certain object flags. (Private)
</para>
-@v:
+@obj: the object to affect.
+@flag: the flags to unset.
-<!-- ##### FUNCTION gtk_text_buffer_get_clipboard_contents ##### -->
+<!-- ##### MACRO GTK_STOCK_BUTTON_APPLY ##### -->
<para>
</para>
-@buffer:
-@Returns:
-<!-- ##### FUNCTION gtk_marshal_NONE__C_CALLBACK ##### -->
+<!-- ##### MACRO GTK_STOCK_BUTTON_CANCEL ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### ARG GtkTextTag:justify ##### -->
+<!-- ##### MACRO GTK_STOCK_BUTTON_CLOSE ##### -->
<para>
-A #GtkJustification for the text. This is only used when the tag is
-applied to the first character in a paragraph.
+
</para>
-<!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
-<para>
-This is currently a hack left in for a scheme wrapper library.
-It may be removed.
-</para>
+<!-- ##### MACRO GTK_STOCK_BUTTON_NO ##### -->
<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.
-<!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
+<!-- ##### MACRO GTK_STOCK_BUTTON_OK ##### -->
<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_text_buffer_paste_primary_selection ##### -->
+<!-- ##### MACRO GTK_STOCK_BUTTON_YES ##### -->
<para>
</para>
-@buffer:
-@override_location:
-@time:
-@interactive:
-@default_editable:
-<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_INT_INT ##### -->
+<!-- ##### MACRO GTK_TIPS_QUERY ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
+@obj:
-<!-- ##### FUNCTION gtk_model_simple_node_changed ##### -->
+<!-- ##### MACRO GTK_TIPS_QUERY_CLASS ##### -->
<para>
</para>
-@simple:
-@path:
-@iter:
+@klass:
-<!-- ##### FUNCTION gtk_tree_view_column_set_size ##### -->
+<!-- ##### MACRO GTK_TIPS_QUERY_GET_CLASS ##### -->
<para>
</para>
-@tree_column:
-@size:
-@width:
+@obj:
-<!-- ##### SIGNAL GtkTextView::copy-text ##### -->
+<!-- ##### MACRO GTK_TREE_MODEL_GET_IFACE ##### -->
<para>
</para>
-@textview: the object which received the signal.
+@obj:
-<!-- ##### FUNCTION gtk_text_view_get_iter_at_pixel ##### -->
+<!-- ##### MACRO GTK_TREE_SELECTION ##### -->
<para>
-
+A macro that returns a GList that contains the selection of the root tree of @obj.
</para>
-@text_view:
-@iter:
-@x:
-@y:
+@obj: A pointer to the #GtkTree. @obj will accept any pointer, but it the pointer does not point to a #GtkTree, the results are undefined.
-<!-- ##### FUNCTION gtk_object_getv ##### -->
+<!-- ##### MACRO GTK_TYPE_FLAT_FIRST ##### -->
<para>
-Gets an array of argument values from an object.
+The first "flat" (no struct) enumerated type value.
</para>
-@object: the object to get arguments from.
-@n_args: the number of arguments to query.
-@args: the arguments to fill in.
-<!-- ##### STRUCT GtkThemeEngine ##### -->
+<!-- ##### MACRO GTK_TYPE_FLAT_LAST ##### -->
<para>
-
+The last "flat" (no struct) enumerated type value.
</para>
-<!-- ##### FUNCTION gtk_text_buffer_get_tags ##### -->
+<!-- ##### MACRO GTK_TYPE_IDENTIFIER ##### -->
<para>
-
+Hide the name of gtk_identifier_get_type
</para>
-@buffer:
-@iter:
-@Returns:
-
-<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Short_Description ##### -->
+<!-- ##### MACRO GTK_TYPE_MAKE ##### -->
+<para>
+Combine a fundemantal type and a sequence number to create a gtk type.
+</para>
+@parent_t:
+@seqno:
-<!-- ##### FUNCTION gtk_identifier_get_type ##### -->
+<!-- ##### MACRO GTK_TYPE_NUM_BUILTINS ##### -->
<para>
-Get the type of GtkIdentifier.
+No idea.
</para>
-@Returns: GtkType -- the enumerated type of something.
-<!-- ##### FUNCTION gtk_theme_engine_get ##### -->
+<!-- ##### MACRO GTK_TYPE_SEQNO ##### -->
<para>
-
+Convert a gtk type into its sequence number
</para>
-@name:
-@Returns:
+@type:
-<!-- ##### STRUCT GtkModelSimple ##### -->
+<!-- ##### MACRO GTK_TYPE_STRUCTURED_FIRST ##### -->
<para>
-
+The first structured enumerated type value.
</para>
-@parent:
-@stamp:
-<!-- ##### MACRO gtk_marshal_BOOL__POINTER_INT_INT_UINT ##### -->
+<!-- ##### MACRO GTK_TYPE_STRUCTURED_LAST ##### -->
<para>
-
+The last structured enumerated type value.
</para>
-<!-- ##### FUNCTION gtk_model_simple_node_child_toggled ##### -->
+<!-- ##### MACRO GTK_TYPE_TIPS_QUERY ##### -->
<para>
</para>
-@simple:
-@path:
-@iter:
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER ##### -->
+<!-- ##### MACRO GTK_TYPE_TREE_COLUMN ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### FUNCTION gtk_theme_engine_ref ##### -->
+<!-- ##### MACRO GTK_TYPE_TREE_VIEW_COLUMN ##### -->
<para>
</para>
-@engine:
-<!-- ##### FUNCTION gtk_marshal_NONE__INT_INT ##### -->
+<!-- ##### MACRO GTK_VALUE_ARGS ##### -->
<para>
-
+Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
</para>
-@object:
-@func:
-@func_data:
-@args:
+@a:
-<!-- ##### ENUM GtkCellRendererType ##### -->
+<!-- ##### MACRO GTK_VALUE_CALLBACK ##### -->
<para>
-
+Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK
</para>
-@GTK_CELL_RENDERER_SELECTED:
-@GTK_CELL_RENDERER_PRELIT:
-@GTK_CELL_RENDERER_INSENSITIVE:
+@a:
-<!-- ##### FUNCTION gtk_marshal_NONE__NONE ##### -->
+<!-- ##### MACRO GTK_VALUE_C_CALLBACK ##### -->
<para>
-
+Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
</para>
-@object:
-@func:
-@func_data:
-@args:
+@a:
-<!-- ##### FUNCTION gtk_text_mark_deleted ##### -->
+<!-- ##### MACRO GTK_VALUE_FOREIGN ##### -->
<para>
-
+Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
</para>
-@mark:
-@Returns:
+@a:
-<!-- ##### MACRO gtk_marshal_BOOL__POINTER_STRING_STRING_POINTER ##### -->
+<!-- ##### USER_FUNCTION GValueCompareFunc ##### -->
<para>
</para>
+@a:
+@b:
+@Returns:
-<!-- ##### SIGNAL GtkEditable::set-editable ##### -->
+<!-- ##### STRUCT GtkAccelEntry ##### -->
<para>
-Determines if the user can edit the text in the editable
-widget or not. This is meant to be overriden by
-child classes and should not generally useful to
-applications.
+This is a private struct used by GTK+ internally, don't worry about it.
</para>
-@editable: the object which received the signal.
-@is_editable: %TRUE if the user is allowed to edit the text
- in the widget.
+@accel_group:
+@accelerator_key:
+@accelerator_mods:
+@accel_flags:
+@object:
+@signal_id:
-<!-- ##### FUNCTION gtk_model_simple_node_deleted ##### -->
+<!-- ##### ARG GtkAccelLabel:accel-object ##### -->
<para>
</para>
-@simple:
-@path:
-@iter:
-<!-- ##### SIGNAL GtkEditable::delete-text ##### -->
+<!-- ##### ARG GtkAccelLabel:accel-width ##### -->
<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.
-<!-- ##### FUNCTION gtk_ruler_draw_ticks ##### -->
+<!-- ##### USER_FUNCTION GtkAccelMapNotify ##### -->
<para>
</para>
-@ruler: the gtkruler
+@data:
+@accel_path_quark:
+@accel_key:
+@accel_mods:
+@accel_group:
+@old_accel_key:
+@old_accel_mods:
-<!-- ##### SIGNAL GtkEditable::kill-line ##### -->
+<!-- ##### USER_FUNCTION GtkArgGetFunc ##### -->
<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:
-<!-- ##### FUNCTION gtk_themes_init ##### -->
+<!-- ##### STRUCT GtkArgInfo ##### -->
<para>
-
+A structure containing information about the argument.
+Returned by gtk_arg_get_info().
</para>
-@argc:
-@argv:
+@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: ???
-<!-- ##### FUNCTION gtk_type_register_enum ##### -->
+<!-- ##### USER_FUNCTION GtkArgSetFunc ##### -->
<para>
-Register a new set of enum @values and give them the name in
-@type_name.
+Define a function pointer. Deprecated.
</para>
-@type_name: must not be null.
-@values: GtkEnumValue*
-@Returns:
-
-<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Title ##### -->
-Menu Factory
-
+@object:
+@arg:
+@arg_id:
-<!-- ##### VARIABLE gtk_debug_flags ##### -->
+<!-- ##### STRUCT GtkCellRendererTextPixbuf ##### -->
<para>
</para>
+@parent:
-<!-- ##### MACRO gtk_widget_set_visual ##### -->
+<!-- ##### ARG GtkColorSelection:previous-alpha ##### -->
<para>
</para>
-@w:
-@v:
-@widget:
-@visual:
-<!-- ##### FUNCTION gtk_widget_setv ##### -->
+<!-- ##### ARG GtkColorSelection:previous-color ##### -->
<para>
</para>
-@widget:
-@nargs:
-@args:
-<!-- ##### MACRO gtk_marshal_NONE__UINT_POINTER_UINT_ENUM_ENUM_POINTER ##### -->
+<!-- ##### SIGNAL GtkContainer::focus ##### -->
<para>
</para>
+@container: the object which received the signal.
+@direction:
+@Returns:
-<!-- ##### MACRO GTK_TYPE_SEQNO ##### -->
+<!-- ##### ARG GtkContainer:reallocate-redraws ##### -->
<para>
-Convert a gtk type into its sequence number
+
</para>
-@type:
-<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:See_Also ##### -->
+<!-- ##### STRUCT GtkData ##### -->
<para>
-
+The #GtkData-struct struct contains no public fields.
</para>
-<!-- ##### ENUM GtkMenuFactoryType ##### -->
+<!-- ##### 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>
-@GTK_MENU_FACTORY_MENU:
-@GTK_MENU_FACTORY_MENU_BAR:
-@GTK_MENU_FACTORY_OPTION_MENU:
+@data: the object which received the signal.
-<!-- ##### MACRO gtk_marshal_NONE__STRING ##### -->
+<!-- ##### 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.
-<!-- ##### MACRO gtk_marshal_NONE__POINTER_POINTER_UINT_UINT ##### -->
+<!-- ##### 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.
-<!-- ##### MACRO GTK_WIDGET_IS_OFFSCREEN ##### -->
+<!-- ##### 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>
-@obj:
+@editable: the object which received the signal.
-<!-- ##### MACRO GTK_MAX_COMPOSE_LEN ##### -->
+<!-- ##### 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.
-<!-- ##### FUNCTION gtk_text_iter_prev_char ##### -->
+<!-- ##### SIGNAL GtkEditable::kill-line ##### -->
<para>
-
+An action signal. Delete a single line.
</para>
-@iter:
-@Returns:
-
-<!-- ##### SECTION ./tmpl/gtkprivate.sgml:Short_Description ##### -->
-
-
+@editable: the object which received the signal.
+@direction: the direction in which to delete. Positive
+ indicates forward deletion, negative, backwards deletion.
-<!-- ##### SIGNAL GtkTextView::cut-text ##### -->
+<!-- ##### SIGNAL GtkEditable::kill-word ##### -->
<para>
-
+An action signal. Delete a single word.
</para>
-@textview: the object which received the signal.
+@editable: the object which received the signal.
+@direction: the direction in which to delete. Positive
+ indicates forward deletion, negative, backwards deletion.
-<!-- ##### FUNCTION gtk_theme_engine_unref ##### -->
+<!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
<para>
-
+An action signal. Move the cursor position.
</para>
-@engine:
+@editable: the object which received the signal.
+@x: horizontal distance to move the cursor.
+@y: vertical distance to move the cursor.
-<!-- ##### ARG GtkTextTag:left-wrapped-line-margin-set ##### -->
+<!-- ##### 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.
-<!-- ##### STRUCT GtkDialogButton ##### -->
+<!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
<para>
-Deprecated.
+An action signal. Move the cursor to the given column.
</para>
+@editable: the object which received the signal.
+@column: the column to move to. (A negative value indicates
+ the last column)
-<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER ##### -->
+<!-- ##### SIGNAL GtkEditable::move-to-row ##### -->
<para>
-
+An action signal. Move the cursor to the given row.
</para>
-@object:
-@func:
-@func_data:
-@args:
+@editable: the object which received the signal.
+@row: the row to move to. (A negative value indicates
+ the last row)
-<!-- ##### FUNCTION gtk_tree_store_getv ##### -->
+<!-- ##### SIGNAL GtkEditable::move-word ##### -->
<para>
-
+An action signal. Move the cursor by words.
</para>
-@tree_store:
-@iter:
-@var_args:
+@editable: the object which received the signal.
+@num_words: The number of words to move the
+cursor. (Can be negative).
-<!-- ##### FUNCTION gtk_text_buffer_cut ##### -->
+<!-- ##### SIGNAL GtkEditable::paste-clipboard ##### -->
<para>
-
+An action signal. Causes the contents of the clipboard to
+be pasted into the editable widget at the current cursor
+position.
</para>
-@buffer:
-@time:
-@interactive:
-@default_editable:
+@editable: the object which received the signal.
-<!-- ##### SIGNAL GtkEditable::activate ##### -->
+<!-- ##### SIGNAL GtkEditable::set-editable ##### -->
<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.)
+Determines if the user can edit the text in the editable
+widget or not. This is meant to be overriden by
+child classes and should not generally useful to
+applications.
</para>
@editable: the object which received the signal.
+@is_editable: %TRUE if the user is allowed to edit the text
+ in the widget.
-<!-- ##### ENUM GtkTextViewMovementStep ##### -->
+<!-- ##### ARG GtkEditable:editable ##### -->
<para>
-
+A boolean indicating whether the widget is editable by
+the user.
</para>
-@GTK_TEXT_MOVEMENT_CHAR:
-@GTK_TEXT_MOVEMENT_POSITIONS:
-@GTK_TEXT_MOVEMENT_WORD:
-@GTK_TEXT_MOVEMENT_WRAPPED_LINE:
-@GTK_TEXT_MOVEMENT_LINE:
-@GTK_TEXT_MOVEMENT_LINE_ENDS:
-@GTK_TEXT_MOVEMENT_BUFFER_ENDS:
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER_INT_INT ##### -->
+<!-- ##### ARG GtkEditable:text-position ##### -->
<para>
+The position of the cursor.
+</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:
-@func:
-@func_data:
-@args:
+@signal_id:
+@n_params:
+@params:
+@data:
+@Returns:
-<!-- ##### ARG GtkTextTag:left-wrapped-line-margin ##### -->
+<!-- ##### SIGNAL GtkEntry::changed ##### -->
<para>
-Pixel width of the left margin of the text for lines after the first
-line in a wrapped paragraph.
+
</para>
+@entry: the object which received the signal.
-<!-- ##### SECTION ./tmpl/gtkdebug.sgml:See_Also ##### -->
+<!-- ##### SIGNAL GtkEntry::delete-text ##### -->
<para>
</para>
+@entry: the object which received the signal.
+@arg1:
+@arg2:
-<!-- ##### FUNCTION gtk_paint_oval ##### -->
+<!-- ##### SIGNAL GtkEntry::insert-text ##### -->
<para>
</para>
-@style:
-@window:
-@state_type:
-@shadow_type:
-@area:
-@widget:
-@detail:
-@x:
-@y:
-@width:
-@height:
+@entry: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
-<!-- ##### MACRO GTK_CONTAINER_RESIZE_PENDING ##### -->
+<!-- ##### ARG GtkEntry:text-position ##### -->
<para>
</para>
-@obj:
-<!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
+<!-- ##### ENUM GtkFontFilterType ##### -->
<para>
-An action signal. Causes the characters in the current selection to
-be copied to the clipboard.
+A set of bit flags used to specify the filter being set
+when calling gtk_font_selection_dialog_set_filter() or
+gtk_font_selection_set_filter().
</para>
-@editable: the object which received the signal.
+@GTK_FONT_FILTER_BASE: the base filter, which can't be changed by the user.
+@GTK_FONT_FILTER_USER: the user filter, which can be changed from within the
+'Filter' page of the #GtkFontSelection widget.
-<!-- ##### FUNCTION gtk_clist_construct ##### -->
+<!-- ##### ENUM GtkFontType ##### -->
<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.
+A set of bit flags used to specify the type of fonts shown
+when calling gtk_font_selection_dialog_set_filter() or
+gtk_font_selection_set_filter().
</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.
+@GTK_FONT_BITMAP: bitmap fonts.
+@GTK_FONT_SCALABLE: scalable fonts.
+@GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
+@GTK_FONT_ALL: a bitwise combination of all of the above.
-<!-- ##### FUNCTION gtk_menu_factory_remove_entries ##### -->
+<!-- ##### ARG GtkHScale:adjustment ##### -->
<para>
-
+the #GtkAdjustment which sets the range of the scale.
</para>
-@factory:
-@entries:
-@nentries:
-<!-- ##### FUNCTION gtk_tree_view_move_to ##### -->
+<!-- ##### ARG GtkHScrollbar:adjustment ##### -->
<para>
</para>
-@tree_view:
-@path:
-@column:
-@row_align:
-@col_align:
-<!-- ##### FUNCTION gtk_text_buffer_find_string ##### -->
+<!-- ##### USER_FUNCTION GtkImageLoader ##### -->
<para>
-
+A GtkImageLoader is used to load a filename found in
+a RC file.
</para>
-@buffer:
-@iter:
-@str:
-@start:
-@end:
-@Returns:
+@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
-<!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER_INT_INT_INT_POINTER ##### -->
+<!-- ##### STRUCT GtkImageMenuItemClass ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### FUNCTION gtk_marshal_INT__INT ##### -->
+<!-- ##### ARG GtkLabel:accel-keyval ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### FUNCTION gtk_marshal_NONE__INT_FLOAT_BOOL ##### -->
+<!-- ##### SIGNAL GtkMenuBar::cycle-focus ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
+@menubar: the object which received the signal.
+@arg1:
-<!-- ##### FUNCTION gtk_paned_compute_position ##### -->
+<!-- ##### ARG GtkObject:object-signal ##### -->
<para>
-Internal function used by #GtkHPaned and #GtkVPaned
+Setting this with a GtkType of GTK_TYPE_SIGNAL connects
+the signal to the object, so that the user data and objects
+and swapped when the signal handler is invoked.
+</para>
+<para>
+This is useful for handlers that are primarily notifying
+other objects and could just invoke an already existing function
+if the parameters were swapped.
+See gtk_signal_connect_object() for more details.
</para>
-@paned:
-@allocation:
-@child1_req:
-@child2_req:
-<!-- ##### MACRO gtk_marshal_NONE__POINTER_STRING_STRING ##### -->
+<!-- ##### ARG GtkObject:object-signal-after ##### -->
+<para>
+Setting this with a GtkType of GTK_TYPE_SIGNAL connects
+the signal to the object, so that the user data and objects
+and swapped when the signal handler is invoked,
+and so that the handler is invoked after all others.
+</para>
<para>
+See gtk_signal_connect_object_after() for more details.
+</para>
+
+<!-- ##### ARG GtkObject:signal ##### -->
+<para>
+Setting this with a GtkType of GTK_TYPE_SIGNAL connects
+the signal to the object.
</para>
-<!-- ##### FUNCTION gtk_trace_referencing ##### -->
+<!-- ##### ARG GtkObject:signal-after ##### -->
<para>
-Private: print debugging information while doing a gtk_object_ref() or
-a gtk_object_unref().
+Setting this with a GtkType of GTK_TYPE_SIGNAL connects
+the signal to the object, so that the signal is always run
+after other user handlers and the default handler.
</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.
-<!-- ##### MACRO GTK_VALUE_CALLBACK ##### -->
+<!-- ##### SIGNAL GtkOldEditable::changed ##### -->
<para>
-Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK
+
</para>
-@a:
+@oldeditable: the object which received the signal.
-<!-- ##### MACRO gtk_marshal_NONE__ENUM_FLOAT_BOOL ##### -->
+<!-- ##### SIGNAL GtkOldEditable::delete-text ##### -->
<para>
</para>
+@oldeditable: the object which received the signal.
+@arg1:
+@arg2:
-<!-- ##### FUNCTION gtk_object_args_collect ##### -->
+<!-- ##### SIGNAL GtkOldEditable::insert-text ##### -->
<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.
+@oldeditable: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
-<!-- ##### ENUM GtkFontType ##### -->
+<!-- ##### STRUCT GtkPacker ##### -->
<para>
-A set of bit flags used to specify the type of fonts shown
-when calling gtk_font_selection_dialog_set_filter() or
-gtk_font_selection_set_filter().
+
</para>
-@GTK_FONT_BITMAP: bitmap fonts.
-@GTK_FONT_SCALABLE: scalable fonts.
-@GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
-@GTK_FONT_ALL: a bitwise combination of all of the above.
+@parent:
+@children:
+@spacing:
+@default_border_width:
+@default_pad_x:
+@default_pad_y:
+@default_i_pad_x:
+@default_i_pad_y:
-<!-- ##### MACRO GTK_TYPE_STRUCTURED_LAST ##### -->
+<!-- ##### ARG GtkPacker:default-border-width ##### -->
<para>
-The last structured enumerated type value.
+
</para>
-<!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
+<!-- ##### ARG GtkPacker:default-ipad-x ##### -->
<para>
-Get the number of signals defined by this object.
+
</para>
-@obj: the object to query.
-<!-- ##### FUNCTION gtk_object_arg_get ##### -->
+<!-- ##### ARG GtkPacker:default-ipad-y ##### -->
<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_menu_factory_remove_subfactory ##### -->
+<!-- ##### ARG GtkPacker:default-pad-x ##### -->
<para>
</para>
-@factory:
-@subfactory:
-@path:
-<!-- ##### FUNCTION gtk_type_children_types ##### -->
+<!-- ##### ARG GtkPacker:default-pad-y ##### -->
<para>
-Return the pointer to the type's children's types.
+
</para>
-@type: GtkType
-@Returns: pointer to a GList
-<!-- ##### SIGNAL GtkEditable::move-page ##### -->
+<!-- ##### ARG GtkPacker:spacing ##### -->
<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.
-<!-- ##### FUNCTION gtk_type_register_flags ##### -->
+<!-- ##### STRUCT GtkPackerChild ##### -->
<para>
-Register a new set of flags @values and give them the name in
-@type_name.
+
</para>
-@type_name: must not be null.
-@values: GtkFlagValue*
-@Returns:
+@widget:
+@anchor:
+@side:
+@options:
+@use_default:
+@border_width:
+@pad_x:
+@pad_y:
+@i_pad_x:
+@i_pad_y:
-<!-- ##### SIGNAL GtkTextView::scroll-text ##### -->
+<!-- ##### ENUM GtkPackerOptions ##### -->
<para>
</para>
-@textview: the object which received the signal.
-@arg1:
+@GTK_PACK_EXPAND:
+@GTK_FILL_X:
+@GTK_FILL_Y:
+
+<!-- ##### STRUCT GtkPatternSpec ##### -->
+<para>
+
+</para>
+
+@match_type:
+@pattern_length:
+@pattern:
+@pattern_reversed:
+@user_data:
+@seq_id:
<!-- ##### ENUM GtkPrivateFlags ##### -->
<para>
@PRIVATE_GTK_DIRECTION_SET:
@PRIVATE_GTK_DIRECTION_LTR:
-<!-- ##### FUNCTION gtk_type_set_chunk_alloc ##### -->
+<!-- ##### STRUCT GtkRcStyleClass ##### -->
<para>
-Set the mem_chunk size so it will hold @n_chunks of the objects of that @type.
+
</para>
-@type: There must be an unlocked TypeNode associated with this type otherwise nothing happens.
-@n_chunks:
-<!-- ##### FUNCTION gtk_draw_oval ##### -->
+<!-- ##### ARG GtkScrolledWindow:shadow ##### -->
<para>
</para>
-@style:
-@window:
-@state_type:
-@shadow_type:
-@x:
-@y:
-@width:
-@height:
-<!-- ##### MACRO GTK_TYPE_STRUCTURED_FIRST ##### -->
+<!-- ##### ARG GtkSettings:gtk-can-change-accels ##### -->
<para>
-The first structured enumerated type value.
-</para>
-
-<!-- ##### 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:
-<!-- ##### FUNCTION gtk_type_describe_tree ##### -->
+<!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
<para>
-Given a @type, describe all of its children, and their children. Only
-show the size if @show_size is true.
+
</para>
-@type: GtkType
-@show_size: gboolean
-<!-- ##### FUNCTION gtk_text_mark_is_visible ##### -->
+<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
<para>
</para>
-@mark:
-@Returns:
-<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_INT_INT_INT ##### -->
+<!-- ##### ARG GtkSettings:gtk-cursor-blink-time ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### SIGNAL GtkEditable::kill-char ##### -->
+<!-- ##### ARG GtkSettings:gtk-dnd-drag-threshold ##### -->
<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.
-<!-- ##### SECTION ./tmpl/gtkdebug.sgml:Long_Description ##### -->
+<!-- ##### ARG GtkSettings:gtk-double-click-time ##### -->
<para>
</para>
-<!-- ##### FUNCTION gtk_window_remove_embedded_xid ##### -->
+<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
<para>
</para>
-@window:
-@xid:
-<!-- ##### FUNCTION gtk_marshal_NONE__INT_FLOAT ##### -->
+<!-- ##### ARG GtkSettings:gtk-font-name ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### FUNCTION gtk_text_iter_get_pixmap ##### -->
+<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
<para>
</para>
-@iter:
-@pixmap:
-@mask:
-@Returns:
-<!-- ##### SIGNAL GtkEditable::kill-word ##### -->
+<!-- ##### ARG GtkSettings:gtk-key-theme-name ##### -->
<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.
-<!-- ##### FUNCTION gtk_im_context_simple_add_table ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-bar-accel ##### -->
<para>
</para>
-@context_simple:
-@data:
-@max_seq_len:
-@n_seqs:
-<!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT_UINT ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-bar-popout-delay ##### -->
<para>
</para>
-<!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-bar-popup-delay ##### -->
<para>
-Test whether a GtkObject's arguments have been prepared.
-</para>
-@obj: the object to examine.
-
-<!-- ##### 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.
-<!-- ##### SIGNAL GtkTextView::delete-text ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-popdown-delay ##### -->
<para>
</para>
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-<!-- ##### FUNCTION gtk_container_get_toplevels ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-popout-delay ##### -->
<para>
</para>
-@Returns:
-<!-- ##### MACRO GTK_TYPE_NUM_BUILTINS ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-popup-delay ##### -->
<para>
-No idea.
+
</para>
-<!-- ##### MACRO GTK_TYPE_MAKE ##### -->
+<!-- ##### ARG GtkSettings:gtk-menu-submenu-hysteresis ##### -->
<para>
-Combine a fundemantal type and a sequence number to create a gtk type.
-</para>
-
-@parent_t:
-@seqno:
-<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Short_Description ##### -->
-Functions to adapt C structures to native calling convention.
+</para>
-<!-- ##### MACRO GTK_TYPE_FLAT_LAST ##### -->
+<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
<para>
-The last "flat" (no struct) enumerated type value.
+
</para>
-<!-- ##### FUNCTION gtk_tree_selection_set_tree_view ##### -->
+<!-- ##### ARG GtkSettings:gtk-theme-name ##### -->
<para>
</para>
-@selection:
-@tree_view:
-<!-- ##### FUNCTION gtk_text_mark_unref ##### -->
+<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
<para>
</para>
-@mark:
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER ##### -->
+<!-- ##### ARG GtkSettings:gtk-toolbar-style ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_POINTER ##### -->
+<!-- ##### STRUCT GtkSettingsClass ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
+<!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
<para>
-Destroy all the signal handlers connected to an object.
-This is done automatically when the object is destroyed.
+A function which you can use to clean up when the
+signal handler is destroyed.
</para>
<para>
-This function is labeled private.
+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: the object whose signal handlers should be destroyed.
+@data: The user data associated with the hook that is being
+destroyed.
-<!-- ##### FUNCTION gtk_text_iter_in_region ##### -->
+<!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
<para>
-
+This is currently a hack left in for a scheme wrapper library.
+It may be removed.
</para>
-
-@iter:
-@start:
-@end:
-@Returns:
-
-<!-- ##### FUNCTION gtk_type_get_varargs_type ##### -->
<para>
-Get the varargs type associated with @foreign_type
+Don't use it.
</para>
-@foreign_type: GtkType
-@Returns: GtkType
+@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.
-<!-- ##### SIGNAL GtkEditable::changed ##### -->
+<!-- ##### STRUCT GtkSignalQuery ##### -->
<para>
-Indicates that the user has changed the contents
-of the widget.
+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>
-@editable: the object which received the signal.
+@object_type:
+@signal_id:
+@signal_name:
+@is_user_signal:
+@signal_flags:
+@return_val:
+@nparams:
+@params:
-<!-- ##### FUNCTION gtk_tree_view_column_get_size ##### -->
+<!-- ##### 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>
-@tree_column:
-@Returns:
+@text:
+@context_id:
+@message_id:
-<!-- ##### STRUCT GtkMenuFactory ##### -->
+<!-- ##### STRUCT GtkStyleClass ##### -->
<para>
</para>
-@path:
-@type:
-@accel_group:
-@widget:
-@subfactories:
+@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:
-<!-- ##### SIGNAL GtkTextView::delete-at-cursor ##### -->
+<!-- ##### STRUCT GtkTextBTreeNode ##### -->
<para>
</para>
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-<!-- ##### MACRO GTK_VALUE_FOREIGN ##### -->
+<!-- ##### STRUCT GtkTextChildAnchorClass ##### -->
<para>
-Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
+
</para>
-@a:
-<!-- ##### FUNCTION gtk_object_class_user_signal_new ##### -->
+<!-- ##### ARG GtkTextTag:justify ##### -->
<para>
-Define a signal-handler for a new signal on an already defined
-object.
+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>
-See the signal documentation for more general information.
+Pixel width of the left margin of the text for lines after the first
+line in a wrapped paragraph.
</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)
-<!-- ##### SIGNAL GtkTextView::paste-text ##### -->
+<!-- ##### ARG GtkTextTag:left-wrapped-line-margin-set ##### -->
<para>
</para>
-@textview: the object which received the signal.
-<!-- ##### MACRO GTK_PRIVATE_SET_FLAG ##### -->
+<!-- ##### 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>
-@wid:
-@flag:
-<!-- ##### FUNCTION gtk_ruler_draw_pos ##### -->
+<!-- ##### ARG GtkTextView:justify ##### -->
<para>
</para>
-@ruler: the gtkruler
-<!-- ##### FUNCTION gtk_object_newv ##### -->
+<!-- ##### ARG GtkTextView:width-columns ##### -->
<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.
-<!-- ##### MACRO GTK_WIDGET_USER_STYLE ##### -->
+<!-- ##### ARG GtkToolButton:show-label-horizontally ##### -->
<para>
</para>
-@obj:
-<!-- ##### FUNCTION gtk_text_iter_forward_to_newline ##### -->
+<!-- ##### STRUCT GtkTreeSelectionClass ##### -->
<para>
</para>
-@iter:
-@Returns:
-<!-- ##### ENUM GtkDebugFlag ##### -->
+<!-- ##### ENUM GtkTreeSelectionMode ##### -->
<para>
</para>
-@GTK_DEBUG_OBJECTS:
-@GTK_DEBUG_MISC:
-@GTK_DEBUG_SIGNALS:
-@GTK_DEBUG_DND:
-@GTK_DEBUG_PLUGSOCKET:
+@GTK_TREE_SELECTION_SINGLE:
+@GTK_TREE_SELECTION_MULTI:
-<!-- ##### FUNCTION gtk_menu_factory_remove_paths ##### -->
+<!-- ##### SIGNAL GtkTreeView::focus-column-header ##### -->
<para>
</para>
-@factory:
-@paths:
-@npaths:
+@treeview: the object which received the signal.
-<!-- ##### FUNCTION gtk_type_query ##### -->
+<!-- ##### USER_FUNCTION GtkTreeViewDraggableFunc ##### -->
<para>
-Given a type, return various interesting parameters of the type.
+
</para>
-@type: GtkType
-@Returns: GtkTypeQuery*
+@tree_view:
+@context:
+@path:
+@user_data:
+@Returns:
-<!-- ##### ENUM GtkTreeViewColumnType ##### -->
+<!-- ##### USER_FUNCTION GtkTreeViewDroppableFunc ##### -->
<para>
</para>
-@GTK_TREE_VIEW_COLUMN_RESIZEABLE:
-@GTK_TREE_VIEW_COLUMN_AUTOSIZE:
-@GTK_TREE_VIEW_COLUMN_FIXED:
+@tree_view:
+@context:
+@path:
+@pos:
+@user_data:
+@Returns:
-<!-- ##### SECTION ./tmpl/gtkprivate.sgml:Long_Description ##### -->
+<!-- ##### SIGNAL GtkUIManager::changed ##### -->
<para>
</para>
+@uimanager: the object which received the signal.
-<!-- ##### MACRO GTK_TYPE_IDENTIFIER ##### -->
+<!-- ##### ARG GtkVScale:adjustment ##### -->
<para>
-Hide the name of gtk_identifier_get_type
+the #GtkAdjustment which sets the range of the scale.
</para>
-<!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER_INT_INT_INT ##### -->
+<!-- ##### ARG GtkVScrollbar:adjustment ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### MACRO gtk_marshal_NONE__ENUM ##### -->
+<!-- ##### SIGNAL GtkWidget::activate-mnemonic ##### -->
<para>
</para>
+@widget: the object which received the signal.
+@arg1:
+@Returns:
-<!-- ##### FUNCTION gtk_ctree_construct ##### -->
+<!-- ##### SIGNAL GtkWidget::add-accelerator ##### -->
<para>
-This function is not usually used by users.
+
</para>
-@ctree:
-@columns:
-@tree_column:
-@titles:
+@widget: the object which received the signal.
+@accel_signal_id:
+@accel_group:
+@accel_key:
+@accel_mods:
+@accel_flags:
-<!-- ##### FUNCTION gtk_draw_cross ##### -->
+<!-- ##### SIGNAL GtkWidget::debug-msg ##### -->
<para>
</para>
-@style:
-@window:
-@state_type:
-@shadow_type:
-@x:
-@y:
-@width:
-@height:
+@widget: the object which received the signal.
+@message:
-<!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
+<!-- ##### SIGNAL GtkWidget::draw ##### -->
<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.
+@widget: the object which received the signal.
+@area:
-<!-- ##### FUNCTION gtk_tree_selection_new ##### -->
+<!-- ##### SIGNAL GtkWidget::draw-default ##### -->
<para>
</para>
-@Returns:
+@widget: the object which received the signal.
-<!-- ##### MACRO GTK_PRIVATE_FLAGS ##### -->
+<!-- ##### SIGNAL GtkWidget::draw-focus ##### -->
<para>
</para>
-@wid:
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_model_simple_new ##### -->
+<!-- ##### SIGNAL GtkWidget::remove-accelerator ##### -->
<para>
</para>
-@Returns:
+@widget: the object which received the signal.
+@accel_group:
+@accel_key:
+@accel_mods:
-<!-- ##### FUNCTION gtk_marshal_BOOL__NONE ##### -->
+<!-- ##### ARG GtkWidget:height ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### FUNCTION gtk_type_free ##### -->
+<!-- ##### ARG GtkWidget:width ##### -->
<para>
-Given the type of an object and a pointer to it, the object is freed.
+
</para>
-@type: GtkType
-@mem: gpointer to the object
-<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Short_Description ##### -->
+<!-- ##### ARG GtkWidget:x ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER_POINTER ##### -->
+<!-- ##### ARG GtkWidget:y ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
-<!-- ##### STRUCT GtkMenuPath ##### -->
+<!-- ##### SIGNAL GtkWindow::accels-changed ##### -->
<para>
</para>
-@path:
-@widget:
+@window: the object which received the signal.
-<!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT ##### -->
+<!-- ##### ARG GtkWindow:auto-shrink ##### -->
<para>
-
+If the window shrinks automatically when widgets within it shrink.
</para>
-<!-- ##### STRUCT GtkStatusbarMsg ##### -->
+<!-- ##### ARG GtkWindow:icon-list ##### -->
<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:
-<!-- ##### FUNCTION gtk_widget_render_stock_icon ##### -->
+<!-- ##### FUNCTION gtk_accel_group_activate ##### -->
<para>
</para>
-@widget:
-@stock_id:
-@size:
-@detail:
+@accel_group:
+@accel_key:
+@accel_mods:
@Returns:
-<!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### -->
-Private Information
+<!-- ##### FUNCTION gtk_accel_group_add ##### -->
+<para>
+</para>
-<!-- ##### ARG GtkEditable:text-position ##### -->
+@accel_group:
+@path:
+@accel_key:
+@accel_mods:
+@accel_flags:
+@object:
+@accel_signal:
+
+<!-- ##### FUNCTION gtk_accel_group_attach ##### -->
<para>
-The position of the cursor.
+
</para>
+@accel_group:
+@object:
-<!-- ##### FUNCTION gtk_theme_engine_register_type ##### -->
+<!-- ##### FUNCTION gtk_accel_group_create_add ##### -->
<para>
</para>
-@engine:
-@parent_type:
-@type_name:
-@type_info:
+@class_type:
+@signal_flags:
+@handler_offset:
@Returns:
-<!-- ##### FUNCTION gtk_menu_factory_find ##### -->
+<!-- ##### FUNCTION gtk_accel_group_create_remove ##### -->
<para>
</para>
-@factory:
-@path:
+@class_type:
+@signal_flags:
+@handler_offset:
@Returns:
-<!-- ##### STRUCT GtkMenuEntry ##### -->
+<!-- ##### FUNCTION gtk_accel_group_detach ##### -->
<para>
</para>
-@path:
-@accelerator:
-@callback:
-@callback_data:
-@widget:
+@accel_group:
+@object:
-<!-- ##### SIGNAL GtkEditable::paste-clipboard ##### -->
+<!-- ##### FUNCTION gtk_accel_group_entries_from_object ##### -->
<para>
-An action signal. Causes the contents of the clipboard to
-be pasted into the editable widget at the current cursor
-position.
+
</para>
-@editable: the object which received the signal.
+@object:
+@Returns:
-<!-- ##### FUNCTION gtk_window_add_embedded_xid ##### -->
+<!-- ##### FUNCTION gtk_accel_group_get_default ##### -->
<para>
</para>
-@window:
-@xid:
+@Returns:
-<!-- ##### FUNCTION gtk_tree_view_column_set_header_active ##### -->
+<!-- ##### FUNCTION gtk_accel_group_get_entry ##### -->
<para>
</para>
-@tree_column:
-@active:
+@accel_group:
+@accel_key:
+@accel_mods:
+@Returns:
-<!-- ##### FUNCTION gtk_object_class_user_signal_newv ##### -->
+<!-- ##### FUNCTION gtk_accel_group_get_type ##### -->
<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)
+@Returns:
-<!-- ##### FUNCTION gtk_marshal_NONE__BOOL ##### -->
+<!-- ##### FUNCTION gtk_accel_group_handle_add ##### -->
<para>
</para>
@object:
-@func:
-@func_data:
-@args:
+@accel_signal_id:
+@accel_group:
+@accel_key:
+@accel_mods:
+@accel_flags:
-<!-- ##### FUNCTION gtk_tree_view_column_set_header_clickable ##### -->
+<!-- ##### FUNCTION gtk_accel_group_handle_remove ##### -->
<para>
</para>
-@tree_column:
-@active:
+@object:
+@accel_group:
+@accel_key:
+@accel_mods:
-<!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
+<!-- ##### FUNCTION gtk_accel_group_lock_entry ##### -->
<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.
+@accel_group:
+@accel_key:
+@accel_mods:
-<!-- ##### FUNCTION gtk_marshal_INT__POINTER ##### -->
+<!-- ##### FUNCTION gtk_accel_group_remove ##### -->
<para>
</para>
+@accel_group:
+@accel_key:
+@accel_mods:
@object:
-@func:
-@func_data:
-@args:
-<!-- ##### SECTION ./tmpl/gtkmarshal.sgml:See_Also ##### -->
+<!-- ##### FUNCTION gtk_accel_group_unlock_entry ##### -->
<para>
-<variablelist>
-
-<varlistentry>
-<term>#GtkSignal</term>
-<listitem><para>The signal handling functions (of which marshallers are
-really an implementation detail).</para></listitem>
-</varlistentry>
-</variablelist>
</para>
+@accel_group:
+@accel_key:
+@accel_mods:
-<!-- ##### SIGNAL GtkEditable::move-word ##### -->
+<!-- ##### FUNCTION gtk_accel_label_get_accel_object ##### -->
<para>
-An action signal. Move the cursor by words.
+
</para>
-@editable: the object which received the signal.
-@num_words: The number of words to move the
-cursor. (Can be negative).
+@accel_label:
+@Returns:
-<!-- ##### STRUCT GtkTreeViewPrivate ##### -->
+<!-- ##### FUNCTION gtk_accel_label_set_accel_object ##### -->
<para>
</para>
-@model:
-@flags:
-@tree:
-@tab_offset:
-@button_pressed_node:
-@button_pressed_tree:
-@children:
-@width:
-@height:
-@hadjustment:
-@vadjustment:
-@bin_window:
-@header_window:
-@anchor:
-@cursor:
-@cursor_drag:
-@xor_gc:
-@drag_pos:
-@x_drag:
-@prelight_node:
-@prelight_tree:
-@prelight_offset:
-@selection:
-@columns:
-@column:
-@header_height:
+@accel_label:
+@accel_object:
-<!-- ##### MACRO GTK_WIDGET_RESIZE_NEEDED ##### -->
+<!-- ##### FUNCTION gtk_accel_map_add_notifer ##### -->
<para>
</para>
-@obj:
+@accel_path:
+@notify_data:
+@notify_func:
+@accel_group:
-<!-- ##### MACRO GTK_NOTE ##### -->
+<!-- ##### FUNCTION gtk_accel_map_remove_notifer ##### -->
<para>
</para>
-@type:
-@action:
+@accel_path:
+@notify_data:
+@notify_func:
-<!-- ##### FUNCTION gtk_object_arg_set ##### -->
+<!-- ##### FUNCTION gtk_arg_copy ##### -->
<para>
-Private function to set an argument and argument info to an object.
+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>
-@object: the object whose argument should be set.
-@arg: the argument.
-@info: infomation about this type of argument in general.
+@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).
-<!-- ##### ENUM GtkTextViewDeleteType ##### -->
+<!-- ##### FUNCTION gtk_arg_free ##### -->
<para>
-
+Frees the argument, and optionally its contents.
</para>
-@GTK_TEXT_DELETE_CHAR:
-@GTK_TEXT_DELETE_HALF_WORD:
-@GTK_TEXT_DELETE_WHOLE_WORD:
-@GTK_TEXT_DELETE_HALF_WRAPPED_LINE:
-@GTK_TEXT_DELETE_WHOLE_WRAPPED_LINE:
-@GTK_TEXT_DELETE_HALF_LINE:
-@GTK_TEXT_DELETE_WHOLE_LINE:
-@GTK_TEXT_DELETE_WHITESPACE:
-@GTK_TEXT_DELETE_WHITESPACE_LEAVE_ONE:
+@arg: the argument to free.
+@free_contents: whether to free the string, if it is a string.
-<!-- ##### STRUCT GtkIMContextSimple ##### -->
+<!-- ##### FUNCTION gtk_arg_get_info ##### -->
<para>
-
+Private: get information about an argument.
</para>
-@object:
-@tables:
-@compose_buffer:
-@tentative_match:
-@tentative_match_len:
+@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.
-<!-- ##### MACRO GTK_TYPE_FLAT_FIRST ##### -->
+<!-- ##### FUNCTION gtk_arg_info_equal ##### -->
<para>
-The first "flat" (no struct) enumerated type value.
+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_widget_getv ##### -->
+<!-- ##### FUNCTION gtk_arg_info_hash ##### -->
<para>
-
+A #GHashFunc for hashing #GtkArgInfos.
</para>
-@widget:
-@nargs:
-@args:
+@arg_info: a #GtkArgInfo.
+@Returns: a hash value for that #GtkArgInfo.
-<!-- ##### FUNCTION gtk_tree_model_sort_resort ##### -->
+<!-- ##### 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>
-@tree_model_sort:
+@arg_name: the fully-qualified argument name.
+@Returns: the base argument name.
-<!-- ##### FUNCTION gtk_tree_view_column_get_col_type ##### -->
+<!-- ##### FUNCTION gtk_arg_new ##### -->
<para>
-
+Creates a new argument of a certain type, set to 0 or NULL.
</para>
-@tree_column:
-@Returns:
+@arg_type: the type of the argument.
+@Returns: the newly created #GtkArg.
-<!-- ##### FUNCTION gtk_menu_factory_new ##### -->
+<!-- ##### FUNCTION gtk_arg_reset ##### -->
<para>
</para>
-@type:
-@Returns:
+@arg:
-<!-- ##### FUNCTION gtk_object_constructed ##### -->
+<!-- ##### FUNCTION gtk_arg_to_valueloc ##### -->
<para>
-Mark an allocated object as constructed.
-This is used for situations
-that require precise control of the construction process.
+
</para>
+
+@arg:
+@value_pointer:
+
+<!-- ##### FUNCTION gtk_arg_type_new_static ##### -->
<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.
+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>
-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().
+@arg1:
+@arg2:
+@Returns:
-<!-- ##### FUNCTION gtk_object_default_construct ##### -->
+<!-- ##### FUNCTION gtk_args_collect ##### -->
<para>
-This function is called to construct arguments that haven't been initialized
-but have the #GTK_ARG_CONSTRUCT flag set.
+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>
-All number arguments are set to 0. All pointers and strings
-are set to NULL.
+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>
-Normally invoked by gtk_object_new() automatically; gtk_type_new() can
-be used to bypass it.
+Private: erase lists of arguments returned from gtk_args_collect().
</para>
-@object: the object to initialize.
+@arg_list: arg_list_p returned from gtk_args_collect().
+@info_list: info_list_p returned from gtk_args_collect().
-<!-- ##### MACRO gtk_marshal_NONE__UINT_POINTER_UINT_UINT_ENUM ##### -->
+<!-- ##### 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).
-<!-- ##### STRUCT GtkLabelWord ##### -->
+<!-- ##### FUNCTION gtk_button_box_child_requisition ##### -->
<para>\r
-Internal to #GtkLabel.\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_text_buffer_spew ##### -->
-<para>
-
+<!-- ##### 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>
-@buffer:
+@ipad_x: the default horizontal internal button padding.
+@ipad_y: the default vertical internal button padding.
-<!-- ##### ARG GtkTextTag:font-set ##### -->
-<para>
+<!-- ##### 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_object_arg_get_info ##### -->
-<para>
-Query information about an argument type.
+<!-- ##### FUNCTION gtk_button_box_set_child_size_default ##### -->
+<para>\r
+Sets the default size of child buttons.\r
</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.
+@min_width: minimum default width for child buttons.
+@min_height: minimum default height for child buttons.
-<!-- ##### ENUM GtkTreeSelectionType ##### -->
+<!-- ##### FUNCTION gtk_button_new_accel ##### -->
<para>
</para>
-@GTK_TREE_SELECTION_SINGLE:
-@GTK_TREE_SELECTION_MULTI:
+@uline_label:
+@accel_group:
+@Returns:
-<!-- ##### ARG GtkObject:signal-after ##### -->
+<!-- ##### FUNCTION gtk_button_new_stock ##### -->
<para>
-Setting this with a GtkType of GTK_TYPE_SIGNAL connects
-the signal to the object, so that the signal is always run
-after other user handlers and the default handler.
+
</para>
+@stock_id:
+@accel_group:
+@Returns:
-<!-- ##### STRUCT GtkTextTabArray ##### -->
+<!-- ##### FUNCTION gtk_cell_renderer_event ##### -->
<para>
</para>
+@cell:
+@event:
+@widget:
+@path:
+@background_area:
+@cell_area:
+@flags:
+@Returns:
-<!-- ##### ARG GtkTextTag:overstrike ##### -->
+<!-- ##### FUNCTION gtk_cell_renderer_text_pixbuf_new ##### -->
<para>
</para>
+@Returns:
-<!-- ##### MACRO GTK_TREE_SELECTION ##### -->
+<!-- ##### FUNCTION gtk_clist_construct ##### -->
<para>
-A macro that returns a GList that contains the selection of the root tree of @obj.
+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>
-@obj: A pointer to the #GtkTree. @obj will accept any pointer, but it the pointer does not point to a #GtkTree, the results are undefined.
+@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_editable_changed ##### -->
+<!-- ##### FUNCTION gtk_color_selection_get_old_color ##### -->
<para>
-Causes the "changed" signal to be emitted.
+
</para>
-@editable: a #GtkEditable widget.
+@colorsel:
+@color:
-<!-- ##### FUNCTION gtk_object_setv ##### -->
+<!-- ##### FUNCTION gtk_color_selection_get_use_opacity ##### -->
<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).
+@colorsel:
+@Returns:
-<!-- ##### SIGNAL GtkTextView::move ##### -->
+<!-- ##### FUNCTION gtk_color_selection_get_use_palette ##### -->
<para>
</para>
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
+@colorsel:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_HAS_SHAPE_MASK ##### -->
+<!-- ##### FUNCTION gtk_color_selection_set_old_color ##### -->
<para>
</para>
-@obj:
+@colorsel:
+@color:
-<!-- ##### FUNCTION gtk_text_buffer_copy ##### -->
+<!-- ##### 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>
-@buffer:
-@time:
+@colorsel: a #GtkColorSelection.
+@use_opacity: a boolean indicating whether the opacity selection
+is enabled.
-<!-- ##### FUNCTION gtk_text_mark_ref ##### -->
+<!-- ##### FUNCTION gtk_color_selection_set_use_opacity ##### -->
<para>
</para>
-@mark:
-@Returns:
+@colorsel:
+@use_opacity:
-<!-- ##### ARG GtkTextTag:offset ##### -->
+<!-- ##### FUNCTION gtk_color_selection_set_use_palette ##### -->
<para>
-Pixels to offset the text horizontally or vertically, useful to
-produce superscript and subscript.
+
</para>
+@colorsel:
+@use_palette:
-<!-- ##### SIGNAL GtkEditable::insert-text ##### -->
+<!-- ##### FUNCTION gtk_container_add_child_arg_type ##### -->
<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.
+
</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.
+@arg_name:
+@arg_type:
+@arg_flags:
+@arg_id:
-<!-- ##### FUNCTION gtk_editable_claim_selection ##### -->
+<!-- ##### FUNCTION gtk_container_add_with_args ##### -->
<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.
+@container:
+@widget:
+@first_arg_name:
+@Varargs:
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT ##### -->
+<!-- ##### FUNCTION gtk_container_addv ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
+@container:
+@widget:
+@n_args:
@args:
-<!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
+<!-- ##### FUNCTION gtk_container_arg_get ##### -->
<para>
-Get the array of signals defined for this object.
+
</para>
-@obj: the object to fetch the signals from.
+@container:
+@child:
+@arg:
+@info:
-<!-- ##### FUNCTION gtk_object_query_args ##### -->
-<para>
-Get all the arguments that may be used for a given type.
-</para>
+<!-- ##### FUNCTION gtk_container_arg_set ##### -->
<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().
+@container:
+@child:
+@arg:
+@info:
-<!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
+<!-- ##### FUNCTION gtk_container_child_arg_get_info ##### -->
<para>
-An action signal. Move the cursor to the given column.
-</para>
-
-@editable: the object which received the signal.
-@column: the column to move to. (A negative value indicates
- the last column)
-<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Title ##### -->
-gtkenums.sgml
+</para>
+@object_type:
+@arg_name:
+@info_p:
+@Returns:
-<!-- ##### FUNCTION gtk_marshal_NONE__INT_INT_POINTER ##### -->
+<!-- ##### FUNCTION gtk_container_child_args_collect ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
+@object_type:
+@arg_list_p:
+@info_list_p:
+@first_arg_name:
@args:
+@Returns:
-<!-- ##### USER_FUNCTION GtkMenuCallback ##### -->
+<!-- ##### FUNCTION gtk_container_child_getv ##### -->
<para>
</para>
-@widget:
-@user_data:
+@container:
+@child:
+@n_args:
+@args:
-<!-- ##### FUNCTION gtk_type_check_object_cast ##### -->
+<!-- ##### FUNCTION gtk_container_child_setv ##### -->
<para>
-Given a pointer to a GtkTypeObject @type_object, and a GtkType @cast_type,
-make sure that it's okay to cast @type_object into a @cast_type.
+
</para>
-@type_object: GtkTypeObject*
-@cast_type: GtkType
-@Returns: the same GtkTypeObject* as @type_object
+@container:
+@child:
+@n_args:
+@args:
-<!-- ##### FUNCTION gtk_tree_model_sort_set_sort_col ##### -->
+<!-- ##### FUNCTION gtk_container_dequeue_resize_handler ##### -->
<para>
</para>
-@tree_model_sort:
-@sort_col:
+@container:
-<!-- ##### FUNCTION gtk_themes_exit ##### -->
+<!-- ##### FUNCTION gtk_container_focus ##### -->
<para>
</para>
-@error_code:
+@container:
+@direction:
+@Returns:
-<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_POINTER_POINTER_POINTER ##### -->
+<!-- ##### FUNCTION gtk_container_query_child_args ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
+@class_type:
+@arg_flags:
+@nargs:
+@Returns:
-<!-- ##### MACRO gtk_marshal_NONE__OBJECT ##### -->
+<!-- ##### FUNCTION gtk_ctree_construct ##### -->
<para>
-
+This function is not usually used by users.
</para>
+@ctree:
+@columns:
+@tree_column:
+@titles:
-<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Long_Description ##### -->
+<!-- ##### FUNCTION gtk_drag_dest_handle_event ##### -->
<para>
-
+Internal function.
</para>
+@toplevel:
+@event:
-<!-- ##### FUNCTION gtk_type_set_varargs_type ##### -->
+<!-- ##### FUNCTION gtk_drag_source_handle_event ##### -->
<para>
-Set the varargs type for a fundamental type @foreign_type.
+Internal function.
</para>
-@foreign_type: Must be a GtkType with a sequence number of zero. Must not be a
-fundamental type.
-@varargs_type: Must be a GtkType which is either structured or flag, or NONE.
+@widget:
+@event:
-<!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
+<!-- ##### 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>
-Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
-sure that it's okay to cast something of that @klass into a @cast_type.
+
</para>
-@klass: GtkTypeClass*
-@cast_type: GtkType
-@Returns: Always return @klass.
+@pattern:
+@string:
+@Returns:
-<!-- ##### ARG GtkObject:object-signal-after ##### -->
+<!-- ##### FUNCTION gtk_pattern_match_string ##### -->
<para>
-Setting this with a GtkType of GTK_TYPE_SIGNAL connects
-the signal to the object, so that the user data and objects
-and swapped when the signal handler is invoked,
-and so that the handler is invoked after all others.
+
</para>
+
+@pspec:
+@string:
+@Returns:
+
+<!-- ##### FUNCTION gtk_pattern_spec_free_segs ##### -->
<para>
-See gtk_signal_connect_object_after() for more details.
+
</para>
+@pspec:
-<!-- ##### FUNCTION gtk_menu_factory_destroy ##### -->
+<!-- ##### FUNCTION gtk_pattern_spec_init ##### -->
<para>
</para>
-@factory:
+@pspec:
+@pattern:
-<!-- ##### FUNCTION gtk_paint_ramp ##### -->
+<!-- ##### 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>
-@style:
@window:
-@state_type:
-@shadow_type:
-@area:
+@event:
+@Returns:
+
+<!-- ##### FUNCTION gtk_selection_notify ##### -->
+<para>
+Internal function.
+</para>
+
@widget:
-@detail:
-@arrow_type:
-@x:
-@y:
-@width:
-@height:
+@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>
@Returns: the recursion depth of emissions of this signal for this
object.
-<!-- ##### FUNCTION gtk_text_buffer_insert_pixmap ##### -->
+<!-- ##### 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>
-@buffer:
-@iter:
-@pixmap:
-@mask:
+@object: the object with the signal handler.
+@name: the signal name.
+@Returns: the recursion depth of emissions of this signal for this
+object.
-<!-- ##### ARG GtkTextTag:justify-set ##### -->
+<!-- ##### 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_marshal_NONE__C_CALLBACK_C_CALLBACK ##### -->
+<!-- ##### 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>
-@object:
-@func:
-@func_data:
-@args:
+@spin_button: a #GtkSpinButton
+@shadow_type: the new border type.
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_INT_POINTER_INT_INT ##### -->
+<!-- ##### FUNCTION gtk_stock_list_items ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
+@Returns:
-<!-- ##### MACRO GTK_VALUE_ARGS ##### -->
+<!-- ##### FUNCTION gtk_style_get_font_for_display ##### -->
<para>
-Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
+
</para>
-@a:
+@display:
+@style:
+@Returns:
-<!-- ##### FUNCTION gtk_menu_factory_add_entries ##### -->
+<!-- ##### FUNCTION gtk_text_buffer_paste_primary ##### -->
<para>
</para>
-@factory:
-@entries:
-@nentries:
+@buffer:
+@override_location:
+@default_editable:
-<!-- ##### SIGNAL GtkEditable::move-to-row ##### -->
+<!-- ##### FUNCTION gtk_text_iter_reorder ##### -->
<para>
-An action signal. Move the cursor to the given row.
+
</para>
-@editable: the object which received the signal.
-@row: the row to move to. (A negative value indicates
- the last row)
+@first:
+@second:
-<!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
+<!-- ##### FUNCTION gtk_text_iter_spew ##### -->
<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>
+
+@iter:
+@desc:
+
+<!-- ##### FUNCTION gtk_text_view_set_text_window_size ##### -->
<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.
+@text_view:
+@width:
+@height:
-<!-- ##### FUNCTION gtk_im_context_simple_new ##### -->
+<!-- ##### FUNCTION gtk_tips_query_get_type ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION gtk_paint_cross ##### -->
+<!-- ##### FUNCTION gtk_tool_item_toolbar_reconfigured ##### -->
<para>
</para>
-@style:
-@window:
-@state_type:
-@shadow_type:
-@area:
-@widget:
-@detail:
-@x:
-@y:
-@width:
-@height:
+@tool_item:
-<!-- ##### ARG GtkObject:signal ##### -->
+<!-- ##### FUNCTION gtk_trace_referencing ##### -->
<para>
-Setting this with a GtkType of GTK_TYPE_SIGNAL connects
-the signal to the object.
+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.
+
+<!-- ##### FUNCTION gtk_tree_model_ref_iter ##### -->
+<para>
+
</para>
+@tree_model:
+@iter:
-<!-- ##### FUNCTION gtk_type_describe_heritage ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_convert_iter ##### -->
<para>
-Print the types @type inherits from.
+
</para>
-@type: GtkType
+@tree_model_sort:
+@sort_iter:
+@child_iter:
+
+<!-- ##### FUNCTION gtk_tree_model_sort_convert_path ##### -->
+<para>
+
+</para>
+
+@tree_model_sort:
+@child_path:
+@Returns:
+@path:
+
+<!-- ##### FUNCTION gtk_tree_model_sort_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gtk_tree_model_sort_set_compare ##### -->
+<para>
+
+</para>
+
+@tree_model_sort:
+@func:
-<!-- ##### FUNCTION gtk_text_buffer_set_clipboard_contents ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_set_model ##### -->
<para>
</para>
-@buffer:
-@text:
+@tree_model_sort:
+@child_model:
+@model:
-<!-- ##### ENUM GtkFontFilterType ##### -->
+<!-- ##### FUNCTION gtk_tree_model_sort_set_sort_column ##### -->
<para>
-A set of bit flags used to specify the filter being set
-when calling gtk_font_selection_dialog_set_filter() or
-gtk_font_selection_set_filter().
+
</para>
-@GTK_FONT_FILTER_BASE: the base filter, which can't be changed by the user.
-@GTK_FONT_FILTER_USER: the user filter, which can be changed from within the
-'Filter' page of the #GtkFontSelection widget.
+@tree_model_sort:
+@sort_col:
-<!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
+<!-- ##### FUNCTION gtk_tree_model_unref_iter ##### -->
<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.
+@tree_model:
+@iter:
-<!-- ##### FUNCTION gtk_type_parent_class ##### -->
+<!-- ##### FUNCTION gtk_tree_store_move ##### -->
<para>
-Return the class of the parent. Initialize the class if necessary.
-Return NULL if anything goes wrong.
+
</para>
-@type: GtkType
-@Returns: gpointer to the klass.
+@tree_store:
+@iter:
+@position:
-<!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
-<para>
-A function which you can use to clean up when the
-signal handler is destroyed.
-</para>
+<!-- ##### FUNCTION gtk_tree_store_new_with_types ##### -->
<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.
+@n_columns:
+@Varargs:
+@Returns:
-<!-- ##### FUNCTION gtk_window_set_default ##### -->
+<!-- ##### FUNCTION gtk_tree_store_set_cell ##### -->
<para>
</para>
-@window:
-@defaultw:
+@tree_store:
+@iter:
+@column:
+@value:
-<!-- ##### FUNCTION gtk_tree_store_setv ##### -->
+<!-- ##### FUNCTION gtk_tree_store_set_column_type ##### -->
<para>
</para>
@tree_store:
-@iter:
-@var_args:
+@column:
+@type:
+@store:
-<!-- ##### SIGNAL GtkTextBuffer::delete-text ##### -->
+<!-- ##### FUNCTION gtk_tree_store_set_n_columns ##### -->
<para>
</para>
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
+@tree_store:
+@n_columns:
-<!-- ##### FUNCTION gtk_tree_selection_new_with_tree_view ##### -->
+<!-- ##### FUNCTION gtk_tree_view_column_cell_event ##### -->
<para>
</para>
-@tree_view:
+@tree_column:
+@event:
+@path_string:
+@background_area:
+@cell_area:
+@flags:
@Returns:
-<!-- ##### FUNCTION gtk_marshal_NONE__INT ##### -->
+<!-- ##### FUNCTION gtk_tree_view_column_set_cell_data ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
+@tree_column:
+@tree_model:
+@iter:
-<!-- ##### ARG GtkObject:object-signal ##### -->
-<para>
-Setting this with a GtkType of GTK_TYPE_SIGNAL connects
-the signal to the object, so that the user data and objects
-and swapped when the signal handler is invoked.
-</para>
+<!-- ##### FUNCTION gtk_tree_view_column_set_cell_renderer ##### -->
<para>
-This is useful for handlers that are primarily notifying
-other objects and could just invoke an already existing function
-if the parameters were swapped.
-See gtk_signal_connect_object() for more details.
+
</para>
+@tree_column:
+@cell:
-<!-- ##### FUNCTION gtk_draw_ramp ##### -->
+<!-- ##### FUNCTION gtk_tree_view_column_set_width ##### -->
<para>
</para>
-@style:
-@window:
-@state_type:
-@shadow_type:
-@arrow_type:
-@x:
-@y:
+@tree_column:
@width:
-@height:
+@size:
-<!-- ##### MACRO GTK_WIDGET_LEAVE_PENDING ##### -->
+<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_dest ##### -->
<para>
</para>
-@obj:
+@tree_view:
+@targets:
+@n_targets:
+@actions:
+@location_droppable_func:
+@user_data:
-<!-- ##### MACRO gtk_marshal_NONE__UINT ##### -->
+<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_source ##### -->
<para>
</para>
+@tree_view:
+@start_button_mask:
+@targets:
+@n_targets:
+@actions:
+@row_draggable_func:
+@user_data:
-<!-- ##### MACRO GTK_WIDGET_IN_REPARENT ##### -->
+<!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
<para>
-
+Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
+sure that it's okay to cast something of that @klass into a @cast_type.
</para>
-@obj:
+@klass: GtkTypeClass*
+@cast_type: GtkType
+@Returns: Always return @klass.
-<!-- ##### FUNCTION gtk_accel_group_marshal_add ##### -->
+<!-- ##### FUNCTION gtk_type_check_object_cast ##### -->
<para>
-
+Given a pointer to a GtkTypeObject @type_object, and a GtkType @cast_type,
+make sure that it's okay to cast @type_object into a @cast_type.
</para>
-@object:
-@func:
-@func_data:
-@args:
+@type_object: GtkTypeObject*
+@cast_type: GtkType
+@Returns: the same GtkTypeObject* as @type_object
-<!-- ##### FUNCTION gtk_tree_view_column_set_col_type ##### -->
+<!-- ##### FUNCTION gtk_type_children_types ##### -->
<para>
-
+Return the pointer to the type's children's types.
</para>
-@tree_column:
-@type:
+@type: GtkType
+@Returns: pointer to a GList
-<!-- ##### ARG GtkTextTag:overstrike-set ##### -->
+<!-- ##### FUNCTION gtk_type_describe_heritage ##### -->
<para>
-
+Print the types @type inherits from.
</para>
+@type: GtkType
-<!-- ##### FUNCTION gtk_marshal_INT__POINTER_CHAR_CHAR ##### -->
+<!-- ##### FUNCTION gtk_type_describe_tree ##### -->
<para>
-
+Given a @type, describe all of its children, and their children. Only
+show the size if @show_size is true.
</para>
-@object:
-@func:
-@func_data:
-@args:
+@type: GtkType
+@show_size: gboolean
-<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_INT ##### -->
+<!-- ##### FUNCTION gtk_type_free ##### -->
<para>
-
+Given the type of an object and a pointer to it, the object is freed.
</para>
-@object:
-@func:
-@func_data:
-@args:
+@type: GtkType
+@mem: gpointer to the object
-<!-- ##### FUNCTION gtk_accel_group_marshal_remove ##### -->
+<!-- ##### FUNCTION gtk_type_get_varargs_type ##### -->
<para>
-
+Get the varargs type associated with @foreign_type
</para>
-@object:
-@func:
-@func_data:
-@args:
+@foreign_type: GtkType
+@Returns: GtkType
-<!-- ##### SIGNAL GtkWidget::draw ##### -->
+<!-- ##### FUNCTION gtk_type_parent_class ##### -->
<para>
-
+Return the class of the parent. Initialize the class if necessary.
+Return NULL if anything goes wrong.
</para>
-@widget: the object which received the signal.
-@area:
+@type: GtkType
+@Returns: gpointer to the klass.
-<!-- ##### MACRO gtk_marshal_NONE__STRING_INT_POINTER ##### -->
+<!-- ##### FUNCTION gtk_type_query ##### -->
<para>
-
+Given a type, return various interesting parameters of the type.
</para>
+@type: GtkType
+@Returns: GtkTypeQuery*
-<!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER ##### -->
+<!-- ##### FUNCTION gtk_type_register_enum ##### -->
<para>
-
+Register a new set of enum @values and give them the name in
+@type_name.
</para>
-@object:
-@func:
-@func_data:
-@args:
+@type_name: must not be null.
+@values: GtkEnumValue*
+@Returns:
-<!-- ##### FUNCTION gtk_rc_init ##### -->
+<!-- ##### FUNCTION gtk_type_register_flags ##### -->
<para>
-Internal function.
+Register a new set of flags @values and give them the name in
+@type_name.
</para>
+@type_name: must not be null.
+@values: GtkFlagValue*
+@Returns:
-<!-- ##### FUNCTION gtk_signal_query ##### -->
+<!-- ##### FUNCTION gtk_type_set_chunk_alloc ##### -->
<para>
-Obtain information about a signal.
+Set the mem_chunk size so it will hold @n_chunks of the objects of that @type.
</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.
+@type: There must be an unlocked TypeNode associated with this type otherwise nothing happens.
+@n_chunks:
-<!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
+<!-- ##### FUNCTION gtk_type_set_varargs_type ##### -->
<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.
+Set the varargs type for a fundamental type @foreign_type.
</para>
-@object: the object with the signal handler.
-@name: the signal name.
-@Returns: the recursion depth of emissions of this signal for this
-object.
+@foreign_type: Must be a GtkType with a sequence number of zero. Must not be a
+fundamental type.
+@varargs_type: Must be a GtkType which is either structured or flag, or NONE.
-<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:See_Also ##### -->
+<!-- ##### FUNCTION gtk_widget_accelerator_signal ##### -->
<para>
</para>
+@widget:
+@accel_group:
+@accel_key:
+@accel_mods:
+@Returns:
-<!-- ##### SIGNAL GtkTextView::delete ##### -->
+<!-- ##### FUNCTION gtk_widget_accelerators_locked ##### -->
<para>
</para>
-@textview: the object which received the signal.
-@arg1:
-@arg2:
+@widget:
+@Returns:
-<!-- ##### MACRO gtk_marshal_ENUM__ENUM ##### -->
+<!-- ##### FUNCTION gtk_widget_activate_mnemonic ##### -->
<para>
</para>
+@widget:
+@group_cycling:
+@Returns:
-<!-- ##### MACRO gtk_widget_push_visual ##### -->
+<!-- ##### FUNCTION gtk_widget_get_usize ##### -->
<para>
</para>
-@v:
-@visual:
+@widget:
+@width:
+@height:
-<!-- ##### FUNCTION gtk_container_register_toplevel ##### -->
+<!-- ##### FUNCTION gtk_widget_lock_accelerators ##### -->
<para>
</para>
-@container:
-
-<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Title ##### -->
-GtkIMContextSimple
-
+@widget:
-<!-- ##### MACRO gtk_marshal_NONE__POINTER_INT_INT_POINTER_UINT_UINT ##### -->
+<!-- ##### FUNCTION gtk_widget_pop_style ##### -->
<para>
</para>
-<!-- ##### MACRO GTK_VALUE_C_CALLBACK ##### -->
+<!-- ##### FUNCTION gtk_widget_popup ##### -->
<para>
-Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
+
</para>
-@a:
+@widget:
+@x:
+@y:
-<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_POINTER_INT_INT ##### -->
+<!-- ##### FUNCTION gtk_widget_push_style ##### -->
<para>
</para>
-@object:
-@func:
-@func_data:
-@args:
+@style:
-<!-- ##### SIGNAL GtkTextView::move-insert ##### -->
+<!-- ##### FUNCTION gtk_widget_remove_accelerators ##### -->
<para>
</para>
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
+@widget:
+@accel_signal:
+@visible_only:
-<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Long_Description ##### -->
+<!-- ##### FUNCTION gtk_widget_set_default_style ##### -->
<para>
</para>
+@style:
-<!-- ##### FUNCTION gtk_tree_view_set_headers_active ##### -->
+<!-- ##### FUNCTION gtk_widget_unlock_accelerators ##### -->
<para>
</para>
-@tree_view:
-@active:
+@widget:
-<!-- ##### FUNCTION gtk_text_buffer_find_regexp ##### -->
+<!-- ##### FUNCTION gtk_window_activate_mnemonic ##### -->
<para>
</para>
-@buffer:
-@regexp:
-@start:
-@end:
+@window:
+@keyval:
+@modifier:
@Returns:
-<!-- ##### FUNCTION gtk_menu_factory_add_subfactory ##### -->
+<!-- ##### FUNCTION gtk_window_get_default_accel_group ##### -->
<para>
</para>
-@factory:
-@subfactory:
-@path:
+@window:
+@Returns:
-<!-- ##### ENUM GtkTextViewScrollType ##### -->
+<!-- ##### FUNCTION gtk_window_get_resizeable ##### -->
<para>
</para>
-@GTK_TEXT_SCROLL_TO_TOP:
-@GTK_TEXT_SCROLL_TO_BOTTOM:
-@GTK_TEXT_SCROLL_PAGE_DOWN:
-@GTK_TEXT_SCROLL_PAGE_UP:
+@window:
+@Returns:
-<!-- ##### FUNCTION gtk_text_iter_next_char ##### -->
+<!-- ##### FUNCTION gtk_window_set_decorations_hint ##### -->
<para>
</para>
-@iter:
-@Returns:
+@window:
+@decorations:
-<!-- ##### FUNCTION gtk_tree_store_get_root_iter ##### -->
+<!-- ##### FUNCTION gtk_window_set_functions_hint ##### -->
<para>
</para>
-@tree_store:
-@iter:
+@window:
+@functions:
-<!-- ##### STRUCT GtkTextBTree ##### -->
+<!-- ##### FUNCTION gtk_window_set_resizeable ##### -->
<para>
</para>
+@window:
+@setting:
+@resizeable:
projects / ~andy / gtk / blobdiff