diff --git a/ChangeLog b/ChangeLog index 378821bdd9..d467096e98 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,16 @@ +2000-11-04 Havoc Pennington + + * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member + list + + * docs/Changes-2.0.txt: Add note about + gtk_container_get_toplevels() + + * gtk/gtktextview.h: formatting + + * gtk/gtktextview.c: don't start descriptions with "Returns", + confuses gtk-doc + Sat Nov 4 10:12:27 2000 Owen Taylor * autogen.sh: When doing sanity checking on ACLOCAL_FLAGS, diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0 index 378821bdd9..d467096e98 100644 --- a/ChangeLog.pre-2-0 +++ b/ChangeLog.pre-2-0 @@ -1,3 +1,16 @@ +2000-11-04 Havoc Pennington + + * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member + list + + * docs/Changes-2.0.txt: Add note about + gtk_container_get_toplevels() + + * gtk/gtktextview.h: formatting + + * gtk/gtktextview.c: don't start descriptions with "Returns", + confuses gtk-doc + Sat Nov 4 10:12:27 2000 Owen Taylor * autogen.sh: When doing sanity checking on ACLOCAL_FLAGS, diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 378821bdd9..d467096e98 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,16 @@ +2000-11-04 Havoc Pennington + + * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member + list + + * docs/Changes-2.0.txt: Add note about + gtk_container_get_toplevels() + + * gtk/gtktextview.h: formatting + + * gtk/gtktextview.c: don't start descriptions with "Returns", + confuses gtk-doc + Sat Nov 4 10:12:27 2000 Owen Taylor * autogen.sh: When doing sanity checking on ACLOCAL_FLAGS, diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 378821bdd9..d467096e98 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,16 @@ +2000-11-04 Havoc Pennington + + * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member + list + + * docs/Changes-2.0.txt: Add note about + gtk_container_get_toplevels() + + * gtk/gtktextview.h: formatting + + * gtk/gtktextview.c: don't start descriptions with "Returns", + confuses gtk-doc + Sat Nov 4 10:12:27 2000 Owen Taylor * autogen.sh: When doing sanity checking on ACLOCAL_FLAGS, diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 378821bdd9..d467096e98 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,16 @@ +2000-11-04 Havoc Pennington + + * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member + list + + * docs/Changes-2.0.txt: Add note about + gtk_container_get_toplevels() + + * gtk/gtktextview.h: formatting + + * gtk/gtktextview.c: don't start descriptions with "Returns", + confuses gtk-doc + Sat Nov 4 10:12:27 2000 Owen Taylor * autogen.sh: When doing sanity checking on ACLOCAL_FLAGS, diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 378821bdd9..d467096e98 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,16 @@ +2000-11-04 Havoc Pennington + + * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member + list + + * docs/Changes-2.0.txt: Add note about + gtk_container_get_toplevels() + + * gtk/gtktextview.h: formatting + + * gtk/gtktextview.c: don't start descriptions with "Returns", + confuses gtk-doc + Sat Nov 4 10:12:27 2000 Owen Taylor * autogen.sh: When doing sanity checking on ACLOCAL_FLAGS, diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 378821bdd9..d467096e98 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,16 @@ +2000-11-04 Havoc Pennington + + * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member + list + + * docs/Changes-2.0.txt: Add note about + gtk_container_get_toplevels() + + * gtk/gtktextview.h: formatting + + * gtk/gtktextview.c: don't start descriptions with "Returns", + confuses gtk-doc + Sat Nov 4 10:12:27 2000 Owen Taylor * autogen.sh: When doing sanity checking on ACLOCAL_FLAGS, diff --git a/docs/Changes-2.0.txt b/docs/Changes-2.0.txt index 0cdca5a4ee..c6460a6c1a 100644 --- a/docs/Changes-2.0.txt +++ b/docs/Changes-2.0.txt @@ -1,4 +1,10 @@ -Incompatible Changes from GTK+-1.2 to GTK+-1.4: +Incompatible Changes from GTK+-1.2 to GTK+-2.0: + +* gtk_container_get_toplevels() was removed and replaced with + gtk_window_list_toplevels(), which has different memory management + on the return value (gtk_window_list_toplevels() copies the GList + and also references each widget in the list, so you have to + g_list_free() the list after first unref'ing each list member). * The gdk_time* functions have been removed. This functionality has been unused since the main loop was moved into GLib diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 5c8e9ae41c..12b5a9c427 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +2000-11-04 Havoc Pennington + + * gtk/gtk-sections.txt: Added a bunch of stuff from unused + 2000-11-01 Havoc Pennington * gtk/tmpl/gtkmessagedialog.sgml: Check in these docs, I seem to diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt index 64296e3fe9..44bcc3e857 100644 --- a/docs/reference/gtk/gtk-sections.txt +++ b/docs/reference/gtk/gtk-sections.txt @@ -160,6 +160,8 @@ GTK_BOX_GET_CLASS GtkButton gtk_button_new gtk_button_new_with_label +gtk_button_new_accel +gtk_button_new_stock gtk_button_pressed gtk_button_released gtk_button_clicked @@ -606,6 +608,7 @@ GTK_DATA_GET_CLASS GtkDialog GtkDialog GtkDialogFlags +GtkResponseType gtk_dialog_new gtk_dialog_new_with_buttons gtk_dialog_run @@ -952,6 +955,24 @@ GTK_HSEPARATOR_GET_CLASS gtkimage GtkImage GtkImage +gtk_image_get_icon_set +gtk_image_get_image +gtk_image_get_pixbuf +gtk_image_get_pixmap +gtk_image_get_stock +gtk_image_get_storage_type +gtk_image_new_from_file +gtk_image_new_from_icon_set +gtk_image_new_from_image +gtk_image_new_from_pixbuf +gtk_image_new_from_pixmap +gtk_image_new_from_stock +gtk_image_set_from_file +gtk_image_set_from_icon_set +gtk_image_set_from_image +gtk_image_set_from_pixbuf +gtk_image_set_from_pixmap +gtk_image_set_from_stock gtk_image_new gtk_image_set gtk_image_get @@ -963,6 +984,13 @@ gtk_image_get_type GTK_IMAGE_CLASS GTK_IS_IMAGE_CLASS GTK_IMAGE_GET_CLASS + +GtkImageIconSetData +GtkImageImageData +GtkImagePixbufData +GtkImagePixmapData +GtkImageStockData +GtkImageType
@@ -1964,18 +1992,24 @@ gtk_text_buffer_insert_at_cursor gtk_text_buffer_insert_interactive gtk_text_buffer_insert_interactive_at_cursor gtk_text_buffer_insert_range +gtk_text_buffer_insert_range_interactive +gtk_text_buffer_insert_with_tags +gtk_text_buffer_insert_with_tags_by_name gtk_text_buffer_delete gtk_text_buffer_delete_interactive gtk_text_buffer_set_text gtk_text_buffer_get_text gtk_text_buffer_get_slice gtk_text_buffer_insert_pixbuf +gtk_text_buffer_create_child_anchor gtk_text_buffer_create_mark gtk_text_buffer_move_mark +gtk_text_buffer_move_mark_by_name gtk_text_buffer_delete_mark gtk_text_buffer_delete_mark_by_name gtk_text_buffer_get_mark gtk_text_buffer_get_insert +gtk_text_buffer_get_selection_bound gtk_text_buffer_place_cursor gtk_text_buffer_apply_tag gtk_text_buffer_remove_tag @@ -1985,14 +2019,19 @@ gtk_text_buffer_create_tag gtk_text_buffer_get_iter_at_line_offset gtk_text_buffer_get_iter_at_offset gtk_text_buffer_get_iter_at_line +gtk_text_buffer_get_iter_at_line_index +gtk_text_buffer_get_iter_at_mark +gtk_text_buffer_get_iter_at_child_anchor gtk_text_buffer_get_last_iter gtk_text_buffer_get_bounds -gtk_text_buffer_get_iter_at_mark gtk_text_buffer_get_tags gtk_text_buffer_modified gtk_text_buffer_set_modified gtk_text_buffer_delete_selection gtk_text_buffer_paste_clipboard +gtk_text_buffer_copy_clipboard +gtk_text_buffer_cut_clipboard +gtk_text_buffer_paste_primary gtk_text_buffer_get_selection_bounds GTK_TEXT_BUFFER @@ -2024,6 +2063,7 @@ gtk_text_iter_get_visible_text gtk_text_iter_get_pixbuf gtk_text_iter_get_marks gtk_text_iter_get_toggled_tags +gtk_text_iter_get_child_anchor gtk_text_iter_begins_tag gtk_text_iter_ends_tag gtk_text_iter_toggles_tag @@ -2050,6 +2090,7 @@ gtk_text_iter_backward_word_start gtk_text_iter_set_offset gtk_text_iter_set_line gtk_text_iter_set_line_offset +gtk_text_iter_set_line_index gtk_text_iter_forward_to_end gtk_text_iter_forward_to_newline gtk_text_iter_forward_to_tag_toggle @@ -2073,6 +2114,15 @@ GtkTextMark gtk_text_mark_set_visible gtk_text_mark_is_visible gtk_text_mark_get_deleted +gtk_text_mark_get_name + +GTK_TEXT_MARK +GTK_IS_TEXT_MARK +GTK_TYPE_TEXT_MARK +gtk_text_mark_get_type +GTK_TEXT_MARK_CLASS +GTK_IS_TEXT_MARK_CLASS +GTK_TEXT_MARK_GET_CLASS
@@ -2126,6 +2176,7 @@ GTK_TEXT_TAG_TABLE_GET_CLASS gtktextview GtkTextView GtkTextView +GtkTextWindowType gtk_text_view_new gtk_text_view_new_with_buffer gtk_text_view_set_buffer @@ -2141,6 +2192,18 @@ gtk_text_view_get_editable gtk_text_view_set_cursor_visible gtk_text_view_get_cursor_visible gtk_text_view_get_iter_location +gtk_text_view_get_line_at_y +gtk_text_view_get_line_yrange +gtk_text_view_get_iter_at_location +gtk_text_view_buffer_to_window_coords +gtk_text_view_window_to_buffer_coords +gtk_text_view_get_window +gtk_text_view_get_window_type +gtk_text_view_set_border_window_size +gtk_text_view_set_text_window_size +gtk_text_view_add_child_at_anchor +gtk_text_view_add_child_in_window +gtk_text_view_move_child GTK_TEXT_VIEW GTK_IS_TEXT_VIEW @@ -2149,6 +2212,11 @@ gtk_text_view_get_type GTK_TEXT_VIEW_CLASS GTK_IS_TEXT_VIEW_CLASS GTK_TEXT_VIEW_GET_CLASS + +GtkTextBTree +GtkTextChildBody +GtkTextPixbuf +GtkTextWindow
@@ -2863,6 +2931,7 @@ gtk_widget_modify_font gtk_widget_create_pango_context gtk_widget_get_pango_context gtk_widget_create_pango_layout +gtk_widget_render_stock_icon gtk_widget_pop_composite_child gtk_widget_push_composite_child gtk_widget_queue_clear @@ -2905,6 +2974,7 @@ gtk_window_set_position gtk_window_set_transient_for gtk_window_set_destroy_with_parent gtk_window_list_toplevels +gtk_window_get_default_accel_group GTK_WINDOW GTK_IS_WINDOW @@ -3060,6 +3130,8 @@ gtk_style_unref gtk_style_set_background gtk_style_apply_default_background gtk_style_apply_default_pixmap +gtk_style_lookup_icon_set +gtk_style_render_icon gtk_draw_hline gtk_draw_vline gtk_draw_shadow @@ -3461,10 +3533,12 @@ GtkAttachOptions GtkButtonBoxStyle GtkCornerType GtkCurveType +GtkDeleteType GtkDirectionType GtkJustification GtkMatchType GtkMetricType +GtkMovementStep GtkOrientation GtkPackType GtkPathPriorityType @@ -3504,3 +3578,71 @@ gtk_menu_factory_remove_subfactory gtk_menu_factory_find
+
+gtkstock +Stock Items +GtkStockItem +gtk_stock_add +gtk_stock_add_static +gtk_stock_item_copy +gtk_stock_item_free +gtk_stock_list_items +gtk_stock_lookup + +GTK_STOCK_BUTTON_APPLY +GTK_STOCK_BUTTON_CANCEL +GTK_STOCK_BUTTON_CLOSE +GTK_STOCK_BUTTON_NO +GTK_STOCK_BUTTON_OK +GTK_STOCK_BUTTON_YES +GTK_STOCK_DIALOG_ERROR +GTK_STOCK_DIALOG_INFO +GTK_STOCK_DIALOG_QUESTION +GTK_STOCK_DIALOG_WARNING +GTK_STOCK_HELP +GTK_STOCK_NEW +GTK_STOCK_OPEN +GTK_STOCK_QUIT +GTK_STOCK_SAVE +GTK_STOCK_CLOSE +
+ + +
+gtkiconfactory +Themeable Stock Images +GtkIconSource +GtkIconFactory +GtkIconSet +gtk_icon_source_copy +gtk_icon_source_free +gtk_icon_factory_add +gtk_icon_factory_add_default +gtk_icon_factory_lookup +gtk_icon_factory_lookup_default +gtk_icon_factory_new +gtk_icon_factory_remove_default +gtk_icon_set_add_source +gtk_icon_set_copy +gtk_icon_set_new +gtk_icon_set_ref +gtk_icon_set_render_icon +gtk_icon_set_unref +GTK_ICON_SIZE_MENU +GTK_ICON_SIZE_BUTTON +GTK_ICON_SIZE_SMALL_TOOLBAR +GTK_ICON_SIZE_LARGE_TOOLBAR +GTK_ICON_SIZE_DIALOG +gtk_icon_size_lookup +gtk_icon_size_register +gtk_icon_size_register_alias + +GtkIconFactoryClass +GTK_TYPE_ICON_FACTORY +GTK_ICON_FACTORY +GTK_IS_ICON_FACTORY +GTK_ICON_FACTORY_CLASS +GTK_ICON_FACTORY_GET_CLASS +GTK_IS_ICON_FACTORY_CLASS +gtk_icon_factory_get_type +
\ No newline at end of file diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml index 271b9a5a32..c71e6595b0 100644 --- a/docs/reference/gtk/tmpl/gtk-unused.sgml +++ b/docs/reference/gtk/tmpl/gtk-unused.sgml @@ -1,10 +1,561 @@ - -Debugging + +Menu Factory - + + + + + +@obj: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@buffer: +@override_location: +@time: +@interactive: +@default_editable: + + + + + + +@GTK_TEXT_SCROLL_TO_TOP: +@GTK_TEXT_SCROLL_TO_BOTTOM: +@GTK_TEXT_SCROLL_PAGE_DOWN: +@GTK_TEXT_SCROLL_PAGE_UP: + + + + + + +@v: + + + + + + +@path: +@type: +@accel_group: +@widget: +@subfactories: + + + + + + +@widget: +@selection: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@buffer: +@regexp: +@start: +@end: +@Returns: + + + + + + +@buffer: +@iter: +@str: +@start: +@end: +@Returns: + + + + + + +@buffer: + + + + + + + + + + +@container: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + + + + +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(). + + +@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. + + + +Combine a fundemantal type and a sequence number to create a gtk type. + + +@parent_t: +@seqno: + + + + + + +@factory: +@path: +@Returns: + + +GtkIMContextSimple + + + + +Internal function used by #GtkHPaned and #GtkVPaned + + +@paned: +@allocation: +@child1_req: +@child2_req: + + + + + + +@textview: the object which received the signal. +@arg1: +@arg2: +@arg3: + + + + + + + + + +Private: print debugging information while doing a gtk_object_ref() or +a gtk_object_unref(). + + +@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. + + + + + + + + + +The first structured enumerated type value. + + + + + + + + +@mark: +@Returns: + + +Signal Marshallers + + + + + + + + + + + + + +@textview: the object which received the signal. +@arg1: + + + + + + + + +Private Information + + + + + + + +@textview: the object which received the signal. +@arg1: + + + +Add an emission hook for a type of signal, for any object. +(with control of what happens when the hook is +destroyed). + + +@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()). + + + + + + +@object: +@func: +@func_data: +@args: + + +gtkenums.sgml + + + + + + + +@object: +@func: +@func_data: +@args: + + + +Set the varargs type for a fundamental type @foreign_type. + + +@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. + + + + + + +@wid: +@flag: + + + + + + + + + + + + +@Returns: + + + + + + + + + + + + +@GTK_MENU_FACTORY_MENU: +@GTK_MENU_FACTORY_MENU_BAR: +@GTK_MENU_FACTORY_OPTION_MENU: + + + +Sets one of the two font filters, to limit the fonts shown. + + +@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: + + + +No idea. + + + + + + + + +@textview: the object which received the signal. + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + + + + + + + + + + + + + +@textview: the object which received the signal. + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@textview: the object which received the signal. +@arg1: +@arg2: + + + + + + +@v: +@visual: + + + + + + + +Hide the name of gtk_identifier_get_type + + + + + + + + +@error_code: + + + +A structure used to return values from @gtk_type_query. + + +@type: +@type_name: +@object_size: +@class_size: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@object: +@func: +@func_data: +@args: + + + +The first "flat" (no struct) enumerated type value. + + + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@wid: +@flag: + + + + + + +@window: +@focus: @@ -12,6 +563,667 @@ Debugging + + + + + + + + +Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK + + +@a: + + + + + + + + + +Return the pointer to the type's children's types. + + +@type: GtkType +@Returns: pointer to a GList + + + + + + +@wid: + + + + + + +@factory: +@entries: +@nentries: + + + + + + +@obj: + + + +Get the type of GtkIdentifier. + + +@Returns: GtkType -- the enumerated type of something. + + + +Given a @type, describe all of its children, and their children. Only +show the size if @show_size is true. + + +@type: GtkType +@show_size: gboolean + + + + + + +@path: +@widget: + + + +Returns whether a connection id is valid (and optionally not blocked). + + +@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. + + + +Convert a gtk type into its sequence number + + +@type: + + + +Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK + + +@a: + + + + + + +@obj: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + + + + + + + + + + +Register a new set of enum @values and give them the name in +@type_name. + + +@type_name: must not be null. +@values: GtkEnumValue* +@Returns: + + + + + + + + + + + + +@object: +@func: +@func_data: +@args: + + + +Sets one of the two font filters, to limit the fonts shown. + + +@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. + + + +Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN + + +@a: + + + + + + +@v: +@visual: + + + + + + +@PRIVATE_GTK_USER_STYLE: +@PRIVATE_GTK_RESIZE_PENDING: +@PRIVATE_GTK_RESIZE_NEEDED: +@PRIVATE_GTK_LEAVE_PENDING: +@PRIVATE_GTK_HAS_SHAPE_MASK: +@PRIVATE_GTK_IN_REPARENT: +@PRIVATE_GTK_DIRECTION_SET: +@PRIVATE_GTK_DIRECTION_LTR: + + + + + + +@mark: + + + +Obtain information about a signal. + + +@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. + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@mark: +@Returns: + + + + + + + + + + +@buffer: +@time: +@interactive: +@default_editable: + + + + + + + + + +Given the type of an object and a pointer to it, the object is freed. + + +@type: GtkType +@mem: gpointer to the object + + + + + + +@buffer: +@time: + + + + + + + + + + + + + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + + + + + + + +@factory: +@paths: +@npaths: + + + + + + +@factory: + + + +The last structured enumerated type value. + + + + + + + + + + + +Print the types @type inherits from. + + +@type: GtkType + + + + + + +@selection_data: +@str: +@Returns: + + + + + + +@textview: the object which received the signal. +@arg1: +@arg2: + + + + + + +@Returns: + + + + + + +@obj: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + + + + + + + +@window: +@xid: + + + + + + +@object: +@func: +@func_data: +@args: + + + +Find out the recursion depth of emissions for a particular type +of signal and object. (So it will +always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified) +This is a way to avoid recursion: you can see if +you are currently running in that signal handler and emit it only +if you are. + +Another way to look at it is that this number increases +by one when #gtk_signal_emit(), et al, are called, +and decreases by one when #gtk_signal_emit() returns. + + +@object: the object with the signal handler. +@signal_id: the signal id. +@Returns: the recursion depth of emissions of this signal for this +object. + + + + + + +@type: +@action: + + + + + + +@object: +@func: +@func_data: +@args: + + + +Deprecated. + + + + + + + + + + + +Given a type, return various interesting parameters of the type. + + +@type: GtkType +@Returns: GtkTypeQuery* + + + + + + +@textview: the object which received the signal. + + + +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. + + +@colorsel: a #GtkColorSelection. +@use_opacity: a boolean indicating whether the opacity selection +is enabled. + + + +This is currently a hack left in for a scheme wrapper library. +It may be removed. + + +Don't use it. + + +@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. + + + + + + +@obj: + + +Functions to adapt C structures to native calling convention. + + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@obj: + + + + + + + + + + + + +@object: +@func: +@func_data: +@args: + + + +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) + + +By default, there are no such functions. + + +@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. + + + +A function which you can use to clean up when the +signal handler is destroyed. + + +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). + + +@data: The user data associated with the hook that is being +destroyed. + + + +Set the mem_chunk size so it will hold @n_chunks of the objects of that @type. + + +@type: There must be an unlocked TypeNode associated with this type otherwise nothing happens. +@n_chunks: + + + + + + +#GtkSignal +The signal handling functions (of which marshallers are +really an implementation detail). + + + + + + + + + + + +@buffer: +@iter: +@pixmap: +@mask: + + + + + + +@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: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + + What are Signal Marshallers? @@ -78,583 +1290,26 @@ void marshal_INT__POINTER_POINTER_INT_INT(GtkObject* object, - - - - - + - +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(). +@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. - - - - - -@wid: -@flag: - - - - - - -@obj: - - - - - - - - + @textview: the object which received the signal. @arg1: - - - - - - -@v: -@visual: - - - - - - -@window: -@focus: - - - - - - - - - - - - - - - - - - - - - -Sets one of the two font filters, to limit the fonts shown. - - -@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. - - - - - - -@container: - - -Signal Marshallers - - - - - - - - - - -A structure used to return values from @gtk_type_query. - - -@type: -@type_name: -@object_size: -@class_size: - - - - - - -@buffer: -@Returns: - - - - - - -@v: - - - - - - -@object: -@func: -@func_data: -@args: - - - -This is currently a hack left in for a scheme wrapper library. -It may be removed. - - -Don't use it. - - -@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. - - - -Add an emission hook for a type of signal, for any object. -(with control of what happens when the hook is -destroyed). - - -@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()). - - - - - - -@buffer: -@override_location: -@time: -@interactive: -@default_editable: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@textview: the object which received the signal. - - - - - - -@text_view: -@iter: -@x: -@y: - - - - - - - -Get the type of GtkIdentifier. - - -@Returns: GtkType -- the enumerated type of something. - - - - - - - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@mark: -@Returns: - - - - - - - - - - - - -@ruler: the gtkruler - - - - - - -@selection_data: -@str: -@Returns: - - - - - - -@argc: -@argv: - - - -Register a new set of enum @values and give them the name in -@type_name. - - -@type_name: must not be null. -@values: GtkEnumValue* -@Returns: - - -Menu Factory - - - - - - - - - - - - - -@w: -@v: -@widget: -@visual: - - - - - - - - - -Convert a gtk type into its sequence number - - -@type: - - - - - - - - - - - - -@GTK_MENU_FACTORY_MENU: -@GTK_MENU_FACTORY_MENU_BAR: -@GTK_MENU_FACTORY_OPTION_MENU: - - - - - - - - - - - - - - - - - - -@obj: - - - - - - - - - - - - - - - - -@textview: the object which received the signal. - - - -Deprecated. - - - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - - - - - - - -@buffer: -@time: -@interactive: -@default_editable: - - - - - - -@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: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - - - - - - - -@obj: - - - - - - -@factory: -@entries: -@nentries: - - - - - - -@buffer: -@iter: -@str: -@start: -@end: -@Returns: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - -Internal function used by #GtkHPaned and #GtkVPaned - - -@paned: -@allocation: -@child1_req: -@child2_req: - - - - - - - - - -Private: print debugging information while doing a gtk_object_ref() or -a gtk_object_unref(). - - -@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. - - - -Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK - - -@a: - - - - - - - - - -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(). - - -@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. - - - -The last structured enumerated type value. - - +@arg2: +@arg3: @@ -663,77 +1318,6 @@ Get the number of signals defined by this object. @obj: the object to query. - - - - - -@factory: -@subfactory: -@path: - - - -Return the pointer to the type's children's types. - - -@type: GtkType -@Returns: pointer to a GList - - - -Register a new set of flags @values and give them the name in -@type_name. - - -@type_name: must not be null. -@values: GtkFlagValue* -@Returns: - - - - - - -@widget: -@selection: - - - - - - -@textview: the object which received the signal. -@arg1: - - - - - - -@PRIVATE_GTK_USER_STYLE: -@PRIVATE_GTK_RESIZE_PENDING: -@PRIVATE_GTK_RESIZE_NEEDED: -@PRIVATE_GTK_LEAVE_PENDING: -@PRIVATE_GTK_HAS_SHAPE_MASK: -@PRIVATE_GTK_IN_REPARENT: -@PRIVATE_GTK_DIRECTION_SET: -@PRIVATE_GTK_DIRECTION_LTR: - - - -Set the mem_chunk size so it will hold @n_chunks of the objects of that @type. - - -@type: There must be an unlocked TypeNode associated with this type otherwise nothing happens. -@n_chunks: - - - -The first structured enumerated type value. - - - This structure contains all the information about a particular @@ -750,233 +1334,13 @@ and its unique identifying integer. @nparams: @params: - - -Given a @type, describe all of its children, and their children. Only -show the size if @show_size is true. - - -@type: GtkType -@show_size: gboolean - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - - - - - - - -@window: -@xid: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@iter: -@pixmap: -@mask: -@Returns: - - - - - - - - - -Sets one of the two font filters, to limit the fonts shown. - - -@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. - - - - - - -@textview: the object which received the signal. -@arg1: -@arg2: - - + @Returns: - - -No idea. - - - - - -Combine a fundemantal type and a sequence number to create a gtk type. - - -@parent_t: -@seqno: - - -Functions to adapt C structures to native calling convention. - - - - -The last "flat" (no struct) enumerated type value. - - - - - - - - -@mark: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - -Destroy all the signal handlers connected to an object. -This is done automatically when the object is destroyed. - - -This function is labeled private. - - -@object: the object whose signal handlers should be destroyed. - - - - - - -@iter: -@start: -@end: -@Returns: - - - -Get the varargs type associated with @foreign_type - - -@foreign_type: GtkType -@Returns: GtkType - - - - - - -@path: -@type: -@accel_group: -@widget: -@subfactories: - - - -Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN - - -@a: - - - - - - -@textview: the object which received the signal. - - - - - - -@wid: -@flag: - - - - - - -@ruler: the gtkruler - - - - - - -@obj: - @@ -988,44 +1352,39 @@ Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN @GTK_DEBUG_DND: @GTK_DEBUG_PLUGSOCKET: - + -@factory: -@paths: -@npaths: +@argc: +@argv: - - -Given a type, return various interesting parameters of the type. - - -@type: GtkType -@Returns: GtkTypeQuery* - - + - - -Hide the name of gtk_identifier_get_type - - - - + + + + + +@window: +@defaultw: + + + + + + + + -@object: -@func: -@func_data: -@args: @@ -1033,102 +1392,54 @@ Hide the name of gtk_identifier_get_type - + -Returns whether a connection id is valid (and optionally not blocked). +Get the varargs type associated with @foreign_type -@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. +@foreign_type: GtkType +@Returns: GtkType - + -@wid: +@text_view: +@iter: +@x: +@y: - + + +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. + + +@object: the object with the signal handler. +@name: the signal name. +@Returns: the recursion depth of emissions of this signal for this +object. + + -@selection_data: -@Returns: +@container: - + - - - -@object: -@func: -@func_data: -@args: - - - -Given the type of an object and a pointer to it, the object is freed. - - -@type: GtkType -@mem: gpointer to the object - - - - - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@path: -@widget: - - - - +Internal function. - -Private Information - - - + - +The last "flat" (no struct) enumerated type value. -@factory: -@path: -@Returns: - - - - - - -@path: -@accelerator: -@callback: -@callback_data: -@widget: @@ -1138,7 +1449,7 @@ Private Information @window: @xid: - + @@ -1148,20 +1459,66 @@ Private Information @func_data: @args: - + -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. +Register a new set of flags @values and give them the name in +@type_name. -@colorsel: a #GtkColorSelection. -@use_opacity: a boolean indicating whether the opacity selection -is enabled. +@type_name: must not be null. +@values: GtkFlagValue* +@Returns: - + + + + + +@textview: the object which received the signal. +@arg1: +@arg2: + + + + + + +@type: +@Returns: + + + + + + + + + + +@w: +@v: +@widget: +@visual: + + + +A marshaller that returns void and takes no extra parameters. + + + + + + + + + + + + +@buffer: +@text: + + @@ -1171,19 +1528,147 @@ is enabled. @func_data: @args: - + - - - -#GtkSignal -The signal handling functions (of which marshallers are -really an implementation detail). - - - +Return the class of the parent. Initialize the class if necessary. +Return NULL if anything goes wrong. +@type: GtkType +@Returns: gpointer to the klass. + + + + + + +@obj: + + + + + + +@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: + + + + + + +@buffer: +@Returns: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@object: +@func: +@func_data: +@args: + + + + + + +@factory: +@entries: +@nentries: + + + +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. + + +@klass: GtkTypeClass* +@cast_type: GtkType +@Returns: Always return @klass. + + + + + + + + + + + + +@selection_data: +@Returns: + + + + + + +@widget: +@user_data: + + + + + + + + + + + + + + + + + + +@factory: +@subfactory: +@path: + + +Debugging + + + + +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. + + +@type_object: GtkTypeObject* +@cast_type: GtkType +@Returns: the same GtkTypeObject* as @type_object + + + + + + +@ruler: the gtkruler @@ -1217,105 +1702,25 @@ really an implementation detail). @column: @header_height: - - - - - -@obj: - - - - - - -@type: -@action: - - - - - - -@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: - - - -The first "flat" (no struct) enumerated type value. - - - - - - - - -@type: -@Returns: - - + - - - - - -@buffer: - - - -A marshaller that returns void and takes no extra parameters. - - - - + - + - - - - - -@obj: - - - - - - -@buffer: -@time: - - - - - - -@mark: -@Returns: - - + @@ -1325,6 +1730,31 @@ A marshaller that returns void and takes no extra parameters. @func_data: @args: + + +Destroy all the signal handlers connected to an object. +This is done automatically when the object is destroyed. + + +This function is labeled private. + + +@object: the object whose signal handlers should be destroyed. + + + + + + +@iter: +@pixmap: +@mask: +@Returns: + + + + + Get the array of signals defined for this object. @@ -1332,11 +1762,7 @@ Get the array of signals defined for this object. @obj: the object to fetch the signals from. - -gtkenums.sgml - - - + @@ -1346,427 +1772,12 @@ gtkenums.sgml @func_data: @args: - - -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. - - -@type_object: GtkTypeObject* -@cast_type: GtkType -@Returns: the same GtkTypeObject* as @type_object - - + -@widget: -@user_data: - - - - - - -@error_code: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - - - - - - - - - - -Set the varargs type for a fundamental type @foreign_type. - - -@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. - - - -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. - - -@klass: GtkTypeClass* -@cast_type: GtkType -@Returns: Always return @klass. - - - - - - -@factory: - - - -Find out the recursion depth of emissions for a particular type -of signal and object. (So it will -always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified) -This is a way to avoid recursion: you can see if -you are currently running in that signal handler and emit it only -if you are. - -Another way to look at it is that this number increases -by one when #gtk_signal_emit(), et al, are called, -and decreases by one when #gtk_signal_emit() returns. - - -@object: the object with the signal handler. -@signal_id: the signal id. -@Returns: the recursion depth of emissions of this signal for this -object. - - - - - - -@buffer: @iter: -@pixmap: -@mask: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - -Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS - - -@a: - - - - - - -@factory: -@entries: -@nentries: - - - -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) - - -By default, there are no such functions. - - -@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. - - - - - - -@Returns: - - - -Print the types @type inherits from. - - -@type: GtkType - - - - - - -@buffer: -@text: - - - -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(). - - -@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. - - - -Return the class of the parent. Initialize the class if necessary. -Return NULL if anything goes wrong. - - -@type: GtkType -@Returns: gpointer to the klass. - - - -A function which you can use to clean up when the -signal handler is destroyed. - - -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). - - -@data: The user data associated with the hook that is being -destroyed. - - - - - - -@window: -@defaultw: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@obj: - - - - - - - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@obj: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - - - - - - - -@object: -@func: -@func_data: -@args: - - - -Internal function. - - - - - -Obtain information about a signal. - - -@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. - - - -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. - - -@object: the object with the signal handler. -@name: the signal name. -@Returns: the recursion depth of emissions of this signal for this -object. - - - - - - - - - - - - -@textview: the object which received the signal. -@arg1: -@arg2: - - - - - - -@container: - - - - - - - - - - - - -@v: -@visual: - - -GtkIMContextSimple - - - - - - - - - - -Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK - - -@a: - - - - - - -@object: -@func: -@func_data: -@args: - - - - - - -@textview: the object which received the signal. -@arg1: -@arg2: -@arg3: - - - - - - - - - - - - -@buffer: -@regexp: @start: @end: @Returns: @@ -1780,19 +1791,34 @@ Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK @subfactory: @path: - + -@GTK_TEXT_SCROLL_TO_TOP: -@GTK_TEXT_SCROLL_TO_BOTTOM: -@GTK_TEXT_SCROLL_PAGE_DOWN: -@GTK_TEXT_SCROLL_PAGE_UP: +@path: +@accelerator: +@callback: +@callback_data: +@widget: - + + + + + +@ruler: the gtkruler + + + + +Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS + + +@a: + diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml index 1daa98aa21..cf2dd0b7fd 100644 --- a/docs/reference/gtk/tmpl/gtkbutton.sgml +++ b/docs/reference/gtk/tmpl/gtkbutton.sgml @@ -45,6 +45,26 @@ text. @Returns: The newly created #GtkButton widget. + + + + + +@uline_label: +@accel_group: +@Returns: + + + + + + + +@stock_id: +@accel_group: +@Returns: + + Emits a #GtkButton::pressed signal to the given #GtkButton. diff --git a/docs/reference/gtk/tmpl/gtkdialog.sgml b/docs/reference/gtk/tmpl/gtkdialog.sgml index 4bc84eba01..2e835e982f 100644 --- a/docs/reference/gtk/tmpl/gtkdialog.sgml +++ b/docs/reference/gtk/tmpl/gtkdialog.sgml @@ -145,6 +145,15 @@ gtk_window_set_title(). See the #GtkWindow section for more). @GTK_DIALOG_MODAL: @GTK_DIALOG_DESTROY_WITH_PARENT: + + + + + +@GTK_RESPONSE_NONE: +@GTK_RESPONSE_REJECT: +@GTK_RESPONSE_ACCEPT: + Creates a new dialog box. Widgets should not be packed into this #GtkWindow diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml index e740b63ec1..33beb4c95e 100644 --- a/docs/reference/gtk/tmpl/gtkenums.sgml +++ b/docs/reference/gtk/tmpl/gtkenums.sgml @@ -84,6 +84,20 @@ widget. @GTK_CURVE_TYPE_SPLINE: @GTK_CURVE_TYPE_FREE: + + + + + +@GTK_DELETE_CHARS: +@GTK_DELETE_WORD_ENDS: +@GTK_DELETE_WORDS: +@GTK_DELETE_DISPLAY_LINES: +@GTK_DELETE_DISPLAY_LINE_ENDS: +@GTK_DELETE_PARAGRAPH_ENDS: +@GTK_DELETE_PARAGRAPHS: +@GTK_DELETE_WHITESPACE: + @@ -128,6 +142,21 @@ Used for justifying the text inside a #GtkLabel widget. (See also @GTK_INCHES: @GTK_CENTIMETERS: + + + + + +@GTK_MOVEMENT_CHARS: +@GTK_MOVEMENT_POSITIONS: +@GTK_MOVEMENT_WORDS: +@GTK_MOVEMENT_DISPLAY_LINES: +@GTK_MOVEMENT_DISPLAY_LINE_ENDS: +@GTK_MOVEMENT_PARAGRAPHS: +@GTK_MOVEMENT_PARAGRAPH_ENDS: +@GTK_MOVEMENT_PAGES: +@GTK_MOVEMENT_BUFFER_ENDS: + diff --git a/docs/reference/gtk/tmpl/gtkimage.sgml b/docs/reference/gtk/tmpl/gtkimage.sgml index 4e6b178ac6..6f8bfdd021 100644 --- a/docs/reference/gtk/tmpl/gtkimage.sgml +++ b/docs/reference/gtk/tmpl/gtkimage.sgml @@ -28,6 +28,180 @@ below. + + + + + +@image: +@icon_set: +@size: + + + + + + + +@image: +@gdk_image: +@mask: + + + + + + + +@image: +@Returns: + + + + + + + +@image: +@pixmap: +@mask: + + + + + + + +@image: +@stock_id: +@size: + + + + + + + +@image: +@Returns: + + + + + + + +@filename: +@Returns: + + + + + + + +@icon_set: +@size: +@Returns: + + + + + + + +@image: +@mask: +@Returns: + + + + + + + +@pixbuf: +@Returns: + + + + + + + +@pixmap: +@mask: +@Returns: + + + + + + + +@stock_id: +@size: +@Returns: + + + + + + + +@image: +@filename: + + + + + + + +@image: +@icon_set: +@size: + + + + + + + +@image: +@gdk_image: +@mask: + + + + + + + +@image: +@pixbuf: + + + + + + + +@image: +@pixmap: +@mask: + + + + + + + +@image: +@stock_id: +@size: + + Creates the new GtkImage using the value and the mask. diff --git a/docs/reference/gtk/tmpl/gtklabel.sgml b/docs/reference/gtk/tmpl/gtklabel.sgml index 4e13d8f2c3..f26cf204ca 100644 --- a/docs/reference/gtk/tmpl/gtklabel.sgml +++ b/docs/reference/gtk/tmpl/gtklabel.sgml @@ -40,12 +40,44 @@ pass NULL to get an empty label widget. @Returns: The newly allocated #GtkLabel widget - + -Aliases gtk_label_set_text. Probably used for backward compatibility with -Gtk+ 1.0.x. +Sets the text within the #GtkLabel widget. It overwrites any text that +was there before. Note that underlines that were there before do not +get overwritten. If you want to erase underlines just send NULL to +gtk_label_set_pattern(). +@label: The #GtkLabel you want to set the text for. +@str: The text you want to add. + + + + + + + +@label: +@attrs: + + + + + + + +@label: +@str: + + + + + + + +@label: +@str: +@Returns: @@ -108,16 +140,12 @@ by the edge of the widget if it exceeds the widget size. @wrap: TRUE turns it on; FALSE turns it off. - + -Sets the text within the #GtkLabel widget. It overwrites any text that -was there before. Note that underlines that were there before do not -get overwritten. If you want to erase underlines just send NULL to -gtk_label_set_pattern(). +Aliases gtk_label_set_text. Probably used for backward compatibility with +Gtk+ 1.0.x. -@label: The #GtkLabel you want to set the text for. -@str: The text you want to add. diff --git a/docs/reference/gtk/tmpl/gtkstyle.sgml b/docs/reference/gtk/tmpl/gtkstyle.sgml index 618d49de6e..da03752f9c 100644 --- a/docs/reference/gtk/tmpl/gtkstyle.sgml +++ b/docs/reference/gtk/tmpl/gtkstyle.sgml @@ -187,6 +187,31 @@ Styles @h: + + + + + +@style: +@stock_id: +@Returns: + + + + + + + +@style: +@source: +@direction: +@state: +@size: +@widget: +@detail: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtktextbuffer.sgml b/docs/reference/gtk/tmpl/gtktextbuffer.sgml index de02fed274..1f0247ebcf 100644 --- a/docs/reference/gtk/tmpl/gtktextbuffer.sgml +++ b/docs/reference/gtk/tmpl/gtktextbuffer.sgml @@ -116,6 +116,45 @@ types related to the text widget and how they work together. @end: + + + + + +@buffer: +@iter: +@start: +@end: +@default_editable: +@Returns: + + + + + + + +@buffer: +@iter: +@text: +@len: +@first_tag: +@Varargs: + + + + + + + +@buffer: +@iter: +@text: +@len: +@first_tag_name: +@Varargs: + + @@ -191,6 +230,16 @@ types related to the text widget and how they work together. @pixbuf: + + + + + +@buffer: +@iter: +@Returns: + + @@ -213,6 +262,16 @@ types related to the text widget and how they work together. @where: + + + + + +@buffer: +@name: +@where: + + @@ -250,6 +309,15 @@ types related to the text widget and how they work together. @Returns: + + + + + +@buffer: +@Returns: + + @@ -344,6 +412,37 @@ types related to the text widget and how they work together. @line_number: + + + + + +@buffer: +@iter: +@line_number: +@byte_index: + + + + + + + +@buffer: +@iter: +@mark: + + + + + + + +@buffer: +@iter: +@anchor: + + @@ -363,16 +462,6 @@ types related to the text widget and how they work together. @end: - - - - - -@buffer: -@iter: -@mark: - - @@ -424,6 +513,33 @@ types related to the text widget and how they work together. @interactive: + + + + + +@buffer: + + + + + + + +@buffer: +@default_editable: + + + + + + + +@buffer: +@override_location: +@default_editable: + + diff --git a/docs/reference/gtk/tmpl/gtktextiter.sgml b/docs/reference/gtk/tmpl/gtktextiter.sgml index 188b392eda..85a57a0573 100644 --- a/docs/reference/gtk/tmpl/gtktextiter.sgml +++ b/docs/reference/gtk/tmpl/gtktextiter.sgml @@ -183,6 +183,15 @@ types related to the text widget and how they work together. @Returns: + + + + + +@iter: +@Returns: + + @@ -429,6 +438,15 @@ types related to the text widget and how they work together. @char_on_line: + + + + + +@iter: +@byte_on_line: + + diff --git a/docs/reference/gtk/tmpl/gtktextmark.sgml b/docs/reference/gtk/tmpl/gtktextmark.sgml index 155e327fe5..2af2ab2d55 100644 --- a/docs/reference/gtk/tmpl/gtktextmark.sgml +++ b/docs/reference/gtk/tmpl/gtktextmark.sgml @@ -88,3 +88,12 @@ Marks are typically created using the gtk_text_buffer_create_mark() function. @Returns: + + + + + +@mark: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtktextview.sgml b/docs/reference/gtk/tmpl/gtktextview.sgml index 82ce9d1ec0..446b5aed7f 100644 --- a/docs/reference/gtk/tmpl/gtktextview.sgml +++ b/docs/reference/gtk/tmpl/gtktextview.sgml @@ -26,6 +26,19 @@ types related to the text widget and how they work together. + + + + + +@GTK_TEXT_WINDOW_PRIVATE: +@GTK_TEXT_WINDOW_WIDGET: +@GTK_TEXT_WINDOW_TEXT: +@GTK_TEXT_WINDOW_LEFT: +@GTK_TEXT_WINDOW_RIGHT: +@GTK_TEXT_WINDOW_TOP: +@GTK_TEXT_WINDOW_BOTTOM: + @@ -164,6 +177,138 @@ types related to the text widget and how they work together. @location: + + + + + +@text_view: +@target_iter: +@y: +@line_top: + + + + + + + +@text_view: +@iter: +@y: +@height: + + + + + + + +@text_view: +@iter: +@x: +@y: + + + + + + + +@text_view: +@win: +@buffer_x: +@buffer_y: +@window_x: +@window_y: + + + + + + + +@text_view: +@win: +@window_x: +@window_y: +@buffer_x: +@buffer_y: + + + + + + + +@text_view: +@win: +@Returns: + + + + + + + +@text_view: +@window: +@Returns: + + + + + + + +@text_view: +@type: +@size: + + + + + + + +@text_view: +@width: +@height: + + + + + + + +@text_view: +@child: +@anchor: + + + + + + + +@text_view: +@child: +@which_window: +@xpos: +@ypos: + + + + + + + +@text_view: +@child: +@xpos: +@ypos: + + @@ -178,7 +323,7 @@ types related to the text widget and how they work together. @textview: the object which received the signal. - + @@ -195,7 +340,7 @@ types related to the text widget and how they work together. @textview: the object which received the signal. @arg1: - + diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml index 40c8a0d32e..5b05c5e574 100644 --- a/docs/reference/gtk/tmpl/gtkwidget.sgml +++ b/docs/reference/gtk/tmpl/gtkwidget.sgml @@ -1169,6 +1169,18 @@ GtkWidget @Returns: + + + + + +@widget: +@stock_id: +@size: +@detail: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml index feb13700f8..b46bcd7b8a 100644 --- a/docs/reference/gtk/tmpl/gtkwindow.sgml +++ b/docs/reference/gtk/tmpl/gtkwindow.sgml @@ -236,6 +236,15 @@ it's larger @Returns: + + + + + +@window: +@Returns: + + diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h index 0fcdf510ab..07f958508b 100644 --- a/gtk/gtkenums.h +++ b/gtk/gtkenums.h @@ -78,7 +78,7 @@ typedef enum { GTK_DELETE_DISPLAY_LINE_ENDS, GTK_DELETE_PARAGRAPH_ENDS, /* like C-k in Emacs (or its reverse) */ GTK_DELETE_PARAGRAPHS, /* C-k in pico, kill whole line */ - GTK_DELETE_WHITESPACE, /* M-\ in Emacs */ + GTK_DELETE_WHITESPACE /* M-\ in Emacs */ } GtkDeleteType; /* Focus movement types */ diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c index 11ecf86d26..ee0354d9d8 100644 --- a/gtk/gtktextview.c +++ b/gtk/gtktextview.c @@ -880,7 +880,7 @@ gtk_text_view_get_iter_at_location (GtkTextView *text_view, * @iter: a #GtkTextIter * @location: bounds of the character at @iter * - * Returns a rectangle which roughly contains the character at @iter. + * Gets a rectangle which roughly contains the character at @iter. * The rectangle position is in buffer coordinates; use * gtk_text_view_buffer_to_window_coords() to convert these * coordinates to coordinates for one of the windows in the text view. @@ -904,7 +904,7 @@ gtk_text_view_get_iter_location (GtkTextView *text_view, * @y: return location for a y coordinate * @height: return location for a height * - * Returns the y coordinate of the top of the line containing @iter, + * Gets the y coordinate of the top of the line containing @iter, * and the height of the line. The coordinate is a buffer coordinate; * convert to window coordinates with gtk_text_view_buffer_to_window_coords(). * @@ -931,7 +931,7 @@ gtk_text_view_get_line_yrange (GtkTextView *text_view, * @y: a y coordinate * @line_top: return location for top coordinate of the line * - * Returns the #GtkTextIter at the start of the line containing + * Gets the #GtkTextIter at the start of the line containing * the coordinate @y. @y is in buffer coordinates, convert from * window coordinates with gtk_text_view_window_to_buffer_coords(). * If non-%NULL, @line_top will be filled with the coordinate of the top diff --git a/gtk/gtktextview.h b/gtk/gtktextview.h index f2c539df61..5d96ca7be8 100644 --- a/gtk/gtktextview.h +++ b/gtk/gtktextview.h @@ -59,7 +59,8 @@ typedef struct _GtkTextViewClass GtkTextViewClass; /* Internal private type. */ typedef struct _GtkTextWindow GtkTextWindow; -struct _GtkTextView { +struct _GtkTextView +{ GtkContainer parent_instance; struct _GtkTextLayout *layout; @@ -120,7 +121,8 @@ struct _GtkTextView { GSList *children; }; -struct _GtkTextViewClass { +struct _GtkTextViewClass +{ GtkContainerClass parent_class; /* These are all RUN_ACTION signals for keybindings */