From 076b2f11d2642d9153938dea34c49d8a345938b1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Corentin=20No=C3=ABl?= Date: Mon, 11 May 2020 18:47:20 +0200 Subject: docs: Fix several missing references in the documentation This fixes several typos and missing references --- docs/reference/gdk/gdk4-docs.xml | 1 + docs/reference/gdk/gdk4-sections.txt | 53 ++++++++++++++++++------- docs/reference/gsk/gsk4-docs.xml | 2 + docs/reference/gsk/gsk4-sections.txt | 73 +++++++++++++++++++++++++++++++++-- docs/reference/gtk/actions.xml | 4 +- docs/reference/gtk/gtk4-docs.xml | 1 + docs/reference/gtk/gtk4-sections.txt | 45 +++++++++------------ docs/reference/gtk/gtk4.types.in | 2 + docs/reference/gtk/migrating-3to4.xml | 24 ++++++------ docs/reference/gtk/question_index.xml | 4 +- docs/reference/gtk/text_widget.xml | 2 +- gdk/gdkapplaunchcontext.c | 2 +- gdk/gdkcontentformats.c | 2 +- gdk/gdkcontentprovider.c | 2 +- gdk/gdkdrag.c | 6 +-- gdk/gdkdragsurface.c | 2 +- gdk/gdkdrawcontext.c | 3 +- gdk/gdkdrop.c | 4 +- gdk/gdkevents.c | 2 +- gdk/gdkpaintable.c | 8 ++-- gdk/gdkpaintable.h | 18 ++++----- gdk/gdkpopup.c | 6 +-- gdk/gdksurface.c | 4 +- gdk/gdktexture.c | 2 +- gsk/broadway/gskbroadwayrenderer.c | 2 +- gsk/gskrenderer.c | 2 +- gsk/gskrendernodeimpl.c | 1 + gtk/gtkaboutdialog.c | 2 +- gtk/gtkappchooserbutton.c | 2 +- gtk/gtkapplication.c | 11 ++---- gtk/gtkbuilderscope.c | 2 +- gtk/gtkconstraint.c | 2 +- gtk/gtkconstraintguide.c | 6 +-- gtk/gtkconstraintlayout.c | 2 +- gtk/gtkdragsource.c | 24 ++++++------ gtk/gtkdroptargetasync.c | 2 +- gtk/gtkeditable.c | 3 +- gtk/gtkemojichooser.c | 4 +- gtk/gtkentry.h | 20 ---------- gtk/gtkenums.h | 2 +- gtk/gtkeventcontroller.c | 2 +- gtk/gtkeventcontrollerfocus.c | 8 ++-- gtk/gtkeventcontrollerscroll.c | 2 +- gtk/gtkfilefilter.h | 2 +- gtk/gtkflattenlistmodel.c | 4 +- gtk/gtkgesturestylus.c | 2 +- gtk/gtkicontheme.c | 20 +++++----- gtk/gtkimage.c | 2 +- gtk/gtklistbox.c | 2 +- gtk/gtkmain.c | 2 +- gtk/gtkmountoperation.c | 2 +- gtk/gtkoverlay.c | 6 +-- gtk/gtkpicture.c | 2 +- gtk/gtkpopovermenu.c | 4 +- gtk/gtkrecentmanager.c | 23 ++++++----- gtk/gtkscrolledwindow.c | 4 +- gtk/gtkshortcutaction.c | 1 - gtk/gtkshortcutsshortcut.c | 2 +- gtk/gtkshow.c | 4 +- gtk/gtksnapshot.c | 8 ++-- gtk/gtktextbuffer.c | 38 +++++++++--------- gtk/gtktextview.c | 2 +- gtk/gtktextview.h | 2 +- gtk/gtkwidget.c | 10 ++--- gtk/gtkwidget.h | 2 +- gtk/gtkwindow.c | 14 +++---- 66 files changed, 297 insertions(+), 232 deletions(-) diff --git a/docs/reference/gdk/gdk4-docs.xml b/docs/reference/gdk/gdk4-docs.xml index 8d8c85e58d..a7291c3ffd 100644 --- a/docs/reference/gdk/gdk4-docs.xml +++ b/docs/reference/gdk/gdk4-docs.xml @@ -40,6 +40,7 @@ + diff --git a/docs/reference/gdk/gdk4-sections.txt b/docs/reference/gdk/gdk4-sections.txt index 12128deb49..b753ee9ece 100644 --- a/docs/reference/gdk/gdk4-sections.txt +++ b/docs/reference/gdk/gdk4-sections.txt @@ -98,6 +98,8 @@ gdk_display_get_monitor_at_surface gdk_display_get_clipboard gdk_display_get_primary_clipboard gdk_display_get_setting +gdk_display_get_startup_notification_id +gdk_display_setup_window_visual gdk_display_map_keyval @@ -145,6 +147,7 @@ gdk_display_manager_get_type Pixbufs pixbufs gdk_pixbuf_get_from_surface +gdk_pixbuf_get_from_texture
@@ -183,8 +186,6 @@ gdk_surface_get_display gdk_surface_hide gdk_surface_is_viewable gdk_surface_get_mapped -gdk_surface_get_width -gdk_surface_get_height gdk_surface_translate_coordinates gdk_surface_begin_resize_drag gdk_surface_begin_move_drag @@ -204,8 +205,6 @@ gdk_surface_get_frame_clock gdk_surface_set_cursor gdk_surface_get_cursor -gdk_surface_set_device_cursor -gdk_surface_get_device_cursor gdk_surface_set_input_region gdk_surface_get_width gdk_surface_get_height @@ -356,9 +355,9 @@ GdkDevice GdkInputSource GdkAxisUse GdkAxisFlags +GdkDeviceTool GdkDeviceToolType GdkDeviceType -GdkGrabOwnership gdk_device_get_name @@ -380,6 +379,12 @@ gdk_device_get_axes gdk_device_get_seat gdk_device_get_num_touches gdk_device_get_device_tool +gdk_device_get_caps_lock_state +gdk_device_get_direction +gdk_device_get_modifier_state +gdk_device_get_num_lock_state +gdk_device_get_scroll_lock_state +gdk_device_has_bidi_layouts gdk_device_get_state @@ -471,6 +476,8 @@ gdk_seat_capabilities_get_type GdkEvent GdkEventType GdkEventMask +GdkKeyMatch +GdkTouchpadGesturePhase GdkScrollDirection GdkCrossingMode GdkNotifyType @@ -512,25 +519,25 @@ gdk_key_event_get_consumed_modifiers gdk_key_event_get_layout gdk_key_event_get_level gdk_key_event_is_modifier -GdkEventMatch gdk_key_event_matches gdk_key_event_get_match gdk_focus_event_get_in gdk_touch_event_get_emulating_pointer gdk_crossing_event_get_mode gdk_crossing_event_get_detail +gdk_crossing_event_get_focus +gdk_grab_broken_event_get_grab_surface +gdk_dnd_event_get_drop gdk_configure_event_get_size gdk_touchpad_event_get_gesture_phase gdk_touchpad_event_get_n_fingers gdk_touchpad_event_get_deltas -gdk_touchpad_pinch_event_get_angle_delta -gdk_touchpad_pinch_event_get_scale -gdk_pad_button_event_get_button -gdk_pad_axis_event_get_value +gdk_touchpad_event_get_pinch_angle_delta +gdk_touchpad_event_get_pinch_scale +gdk_pad_event_get_axis_value +gdk_pad_event_get_button gdk_pad_event_get_group_mode -gdk_drag_event_get_drop -gdk_grab_broken_event_get_grab_surface -gdk_event_get_motion_history +gdk_motion_event_get_history gdk_events_get_angle @@ -553,6 +560,7 @@ gdk_event_sequence_get_type gdkpaintable GdkPaintable GdkPaintable +GdkPaintableInterface GdkPaintableFlags gdk_paintable_get_current_image gdk_paintable_snapshot @@ -567,9 +575,19 @@ gdk_paintable_invalidate_contents gdk_paintable_invalidate_size gdk_paintable_new_empty - + +GdkSnapshot + + +GDK_SNAPSHOT GDK_TYPE_PAINTABLE +GDK_TYPE_SNAPSHOT +GDK_IS_SNAPSHOT + + +GdkSnapshotClass gdk_paintable_get_type +gdk_snapshot_get_type
@@ -743,6 +761,11 @@ gdk_drag_set_hotspot gdk_drag_action_is_unique + +GdkDragSurface +GdkDragSurfaceInterface +gdk_drag_surface_present + gdk_drop_get_display gdk_drop_get_device @@ -769,6 +792,7 @@ GDK_TYPE_DRAG_PROTOCOL GDK_TYPE_DROP GDK_DROP GDK_IS_DROP +GDK_TYPE_DRAG_SURFACE GdkDragClass @@ -1195,6 +1219,7 @@ GdkContentProviderClass gdk_content_provider_new_for_value gdk_content_provider_new_typed gdk_content_provider_new_for_bytes +gdk_content_provider_new_union gdk_content_provider_ref_formats gdk_content_provider_ref_storable_formats gdk_content_provider_content_changed diff --git a/docs/reference/gsk/gsk4-docs.xml b/docs/reference/gsk/gsk4-docs.xml index 63fc1e69fd..ea2952f62c 100644 --- a/docs/reference/gsk/gsk4-docs.xml +++ b/docs/reference/gsk/gsk4-docs.xml @@ -27,4 +27,6 @@ + + diff --git a/docs/reference/gsk/gsk4-sections.txt b/docs/reference/gsk/gsk4-sections.txt index fcacabf12e..be7e79aec2 100644 --- a/docs/reference/gsk/gsk4-sections.txt +++ b/docs/reference/gsk/gsk4-sections.txt @@ -1,5 +1,6 @@
GskRenderer +GskRenderer gsk_renderer_get_surface gsk_renderer_realize gsk_renderer_unrealize @@ -16,7 +17,6 @@ gsk_broadway_renderer_new GSK_IS_RENDERER GSK_RENDERER GSK_TYPE_RENDERER -GskRenderer GskRendererClass gsk_renderer_get_type GSK_TYPE_SCALING_FILTER @@ -24,6 +24,28 @@ GSK_TYPE_SCALING_FILTER
GskRenderNode +GskRenderNode +GskBlendNode +GskBlurNode +GskBorderNode +GskCairoNode +GskClipNode +GskColorMatrixNode +GskColorNode +GskContainerNode +GskCrossFadeNode +GskDebugNode +GskInsetShadowNode +GskLinearGradientNode +GskOpacityNode +GskOutsetShadowNode +GskRepeatingLinearGradientNode +GskRepeatNode +GskRoundedClipNode +GskShadowNode +GskTextNode +GskTextureNode +GskTransformNode gsk_render_node_ref gsk_render_node_unref GskRenderNodeType @@ -42,6 +64,7 @@ gsk_color_node_new gsk_color_node_peek_color gsk_texture_node_new gsk_texture_node_get_texture +GskColorStop gsk_linear_gradient_node_new gsk_linear_gradient_node_peek_start gsk_linear_gradient_node_peek_end @@ -109,6 +132,7 @@ gsk_text_node_new gsk_text_node_peek_font gsk_text_node_peek_glyphs gsk_text_node_peek_color +gsk_text_node_has_color_glyphs gsk_text_node_get_num_glyphs gsk_text_node_get_offset gsk_blur_node_new @@ -121,10 +145,52 @@ gsk_debug_node_get_message GSK_IS_RENDER_NODE GSK_RENDER_NODE GSK_TYPE_RENDER_NODE -GSK_VALUE_HOLDS_RENDER_NODE -GskRenderNode +GSK_TYPE_BLEND_NODE +GSK_TYPE_BLUR_NODE +GSK_TYPE_BORDER_NODE +GSK_TYPE_CAIRO_NODE +GSK_TYPE_CLIP_NODE +GSK_TYPE_COLOR_MATRIX_NODE +GSK_TYPE_COLOR_NODE +GSK_TYPE_CONTAINER_NODE +GSK_TYPE_CROSS_FADE_NODE +GSK_TYPE_DEBUG_NODE +GSK_TYPE_INSET_SHADOW_NODE +GSK_TYPE_LINEAR_GRADIENT_NODE +GSK_TYPE_OPACITY_NODE +GSK_TYPE_OUTSET_SHADOW_NODE +GSK_TYPE_REPEATING_LINEAR_GRADIENT_NODE +GSK_TYPE_REPEAT_NODE +GSK_TYPE_ROUNDED_CLIP_NODE +GSK_TYPE_SHADOW_NODE +GSK_TYPE_TEXT_NODE +GSK_TYPE_TEXTURE_NODE +GSK_TYPE_TRANSFORM_NODE GskRenderNodeClass +gsk_blend_node_get_type +gsk_blur_node_get_type +gsk_border_node_get_type +gsk_broadway_renderer_get_type +gsk_cairo_node_get_type +gsk_cairo_renderer_get_type +gsk_clip_node_get_type +gsk_color_matrix_node_get_type +gsk_color_node_get_type +gsk_container_node_get_type +gsk_cross_fade_node_get_type +gsk_debug_node_get_type +gsk_inset_shadow_node_get_type +gsk_linear_gradient_node_get_type +gsk_opacity_node_get_type +gsk_outset_shadow_node_get_type gsk_render_node_get_type +gsk_repeating_linear_gradient_node_get_type +gsk_repeat_node_get_type +gsk_rounded_clip_node_get_type +gsk_shadow_node_get_type +gsk_text_node_get_type +gsk_texture_node_get_type +gsk_transform_node_get_type GSK_TYPE_BLEND_MODE gsk_serialization_error_quark @@ -185,6 +251,7 @@ gsk_transform_transform_bounds gsk_transform_transform_point GSK_TYPE_TRANSFORM +GSK_TYPE_TRANSFORM_CATEGORY gsk_transform_get_type gsk_transform_new
diff --git a/docs/reference/gtk/actions.xml b/docs/reference/gtk/actions.xml index 0a89b80c54..1deabcb118 100644 --- a/docs/reference/gtk/actions.xml +++ b/docs/reference/gtk/actions.xml @@ -208,8 +208,8 @@ You can convert between detailed action names and split-out - action names and target values using g_action_parse_detailed_action_name() - and g_action_print_detailed_action_name() but usually you will + action names and target values using g_action_parse_detailed_name() + and g_action_print_detailed_name() but usually you will not need to. Most APIs will provide both ways of specifying actions with targets. diff --git a/docs/reference/gtk/gtk4-docs.xml b/docs/reference/gtk/gtk4-docs.xml index 6fcf4d2540..239041ba59 100644 --- a/docs/reference/gtk/gtk4-docs.xml +++ b/docs/reference/gtk/gtk4-docs.xml @@ -361,6 +361,7 @@ + diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt index 807d92b3a9..cd95be60c7 100644 --- a/docs/reference/gtk/gtk4-sections.txt +++ b/docs/reference/gtk/gtk4-sections.txt @@ -261,30 +261,6 @@ GTK_CENTER_BOX_GET_CLASS gtk_center_box_get_type
-
-gtkcenterlayout -GtkCenterLayout -GtkCenterLayout -gtk_center_layout_new -gtk_center_layout_set_start_widget -gtk_center_layout_set_center_widget -gtk_center_layout_set_end_widget -gtk_center_layout_get_start_widget -gtk_center_layout_get_center_widget -gtk_center_layout_get_end_widget -gtk_center_layout_set_baseline_position -gtk_center_layout_get_baseline_position - -GTK_TYPE_CENTER_layout -GTK_CENTER_LAYOUT -GTK_CENTER_LAYOUT_CLASS -GTK_IS_CENTER_LAYOUT -GTK_IS_CENTER_LAYOUT_CLASS -GTK_CENTER_LAYOUT_GET_CLASS - -gtk_center_layout_get_type -
-
gtklistbox GtkListBox @@ -464,6 +440,7 @@ gtk_builder_cscope_get_type gtkbuilder GtkBuilder GtkBuilder +GtkBuilderClosureFlags GtkBuilderError gtk_builder_new gtk_builder_new_from_file @@ -771,6 +748,8 @@ gtk_drawing_area_get_type gtkeditable GtkEditable GtkEditable +GtkEditableInterface +GtkEditableProperties gtk_editable_get_text gtk_editable_set_text gtk_editable_get_chars @@ -1096,6 +1075,7 @@ gtk_file_chooser_get_type
gtkfilechoosernative GtkFileChooserNative +GtkFileChooserNative gtk_file_chooser_native_new gtk_file_chooser_native_get_accept_label gtk_file_chooser_native_set_accept_label @@ -1203,6 +1183,7 @@ gtk_file_filter_get_type gtkfilterlistmodel GtkFilterListModel GtkFilterListModel +GtkFilterListModelFilterFunc gtk_filter_list_model_new gtk_filter_list_model_new_for_type gtk_filter_list_model_set_model @@ -1526,6 +1507,7 @@ gtk_im_context_filter_keypress gtk_im_context_focus_in gtk_im_context_focus_out gtk_im_context_reset +gtk_im_context_set_client_widget gtk_im_context_set_cursor_location gtk_im_context_set_use_preedit gtk_im_context_set_surrounding @@ -2090,8 +2072,10 @@ gtk_recent_manager_error_quark gtkscale GtkScale GtkScale +GtkScaleFormatValueFunc gtk_scale_new gtk_scale_new_with_range +gtk_scale_set_format_value_func gtk_scale_set_digits gtk_scale_set_draw_value gtk_scale_set_has_origin @@ -2530,6 +2514,7 @@ gtk_text_buffer_insert_range_interactive gtk_text_buffer_insert_with_tags gtk_text_buffer_insert_with_tags_by_name gtk_text_buffer_insert_markup +gtk_text_buffer_insert_paintable gtk_text_buffer_delete gtk_text_buffer_delete_interactive gtk_text_buffer_backspace @@ -2572,6 +2557,7 @@ gtk_text_buffer_paste_clipboard gtk_text_buffer_copy_clipboard gtk_text_buffer_cut_clipboard gtk_text_buffer_get_selection_bounds +gtk_text_buffer_get_selection_content gtk_text_buffer_begin_user_action gtk_text_buffer_end_user_action gtk_text_buffer_add_selection_clipboard @@ -2586,8 +2572,6 @@ gtk_text_buffer_undo gtk_text_buffer_redo gtk_text_buffer_begin_irreversible_action gtk_text_buffer_end_irreversible_action -gtk_text_buffer_begin_user_action -gtk_text_buffer_end_user_action GTK_TEXT_BUFFER @@ -3931,6 +3915,7 @@ gtk_snapshot_get_type
gtkwidgetpaintable GtkWidgetPaintable +GtkWidgetPaintable gtk_widget_paintable_new gtk_widget_paintable_get_widget gtk_widget_paintable_set_widget @@ -4079,6 +4064,7 @@ gtk_widget_device_is_shadowed gtk_widget_get_opacity gtk_widget_set_opacity gtk_widget_get_overflow +GtkOverflow gtk_widget_set_overflow gtk_widget_measure gtk_widget_snapshot_child @@ -5822,7 +5808,9 @@ gtk_popover_get_type gtkpopovermenu GtkPopoverMenu GtkPopoverMenu +GtkPopoverMenuFlags gtk_popover_menu_new_from_model +gtk_popover_menu_new_from_model_full gtk_popover_menu_set_menu_model gtk_popover_menu_get_menu_model @@ -5830,6 +5818,7 @@ gtk_popover_menu_get_menu_model GTK_TYPE_POPOVER_MENU GTK_IS_POPOVER_MENU GTK_POPOVER_MENU +GTK_TYPE_POPOVER_MENU_FLAGS gtk_popover_menu_get_type @@ -6013,7 +6002,6 @@ gtk_event_controller_motion_get_type gtkshortcuttrigger GtkShortcutTrigger GtkShortcutTrigger -GtkNeverTrigger gtk_shortcut_trigger_trigger gtk_shortcut_trigger_hash @@ -6054,6 +6042,8 @@ gtk_shortcut_trigger_get_type gtkshortcutaction GtkShortcutAction GtkShortcutAction +GtkShortcutActionFlags +GtkShortcutFunc gtk_shortcut_action_to_string gtk_shortcut_action_print gtk_shortcut_action_parse_string @@ -6634,6 +6624,7 @@ gtk_root_get_type
gtknative GtkNative +GtkNativeInterface gtk_native_get_for_surface gtk_native_get_surface gtk_native_get_renderer diff --git a/docs/reference/gtk/gtk4.types.in b/docs/reference/gtk/gtk4.types.in index 8001a45b68..6930162750 100644 --- a/docs/reference/gtk/gtk4.types.in +++ b/docs/reference/gtk/gtk4.types.in @@ -59,6 +59,7 @@ gtk_drag_icon_get_type gtk_drag_source_get_type gtk_drawing_area_get_type gtk_drop_target_get_type +gtk_drop_target_async_get_type gtk_editable_get_type gtk_emoji_chooser_get_type gtk_entry_buffer_get_type @@ -125,6 +126,7 @@ gtk_menu_button_get_type gtk_message_dialog_get_type gtk_mount_operation_get_type gtk_native_get_type +gtk_native_dialog_get_type gtk_no_selection_get_type gtk_notebook_get_type gtk_notebook_page_get_type diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml index 53c1b67ef1..78a8c1fc94 100644 --- a/docs/reference/gtk/migrating-3to4.xml +++ b/docs/reference/gtk/migrating-3to4.xml @@ -153,7 +153,7 @@ Stop using gdk_pixbuf_get_from_window() and gdk_cairo_set_source_surface() These functions are not supported in GTK 4. Instead, either use backend-specific - APIs, or render your widgets using gtk_widget_render(). + APIs, or render your widgets using #GtkWidgetClass.snapshot().
@@ -331,12 +331,12 @@ If you need to dismiss a popup when the user clicks outside (the most common - use for grabs), you can use the GdkSurface #GdkSurface:autohide property instead. + use for grabs), you can use the GdkPopup #GdkPopup:autohide property instead. GtkPopover also has a #GtkPopover:autohide property. If you need to prevent the user from interacting with a window - while a dialog is open, use #GtkDialog::modal. + while a dialog is open, use #GtkWindow:modal on the dialog.
@@ -355,13 +355,13 @@ In GTK 4, the two roles of a standalone toplevel window and of a popup that is placed relative to a parent window have been separated out into two interfaces, #GdkToplevel - and #GtkPopup. + and #GdkPopup. Surfaces implementing these interfaces are created with gdk_surface_new_toplevel() and gdk_surface_new_popup(), respectively, and they are presented on screen using - gtk_toplevel_present() and gdk_popup_present(). The + gdk_toplevel_present() and gdk_popup_present(). The present() functions take parameters in the form of an auxiliary layout struct, #GdkPopupLayout or #GdkToplevelLayout. @@ -709,7 +709,7 @@
Widgets are now visible by default - The default value of #GtkWidget::visible in GTK 4 is %TRUE, so you no + The default value of #GtkWidget:visible in GTK 4 is %TRUE, so you no longer need to explicitly show all your widgets. On the flip side, you need to hide widgets that are not meant to be visible from the start. @@ -719,7 +719,7 @@ on them. - The function gtk_widget_show_all(), the #GtkWidget::no-show-all property + The function gtk_widget_show_all(), the #GtkWidget:no-show-all property and its getter and setter have been removed in GTK 4, so you should stop using them.
@@ -781,7 +781,7 @@ Stop using GtkWidget::draw The #GtkWidget::draw signal has been removed. Widgets need to implement the - #GtkWidget::snapshot function now. Connecting draw signal handlers is no longer possible. + #GtkWidgetClass.snapshot() function now. Connecting draw signal handlers is no longer possible.
@@ -1009,7 +1009,7 @@ The #GdkSurface functions gdk_surface_iconify() and gdk_surface_deiconify() have been renamed to - gdk_surface_minimize() and gdk_surface_unminimize(), respectively. + gdk_toplevel_minimize() and gdk_toplevel_present(), respectively. The corresponding #GtkWindow functions gtk_window_iconify() @@ -1096,7 +1096,7 @@ The destination-side DND apis in GTK 4 have also been changed to use and event controller, - #GTkDropTarget. + #GtkDropTarget. Instead of calling gtk_drag_dest_set() and connecting to #GtkWidget signals, you create @@ -1104,9 +1104,9 @@ connect to #GtkDropTarget signals. - The ::drag-motion signal has been renamed to #GtkDragSource::accept, and instead of + The ::drag-motion signal has been renamed to #GtkDropTarget::accept, and instead of ::drag-data-received, you need to use async read methods on the #GdkDrop object, such - as gdk_drop_read_value_async() or gdk_drop_read_text_async(). + as gdk_drop_read_async() or gdk_drop_read_value_async().
diff --git a/docs/reference/gtk/question_index.xml b/docs/reference/gtk/question_index.xml index 0cd8062185..75b4d5be38 100644 --- a/docs/reference/gtk/question_index.xml +++ b/docs/reference/gtk/question_index.xml @@ -919,8 +919,8 @@ How do I use cairo to draw in GTK applications ? -Use gtk_snapshot_append_cairo() in your #GtkWidget::snapshot signal handler -to optain a cairo context and draw with that. +Use gtk_snapshot_append_cairo() in your #GtkWidgetClass.snapshot() vfunc to optain +a cairo context and draw with that. diff --git a/docs/reference/gtk/text_widget.xml b/docs/reference/gtk/text_widget.xml index e0efd6ccd8..bea104ac9d 100644 --- a/docs/reference/gtk/text_widget.xml +++ b/docs/reference/gtk/text_widget.xml @@ -113,7 +113,7 @@ considered a line separator. -Text buffers support undo and redo if gtk_text_buffer_set_undo_enabled() +Text buffers support undo and redo if gtk_text_buffer_set_enable_undo() has been set to %TRUE. Use gtk_text_buffer_undo() or gtk_text_buffer_redo() to perform the necessary action. Note that these operations are ignored if the buffer is not editable. Developers may want some operations to not be diff --git a/gdk/gdkapplaunchcontext.c b/gdk/gdkapplaunchcontext.c index b59e4f4adc..a3410f6cd8 100644 --- a/gdk/gdkapplaunchcontext.c +++ b/gdk/gdkapplaunchcontext.c @@ -177,7 +177,7 @@ gdk_app_launch_context_get_display_name (GAppLaunchContext *context, * gdk_app_launch_context_get_display: * @context: a #GdkAppLaunchContext * - * Gets the #GdkDispolat that @context is for. + * Gets the #GdkDisplay that @context is for. * * Returns: (transfer none): the display of @context */ diff --git a/gdk/gdkcontentformats.c b/gdk/gdkcontentformats.c index 7a616fc539..ec0ac53876 100644 --- a/gdk/gdkcontentformats.c +++ b/gdk/gdkcontentformats.c @@ -35,7 +35,7 @@ * * A #GdkContentFormats describes a set of possible formats content can be * exchanged in. It is assumed that this set is ordered. #GTypes are more - * important than mime types. Order between different #Gtypes or mime types + * important than mime types. Order between different #GTypes or mime types * is the order they were added in, most important first. Functions that * care about order, such as gdk_content_formats_union() will describe in * their documentation how they interpret that order, though in general the diff --git a/gdk/gdkcontentprovider.c b/gdk/gdkcontentprovider.c index e4c6afda45..4253ea4203 100644 --- a/gdk/gdkcontentprovider.c +++ b/gdk/gdkcontentprovider.c @@ -259,7 +259,7 @@ gdk_content_provider_ref_storable_formats (GdkContentProvider *provider) * gdk_content_provider_content_changed: * @provider: a #GdkContentProvider * - * Emits the #GdkContentProvider::contents-changed signal. + * Emits the #GdkContentProvider::content-changed signal. */ void gdk_content_provider_content_changed (GdkContentProvider *provider) diff --git a/gdk/gdkdrag.c b/gdk/gdkdrag.c index 15cb169603..31f947d8b1 100644 --- a/gdk/gdkdrag.c +++ b/gdk/gdkdrag.c @@ -99,7 +99,7 @@ G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE (GdkDrag, gdk_drag, G_TYPE_OBJECT) * It is created when a drag is started, and stays alive for duration of * the DND operation. After a drag has been started with gdk_drag_begin(), * the caller gets informed about the status of the ongoing drag operation - * with signals on the #GtkDrag object. + * with signals on the #GdkDrag object. * * The GdkDrop object represents the target side of an ongoing DND operation. * Possible drop sites get informed about the status of the ongoing drag operation @@ -108,8 +108,8 @@ G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE (GdkDrag, gdk_drag, G_TYPE_OBJECT) * using gdk_event_get_drop(). * * The actual data transfer is initiated from the target side via an async - * read, using one of the GdkDrop functions for this purpose: gdk_drop_read_async(), - * gdk_drop_read_value_async() or gdk_drop_read_text_async(). + * read, using one of the GdkDrop functions for this purpose: gdk_drop_read_async() + * or gdk_drop_read_value_async(). * * GTK provides a higher level abstraction based on top of these functions, * and so they are not normally needed in GTK applications. See the diff --git a/gdk/gdkdragsurface.c b/gdk/gdkdragsurface.c index 4eb3c9137f..1bbafdc672 100644 --- a/gdk/gdkdragsurface.c +++ b/gdk/gdkdragsurface.c @@ -24,7 +24,7 @@ #include "gdkintl.h" /** - * SECTION:gdkdragsurface + * SECTION:dnd * @Short_description: Interface for drag surface surfaces * @Title: Drag surfaces * diff --git a/gdk/gdkdrawcontext.c b/gdk/gdkdrawcontext.c index 35a7fea282..6819cb74bd 100644 --- a/gdk/gdkdrawcontext.c +++ b/gdk/gdkdrawcontext.c @@ -198,7 +198,8 @@ gdk_draw_context_init (GdkDrawContext *self) * In this situation, drawing commands may be effecting the contents of a * @context's surface. * - * Returns: %TRUE if the context is between begin_frame() and end_frame() calls. + * Returns: %TRUE if the context is between gdk_draw_context_begin_frame() + * and gdk_draw_context_end_frame() calls. */ gboolean gdk_draw_context_is_in_frame (GdkDrawContext *context) diff --git a/gdk/gdkdrop.c b/gdk/gdkdrop.c index 3ee92a9ecb..f5b85c1993 100644 --- a/gdk/gdkdrop.c +++ b/gdk/gdkdrop.c @@ -479,7 +479,7 @@ gdk_drop_get_surface (GdkDrop *self) * * Returns the possible actions for this #GdkDrop. If this value * contains multiple actions - ie gdk_drag_action_is_unique() - * returns %FALSE for the result - gdk_drag_finish() must choose + * returns %FALSE for the result - gdk_drop_finish() must choose * the action to use when accepting the drop. This will only * happen if you passed %GDK_ACTION_ASK as one of the possible * actions in gdk_drag_status(). %GDK_ACTION_ASK itself will not @@ -487,7 +487,7 @@ gdk_drop_get_surface (GdkDrop *self) * * This value may change over the lifetime of the #GdkDrop both * as a response to source side actions as well as to calls to - * gdk_drop_status() or gdk_drag_finish(). The source side will + * gdk_drop_status() or gdk_drop_finish(). The source side will * not change this value anymore once a drop has started. * * Returns: The possible #GdkDragActions diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c index d514e64b04..5495d5e6ca 100644 --- a/gdk/gdkevents.c +++ b/gdk/gdkevents.c @@ -1695,7 +1695,7 @@ gdk_key_event_matches (GdkEvent *event, * @modifiers: (out): return location for modifiers * * Gets a keyval and modifier combination that will cause - * gdk_event_match() to successfully match the given event. + * gdk_key_event_matches() to successfully match the given event. * * Returns: %TRUE on success */ diff --git a/gdk/gdkpaintable.c b/gdk/gdkpaintable.c index 5f708d77ee..cedda107e3 100644 --- a/gdk/gdkpaintable.c +++ b/gdk/gdkpaintable.c @@ -58,7 +58,7 @@ void gtk_snapshot_pop (GdkSnapshot * gdk_paintable_invalidate_contents() which will emit the * #GdkPaintable::invalidate-contents signal. * If a paintable is known to never change its contents, it will set the - * %GDK_PAINTABLE_STATIC_CONTENT flag. If a consumer cannot deal with changing + * %GDK_PAINTABLE_STATIC_CONTENTS flag. If a consumer cannot deal with changing * contents, it may call gdk_paintable_get_static_image() which will return a * static paintable and use that. * @@ -370,7 +370,7 @@ gdk_paintable_get_intrinsic_aspect_ratio (GdkPaintable *paintable) * Unless the contents are invalidated, implementations must guarantee that * multiple calls to GdkPaintable::snapshot produce the same output. * - * This function will emit the GdkPaintable::invalidate-contents signal. + * This function will emit the #GdkPaintable::invalidate-contents signal. * * If a @paintable reports the %GDK_PAINTABLE_STATIC_CONTENTS flag, * it must not call this function. @@ -392,7 +392,7 @@ gdk_paintable_invalidate_contents (GdkPaintable *paintable) * As long as the size is not invalidated, @paintable must return the same values * for its width, height and intrinsic height. * - * This function will emit the GdkPaintable::invalidate-size signal. + * This function will emit the #GdkPaintable::invalidate-size signal. * * If a @paintable reports the %GDK_PAINTABLE_STATIC_SIZE flag, * it must not call this function. @@ -630,7 +630,7 @@ gdk_empty_paintable_init (GdkEmptyPaintable *self) * @intrinsic_height: The intrinsic height to report. Can be 0 for no height. * * Returns a paintable that has the given intrinsic size and draws nothing. - * This is often useful for implementing the GdkPaintableClass:get_current_image() + * This is often useful for implementing the #GdkPaintableInterface.get_current_image() * virtual function when the paintable is in an incomplete state (like a * #GtkMediaStream before receiving the first frame). * diff --git a/gdk/gdkpaintable.h b/gdk/gdkpaintable.h index b32918c633..b6efee983c 100644 --- a/gdk/gdkpaintable.h +++ b/gdk/gdkpaintable.h @@ -37,10 +37,10 @@ G_DECLARE_INTERFACE (GdkPaintable, gdk_paintable, GDK, PAINTABLE, GObject) /** * GdkPaintableFlags: * @GDK_PAINTABLE_STATIC_SIZE: The size is immutable. - * The GdkPaintable::invalidate-size signal will never be + * The #GdkPaintable::invalidate-size signal will never be * emitted. * @GDK_PAINTABLE_STATIC_CONTENTS: The content is immutable. - * The GdkPaintable::invalidate-content signal will never be + * The #GdkPaintable::invalidate-contents signal will never be * emitted. * * Flags about this object. Implementations use these for optimizations @@ -69,16 +69,16 @@ typedef enum { * snapshot at or 0 if none. This is purely a hint. The object must still * be able to render at any size. * @get_intrinsic_aspect_ratio: The preferred aspect ratio for this object - * or 0 if none. If both GdkPaintable:get_intrinsic_width() and - * GdkPaintable:get_intrinsic_height() return non-zero values, this function - * should return the aspect ratio computed from those. + * or 0 if none. If both #GdkPaintableInterface.get_intrinsic_width() and + * #GdkPaintableInterface.get_intrinsic_height() return non-zero values, + * this function should return the aspect ratio computed from those. * * The list of functions that can be implemented for the #GdkPaintable interface. * Note that apart from the first function, no function is mandatory to implement, - * though it is a good idea to implement GdkPaintable:get_current_image() for - * non-static paintables and GdkPaintable:get_flags() if the image is not dynamic - * as the default implementation returns no flags and that will make the - * implementation likely quite slow. + * though it is a good idea to implement #GdkPaintableInterface.get_current_image() + * for non-static paintables and #GdkPaintableInterface.get_flags() if the image + * is not dynamic as the default implementation returns no flags and that will + * make the implementation likely quite slow. */ struct _GdkPaintableInterface { diff --git a/gdk/gdkpopup.c b/gdk/gdkpopup.c index d6f3ef971a..8feacd4a9b 100644 --- a/gdk/gdkpopup.c +++ b/gdk/gdkpopup.c @@ -102,9 +102,9 @@ gdk_popup_default_init (GdkPopupInterface *iface) * otherwise it will change position according to @layout. * * After calling this function, the result of the layout can be queried - * using gdk_popup_get_position(), gdk_surface_get_width(), - * gdk_surface_get_height(), gdk_popup_get_rect_anchor() and - * gdk_popup_get_surface_anchor(). + * using gdk_popup_get_position_x(), gdk_popup_get_position_y(), + * gdk_surface_get_width(), gdk_surface_get_height(), + * gdk_popup_get_rect_anchor() and gdk_popup_get_surface_anchor(). * * Presenting may have fail, for example if it was immediately * hidden if the @popup was set to autohide. diff --git a/gdk/gdksurface.c b/gdk/gdksurface.c index 26a5fe9e90..c4a058e75d 100644 --- a/gdk/gdksurface.c +++ b/gdk/gdksurface.c @@ -1910,7 +1910,7 @@ gdk_surface_get_device_cursor (GdkSurface *surface, * @cursor: a #GdkCursor * * Sets a specific #GdkCursor for a given device when it gets inside @surface. - * Use gdk_cursor_new_fromm_name() or gdk_cursor_new_from_texture() to create + * Use gdk_cursor_new_from_name() or gdk_cursor_new_from_texture() to create * the cursor. To make the cursor invisible, use %GDK_BLANK_CURSOR. Passing * %NULL for the @cursor argument to gdk_surface_set_cursor() means that * @surface will use the cursor of its parent surface. Most surfaces should @@ -2674,7 +2674,7 @@ gdk_surface_get_unscaled_size (GdkSurface *surface, * GTK will update this property automatically if * the @surface background is opaque, as we know where the opaque regions * are. If your surface background is not opaque, please update this - * property in your #GtkWidget:css-changed handler. + * property in your #GtkWidgetClass.css_changed() handler. */ void gdk_surface_set_opaque_region (GdkSurface *surface, diff --git a/gdk/gdktexture.c b/gdk/gdktexture.c index c939de4a90..efbed8ab1b 100644 --- a/gdk/gdktexture.c +++ b/gdk/gdktexture.c @@ -50,7 +50,7 @@ gtk_snapshot_append_texture (GdkSnapshot *snapshot, const graphene_rect_t *bounds); /** - * SECTION:gdktexture + * SECTION:textures * @Short_description: Image data for display * @Title: GdkTexture * diff --git a/gsk/broadway/gskbroadwayrenderer.c b/gsk/broadway/gskbroadwayrenderer.c index 89def7e807..2144a4b63d 100644 --- a/gsk/broadway/gskbroadwayrenderer.c +++ b/gsk/broadway/gskbroadwayrenderer.c @@ -841,7 +841,7 @@ gsk_broadway_renderer_init (GskBroadwayRenderer *self) * * The Broadway renderer is the default renderer for the broadway backend. * It will only work with broadway surfaces, otherwise it will fail the - * call to gdk_renderer_realize(). + * call to gsk_renderer_realize(). * * This function is only available when GTK was compiled with Broadway * support. diff --git a/gsk/gskrenderer.c b/gsk/gskrenderer.c index 33833138b7..7563c5bb6f 100644 --- a/gsk/gskrenderer.c +++ b/gsk/gskrenderer.c @@ -315,7 +315,7 @@ gsk_renderer_unrealize (GskRenderer *renderer) /** * gsk_renderer_render_texture: - * @renderer: a realized #GdkRenderer + * @renderer: a realized #GskRenderer * @root: a #GskRenderNode * @viewport: (allow-none): the section to draw or %NULL to use @root's bounds * diff --git a/gsk/gskrendernodeimpl.c b/gsk/gskrendernodeimpl.c index 9469118b11..767e7f87c7 100644 --- a/gsk/gskrendernodeimpl.c +++ b/gsk/gskrendernodeimpl.c @@ -3021,6 +3021,7 @@ gsk_shadow_node_get_child (GskRenderNode *node) /** * gsk_shadow_node_peek_shadow: * @node: (type GskShadowNode): a shadow #GskRenderNode + * @i: the given index * * Retrieves the shadow data at the given index @i. * diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c index 1c33631696..f1c12d45b6 100644 --- a/gtk/gtkaboutdialog.c +++ b/gtk/gtkaboutdialog.c @@ -1316,7 +1316,7 @@ gtk_about_dialog_get_system_information (GtkAboutDialog *about) * dialog. If @system_information is %NULL, the system information * tab is hidden. * - * See #GtkAboutdialog:system-information. + * See #GtkAboutDialog:system-information. */ void gtk_about_dialog_set_system_information (GtkAboutDialog *about, diff --git a/gtk/gtkappchooserbutton.c b/gtk/gtkappchooserbutton.c index d8a8e66e3c..57a602e588 100644 --- a/gtk/gtkappchooserbutton.c +++ b/gtk/gtkappchooserbutton.c @@ -44,7 +44,7 @@ * emitted when they are selected. * * To track changes in the selected application, use the - * #GtkAppChooserbutton::changed signal. + * #GtkAppChooserButton::changed signal. */ #include "config.h" diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c index 2f4a3ceaf2..f4ca2b1744 100644 --- a/gtk/gtkapplication.c +++ b/gtk/gtkapplication.c @@ -759,7 +759,7 @@ gtk_application_class_init (GtkApplicationClass *class) * @application: the #GtkApplication which emitted the signal * * Emitted when the session manager is about to end the session, only - * if #GtkApplication::register-session is %TRUE. Applications can + * if #GtkApplication:register-session is %TRUE. Applications can * connect to this signal and call gtk_application_inhibit() with * %GTK_APPLICATION_INHIBIT_LOGOUT to delay the end of the session * until state has been saved. @@ -775,7 +775,7 @@ gtk_application_class_init (GtkApplicationClass *class) * * Set this property to %TRUE to register with the session manager. * This will make GTK+ track the session state (such as the - * #GtkApplication::screensaver-active property). + * #GtkApplication:screensaver-active property). */ gtk_application_props[PROP_REGISTER_SESSION] = g_param_spec_boolean ("register-session", @@ -789,11 +789,9 @@ gtk_application_class_init (GtkApplicationClass *class) * * This property is %TRUE if GTK+ believes that the screensaver is * currently active. GTK+ only tracks session state (including this) - * when #GtkApplication::register-session is set to %TRUE. + * when #GtkApplication:register-session is set to %TRUE. * * Tracking the screensaver state is supported on Linux. - * - * Since: 3.24 */ gtk_application_props[PROP_SCREENSAVER_ACTIVE] = g_param_spec_boolean ("screensaver-active", @@ -853,8 +851,7 @@ gtk_application_class_init (GtkApplicationClass *class) * g_application_id_is_valid(). * * If no application ID is given then some features (most notably application - * uniqueness) will be disabled. A null application ID is only allowed with - * GTK+ 3.6 or later. + * uniqueness) will be disabled. * * Returns: a new #GtkApplication instance */ diff --git a/gtk/gtkbuilderscope.c b/gtk/gtkbuilderscope.c index 21d00c103c..de6003b7d5 100644 --- a/gtk/gtkbuilderscope.c +++ b/gtk/gtkbuilderscope.c @@ -406,7 +406,7 @@ gtk_builder_cscope_init (GtkBuilderCScope *self) /** * gtk_builder_cscope_new: * - * Creates a new #GtkbuilderCScope object to use with future #GtkBuilder + * Creates a new #GtkBuilderCScope object to use with future #GtkBuilder * instances. * * Calling this function is only necessary if you want to add custom diff --git a/gtk/gtkconstraint.c b/gtk/gtkconstraint.c index 37b4e449ae..8bef75eced 100644 --- a/gtk/gtkconstraint.c +++ b/gtk/gtkconstraint.c @@ -560,7 +560,7 @@ gtk_constraint_is_attached (GtkConstraint *constraint) * @constraint: a #GtkConstraint * * Checks whether the @constraint describes a relation between an attribute - * on the #GtkConstraint:target-widget and a constant value. + * on the #GtkConstraint:target and a constant value. * * Returns: %TRUE if the constraint is a constant relation */ diff --git a/gtk/gtkconstraintguide.c b/gtk/gtkconstraintguide.c index de7bb03499..3d93cc2953 100644 --- a/gtk/gtkconstraintguide.c +++ b/gtk/gtkconstraintguide.c @@ -488,7 +488,7 @@ gtk_constraint_guide_set_min_size (GtkConstraintGuide *guide, /** * gtk_constraint_guide_get_min_size: - * @guide: a #GtkContraintGuide object + * @guide: a #GtkConstraintGuide object * @width: (allow-none): return location for the minimum width, * or %NULL * @height: (allow-none): return location for the minimum height, @@ -542,7 +542,7 @@ gtk_constraint_guide_set_nat_size (GtkConstraintGuide *guide, /** * gtk_constraint_guide_get_nat_size: - * @guide: a #GtkContraintGuide object + * @guide: a #GtkConstraintGuide object * @width: (allow-none): return location for the natural width, * or %NULL * @height: (allow-none): return location for the natural height, @@ -596,7 +596,7 @@ gtk_constraint_guide_set_max_size (GtkConstraintGuide *guide, /** * gtk_constraint_guide_get_max_size: - * @guide: a #GtkContraintGuide object + * @guide: a #GtkConstraintGuide object * @width: (allow-none): return location for the maximum width, * or %NULL * @height: (allow-none): return location for the maximum height, diff --git a/gtk/gtkconstraintlayout.c b/gtk/gtkconstraintlayout.c index 91f1e13c03..6b88ecf57a 100644 --- a/gtk/gtkconstraintlayout.c +++ b/gtk/gtkconstraintlayout.c @@ -1833,7 +1833,7 @@ gtk_constraint_layout_add_guide (GtkConstraintLayout *layout, /** * gtk_constraint_layout_remove_guide: - * @layout: a #GtkConstraintManager + * @layout: a #GtkConstraintLayout * @guide: a #GtkConstraintGuide object * * Removes @guide from the layout manager, diff --git a/gtk/gtkdragsource.c b/gtk/gtkdragsource.c index 017bee493c..1cb8674aa8 100644 --- a/gtk/gtkdragsource.c +++ b/gtk/gtkdragsource.c @@ -70,7 +70,7 @@ * can be used to obtain updates about the status of the operation, * but it is not normally necessary to connect to any signals, * except for one case: when the supported actions include - * %GDK_DRAG_MOVE, you need to listen for the + * %GDK_ACTION_MOVE, you need to listen for the * #GtkDragSource::drag-end signal and delete the * data after it has been transferred. */ @@ -309,7 +309,7 @@ gtk_drag_source_class_init (GtkDragSourceClass *class) * The ::prepare signal is emitted when a drag is about to be initiated. * It returns the * #GdkContentProvider to use for the drag that is about * to start. The default handler for this signal returns the value of - * the #GtkDragSource::content property, so if you set up that property + * the #GtkDragSource:content property, so if you set up that property * ahead of time, you don't need to connect to this signal. * * Returns: (transfer full) (nullable): a #GdkContentProvider, or %NULL @@ -327,7 +327,7 @@ gtk_drag_source_class_init (GtkDragSourceClass *class) /** * GtkDragSource::drag-begin: * @source: the #GtkDragSource - * @drag: the #GtkDrag object + * @drag: the #GdkDrag object * * The ::drag-begin signal is emitted on the drag source when a drag * is started. It can be used to e.g. set a custom drag icon with @@ -346,7 +346,7 @@ gtk_drag_source_class_init (GtkDragSourceClass *class) /** * GtkDragSource::drag-end: * @source: the #GtkDragSource - * @drag: the #GtkDrag object + * @drag: the #GdkDrag object * @delete_data: %TRUE if the drag was performing %GDK_ACTION_MOVE, * and the data should be deleted * @@ -368,7 +368,7 @@ gtk_drag_source_class_init (GtkDragSourceClass *class) /** * GtkDragSource::drag-cancel: * @source: the #GtkDragSource - * @drag: the #GtkDrag object + * @drag: the #GdkDrag object * @reason: information on why the drag failed * * The ::drag-cancel signal is emitted on the drag source when a drag has @@ -554,20 +554,20 @@ gtk_drag_source_new (void) * * Gets the current content provider of a #GtkDragSource. * - * Returns: (transfer none): the #GtkContentProvider of @source + * Returns: (transfer none): the #GdkContentProvider of @source */ GdkContentProvider * gtk_drag_source_get_content (GtkDragSource *source) { g_return_val_if_fail (GTK_IS_DRAG_SOURCE (source), NULL); - return source->content; + return source->content; } /** * gtk_drag_source_set_content: * @source: a #GtkDragSource - * @content: (nullable): a #GtkContentProvider, or %NULL + * @content: (nullable): a #GdkContentProvider, or %NULL * * Sets a content provider on a #GtkDragSource. * @@ -579,7 +579,7 @@ gtk_drag_source_get_content (GtkDragSource *source) * or in a handler for the #GtkDragSource::prepare signal. * * You may consider setting the content provider back to - * %NULL in a #GTkDragSource::drag-end signal handler. + * %NULL in a #GtkDragSource::drag-end signal handler. */ void gtk_drag_source_set_content (GtkDragSource *source, @@ -619,7 +619,7 @@ gtk_drag_source_get_actions (GtkDragSource *source) * During a DND operation, the actions are offered * to potential drop targets. If @actions include * %GDK_ACTION_MOVE, you need to listen to the - * #GtkDraGSource::drag-end signal and handle + * #GtkDragSource::drag-end signal and handle * @delete_data being %TRUE. * * This function can be called before a drag is started, @@ -642,7 +642,7 @@ gtk_drag_source_set_actions (GtkDragSource *source, /** * gtk_drag_source_set_icon: * @source: a #GtkDragSource - * @paintable: (nullable): the #GtkPaintable to use as icon, or %NULL + * @paintable: (nullable): the #GdkPaintable to use as icon, or %NULL * @hot_x: the hotspot X coordinate on the icon * @hot_y: the hotspot Y coordinate on the icon * @@ -674,7 +674,7 @@ gtk_drag_source_set_icon (GtkDragSource *source, * gtk_drag_source_get_drag: * @source: a #GtkDragSource * - * Returns the underlying #GtkDrag object for an ongoing drag. + * Returns the underlying #GdkDrag object for an ongoing drag. * * Returns: (nullable) (transfer none): the #GdkDrag of the current drag operation, or %NULL */ diff --git a/gtk/gtkdroptargetasync.c b/gtk/gtkdroptargetasync.c index 4eb2ec0622..fbed6ee319 100644 --- a/gtk/gtkdroptargetasync.c +++ b/gtk/gtkdroptargetasync.c @@ -405,7 +405,7 @@ gtk_drop_target_async_class_init (GtkDropTargetAsyncClass *class) g_object_class_install_properties (object_class, NUM_PROPERTIES, properties); /** - * GtkWidget::accept: + * GtkDropTargetAsync::accept: * @self: the #GtkDropTargetAsync * @drop: the #GdkDrop * diff --git a/gtk/gtkeditable.c b/gtk/gtkeditable.c index 1ee33acdbf..ff36a044cf 100644 --- a/gtk/gtkeditable.c +++ b/gtk/gtkeditable.c @@ -102,7 +102,8 @@ * ]| * * You don't need to provide any other vfuncs. The default implementations - * work by forwarding to the delegate that the get_delegate() vfunc returns. + * work by forwarding to the delegate that the #GtkEditableInterface.get_delegate() + * vfunc returns. * * In your instance_init function, create your text widget, and then call * gtk_editable_init_delegate(): diff --git a/gtk/gtkemojichooser.c b/gtk/gtkemojichooser.c index 89479f5ca5..7cd3f2b1cf 100644 --- a/gtk/gtkemojichooser.c +++ b/gtk/gtkemojichooser.c @@ -47,7 +47,7 @@ * The #GtkEmojiChooser popover is used by text widgets such as #GtkEntry or * #GtkTextView to offer users a convenient way to insert Emoji characters. * - * GtkEmojiChooser emits the #GtkEmojiChooser:emoji-picked signal when an + * GtkEmojiChooser emits the #GtkEmojiChooser::emoji-picked signal when an * Emoji is selected. * * # CSS nodes @@ -1078,7 +1078,7 @@ gtk_emoji_chooser_class_init (GtkEmojiChooserClass *klass) * * Creates a new #GtkEmojiChooser. * - * Returns: a new #GtkEmojiChoser + * Returns: a new #GtkEmojiChooser */ GtkWidget * gtk_emoji_chooser_new (void) diff --git a/gtk/gtkentry.h b/gtk/gtkentry.h index a16331f300..06ae90d818 100644 --- a/gtk/gtkentry.h +++ b/gtk/gtkentry.h @@ -77,26 +77,6 @@ struct _GtkEntry * @parent_class: The parent class. * @activate: Class handler for the #GtkEntry::activate signal. The default * implementation activates the gtk.activate-default action. - * @move_cursor: Class handler for the #GtkEntry::move-cursor signal. The - * default implementation specifies the standard #GtkEntry cursor movement - * behavior. - * @insert_at_cursor: Class handler for the #GtkEntry::insert-at-cursor signal. - * The default implementation inserts text at the cursor. - * @delete_from_cursor: Class handler for the #GtkEntry::delete-from-cursor - * signal. The default implementation deletes the selection or the specified - * number of characters or words. - * @backspace: Class handler for the #GtkEntry::backspace signal. The default - * implementation deletes the selection or a single character or word. - * @cut_clipboard: Class handler for the #GtkEntry::cut-clipboard signal. The - * default implementation cuts the selection, if one exists. - * @copy_clipboard: Class handler for the #GtkEntry::copy-clipboard signal. The - * default implementation copies the selection, if one exists. - * @paste_clipboard: Class handler for the #GtkEntry::paste-clipboard signal. - * The default implementation pastes at the current cursor position or over - * the current selection if one exists. - * @toggle_overwrite: Class handler for the #GtkEntry::toggle-overwrite signal. - * The default implementation toggles overwrite mode and blinks the cursor. - * @insert_emoji: Class handler for the #GtkEntry::insert-emoji signal. * * Class structure for #GtkEntry. All virtual functions have a default * implementation. Derived classes may set the virtual function pointers for the diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h index d7611f0f36..dc56bed97d 100644 --- a/gtk/gtkenums.h +++ b/gtk/gtkenums.h @@ -984,7 +984,7 @@ typedef enum { * GtkPickFlags: * @GTK_PICK_DEFAULT: The default behavior, include widgets that are receiving events * @GTK_PICK_INSENSITIVE: Include widgets that are insensitive - * @GTK_PICK_NON_TARGETABLE: Include widgets that are marked as non-targetable. See #GtkWidget::can-target + * @GTK_PICK_NON_TARGETABLE: Include widgets that are marked as non-targetable. See #GtkWidget:can-target * * Flags that influence the behavior of gtk_widget_pick() */ diff --git a/gtk/gtkeventcontroller.c b/gtk/gtkeventcontroller.c index 52d91719c2..c513ea093d 100644 --- a/gtk/gtkeventcontroller.c +++ b/gtk/gtkeventcontroller.c @@ -407,7 +407,7 @@ gtk_event_controller_get_widget (GtkEventController *controller) * @controller: a #GtkEventController * * Resets the @controller to a clean state. Every interaction - * the controller did through gtk_event_controll_handle_event() + * the controller did through gtk_event_controller_handle_event() * will be dropped at this point. **/ void diff --git a/gtk/gtkeventcontrollerfocus.c b/gtk/gtkeventcontrollerfocus.c index 500a09b99a..46c8faba91 100644 --- a/gtk/gtkeventcontrollerfocus.c +++ b/gtk/gtkeventcontrollerfocus.c @@ -190,8 +190,8 @@ gtk_event_controller_focus_class_init (GtkEventControllerFocusClass *klass) * #GtkEventControllerFocus:contains-focus. * * When handling focus events, this property is updated - * before #GtkEventControllerFocus::focus-in or - * #GtkEventControllerFocus::focus-out are emitted. + * before #GtkEventControllerKey::focus-in or + * #GtkEventControllerKey::focus-out are emitted. */ props[PROP_IS_FOCUS] = g_param_spec_boolean ("is-focus", @@ -208,8 +208,8 @@ gtk_event_controller_focus_class_init (GtkEventControllerFocusClass *klass) * or inside a descendent. * * When handling focus events, this property is updated - * before #GtkEventControllerFocus::focus-in or - * #GtkEventControllerFocus::focus-out are emitted. + * before #GtkEventControllerFocus::enter or + * #GtkEventControllerFocus::leave are emitted. */ props[PROP_CONTAINS_FOCUS] = g_param_spec_boolean ("contains-focus", diff --git a/gtk/gtkeventcontrollerscroll.c b/gtk/gtkeventcontrollerscroll.c index d1e43491de..f10ba6085d 100644 --- a/gtk/gtkeventcontrollerscroll.c +++ b/gtk/gtkeventcontrollerscroll.c @@ -41,7 +41,7 @@ * * The controller can be set up to emit motion for either/both vertical * and horizontal scroll events through #GTK_EVENT_CONTROLLER_SCROLL_VERTICAL, - * #GTK_EVENT_CONTROLLER_SCROLL_HORIZONTAL and #GTK_EVENT_CONTROLLER_SCROLL_BOTH. + * #GTK_EVENT_CONTROLLER_SCROLL_HORIZONTAL and #GTK_EVENT_CONTROLLER_SCROLL_BOTH_AXES. * If any axis is disabled, the respective #GtkEventControllerScroll::scroll * delta will be 0. Vertical scroll events will be translated to horizontal * motion for the devices incapable of horizontal scrolling. diff --git a/gtk/gtkfilefilter.h b/gtk/gtkfilefilter.h index 715556546a..c3ee9eb3f1 100644 --- a/gtk/gtkfilefilter.h +++ b/gtk/gtkfilefilter.h @@ -77,7 +77,7 @@ typedef gboolean (*GtkFileFilterFunc) (const GtkFileFilterInfo *filter_info, * in the file chooser * @mime_type: the mime type of the file * - * A #GtkFileFilterInfo-struct is used to pass information about the + * A #GtkFileFilterInfo is used to pass information about the * tested file to gtk_file_filter_filter(). */ struct _GtkFileFilterInfo diff --git a/gtk/gtkflattenlistmodel.c b/gtk/gtkflattenlistmodel.c index f557cb2232..78ea061a53 100644 --- a/gtk/gtkflattenlistmodel.c +++ b/gtk/gtkflattenlistmodel.c @@ -419,7 +419,7 @@ gtk_flatten_list_model_class_init (GtkFlattenListModelClass *class) /** * GtkFlattenListModel:item-type: * - * The #GTpe for elements of this object + * The #GType for elements of this object */ properties[PROP_ITEM_TYPE] = g_param_spec_gtype ("item-type", @@ -482,7 +482,7 @@ gtk_flatten_list_model_new (GType item_type, * @model: (nullable) (transfer none): the new model or %NULL * * Sets a new model to be flattened. The model must contain items of - * #GtkListModel that conform to the item type of @self. + * #GListModel that conform to the item type of @self. **/ void gtk_flatten_list_model_set_model (GtkFlattenListModel *self, diff --git a/gtk/gtkgesturestylus.c b/gtk/gtkgesturestylus.c index 974d83f0a9..da0dbc868f 100644 --- a/gtk/gtkgesturestylus.c +++ b/gtk/gtkgesturestylus.c @@ -265,7 +265,7 @@ gtk_gesture_stylus_get_axes (GtkGestureStylus *gesture, * By default, GTK+ will limit rate of input events. On stylus input where * accuracy of strokes is paramount, this function returns the accumulated * coordinate/timing state before the emission of the current - * #GtkGestureStylus:motion signal. + * #GtkGestureStylus::motion signal. * * This function may only be called within a #GtkGestureStylus::motion * signal handler, the state given in this signal and obtainable through diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c index 76d46c4948..0cf6c15c3a 100644 --- a/gtk/gtkicontheme.c +++ b/gtk/gtkicontheme.c @@ -2438,7 +2438,7 @@ load_icon_thread (GTask *task, * @flags: flags modifying the behavior of the icon lookup * * Looks up a named icon for a desired size and window scale, returning a - * #GtkIcon. The icon can then be rendered by using it as a #GdkPaintable, + * #GtkIconPaintable. The icon can then be rendered by using it as a #GdkPaintable, * or you can get information such as the filename and size. * * If the available @icon_name is not available and @fallbacks are provided, @@ -2450,7 +2450,7 @@ load_icon_thread (GTask *task, * * Note that you probably want to listen for icon theme changes and * update the icon. This is usually done by overriding the - * #GtkWidget:css-changed function. + * #GtkWidgetClass.css-changed() function. * * Returns: (transfer full): a #GtkIconPaintable object * containing the icon. @@ -3422,7 +3422,7 @@ theme_subdir_load (GtkIconTheme *self, } /* - * GtkIcon + * GtkIconPaintable */ static void icon_paintable_init (GdkPaintableInterface *iface); @@ -3617,7 +3617,7 @@ new_resource_file (const char *filename) /** * gtk_icon_paintable_get_file: - * @self: a #GtkIcon + * @self: a #GtkIconPaintable * * Gets the #GFile that was used to load the icon, or %NULL if the icon was * not loaded from a file. @@ -3641,13 +3641,13 @@ gtk_icon_paintable_get_file (GtkIconPaintable *icon) /** * gtk_icon_paintable_get_icon_name: - * @self: a #GtkIcon + * @self: a #GtkIconPaintable * * Get the icon name being used for this icon. * * When an icon looked up in the icon theme was not available, the * icon theme may use fallback icons - either those specified to - * gtk_icon_theme_lookup() or the always-available + * gtk_icon_theme_lookup_icon() or the always-available * "image-missing". The icon chosen is returned by this function. * * If the icon was created without an icon theme, this function returns %NULL. @@ -3666,7 +3666,7 @@ gtk_icon_paintable_get_icon_name (GtkIconPaintable *icon) /** * gtk_icon_paintable_is_symbolic: - * @self: a #GtkIcon + * @self: a #GtkIconPaintable * * Checks if the icon is symbolic or not. This currently uses only * the file name and not the file contents for determining this. @@ -3898,7 +3898,7 @@ icon_paintable_snapshot (GdkPaintable *paintable, /** * gtk_icon_paintable_snapshot_with_colors: - * @icon: a #GtkIcon + * @icon: a #GtkIconPaintable * @snapshot: a #GdkSnapshot to snapshot to * @width: width to snapshot in * @height: height to snapshot in @@ -4011,7 +4011,7 @@ icon_paintable_init (GdkPaintableInterface *iface) * @scale: the desired scale * * Creates a #GtkIconPaintable for a file with a given size and scale - * #GtkIcon. The icon can then be rendered by using it as a #GdkPaintable. + * #GtkIconPaintable. The icon can then be rendered by using it as a #GdkPaintable. * * Returns: (transfer full): a #GtkIconPaintable containing * for the icon. Unref with g_object_unref() @@ -4077,7 +4077,7 @@ gtk_icon_paintable_new_for_pixbuf (GtkIconTheme *icon_theme, * @flags: flags modifying the behavior of the icon lookup * * Looks up a icon for a desired size and window scale, returning a - * #GtkIcon. The icon can then be rendered by using it as a #GdkPaintable, + * #GtkIconPaintable. The icon can then be rendered by using it as a #GdkPaintable, * or you can get information such as the filename and size. * * Returns: (transfer full): a #GtkIconPaintable containing diff --git a/gtk/gtkimage.c b/gtk/gtkimage.c index 76e852a8c1..3a0399e939 100644 --- a/gtk/gtkimage.c +++ b/gtk/gtkimage.c @@ -449,7 +449,7 @@ gtk_image_new_from_resource (const gchar *resource_path) * pixbuf; you still need to unref it if you own references. * #GtkImage will add its own reference rather than adopting yours. * - * This is a helper for gtk_image_new_from_texture(), and you can't + * This is a helper for gtk_image_new_from_paintable(), and you can't * get back the exact pixbuf once this is called, only a texture. * * Note that this function just creates an #GtkImage from the pixbuf. The diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c index f240f92e9d..6068c5334e 100644 --- a/gtk/gtklistbox.c +++ b/gtk/gtklistbox.c @@ -82,7 +82,7 @@ * ]| * * GtkListBox uses a single CSS node named list. It may carry the .separators style - * class, when the #GtkListBox::show-separators property is set. Each GtkListBoxRow uses + * class, when the #GtkListBox:show-separators property is set. Each GtkListBoxRow uses * a single CSS node named row. The row nodes get the .activatable * style class added when appropriate. */ diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c index 518f3aefbf..af705a9315 100644 --- a/gtk/gtkmain.c +++ b/gtk/gtkmain.c @@ -822,7 +822,7 @@ gtk_init_check (void) * toolkit and parses some standard command line options. * * If you are using #GtkApplication, you don't have to call gtk_init() - * or gtk_init_check(); the #GtkApplication::startup handler + * or gtk_init_check(); the #GApplication::startup handler * does it for you. * * This function will terminate your program if it was unable to diff --git a/gtk/gtkmountoperation.c b/gtk/gtkmountoperation.c index e58bae6ac6..ad8fc64499 100644 --- a/gtk/gtkmountoperation.c +++ b/gtk/gtkmountoperation.c @@ -1873,7 +1873,7 @@ gtk_mount_operation_get_parent (GtkMountOperation *op) /** * gtk_mount_operation_set_display: * @op: a #GtkMountOperation - * @display: a #Gdk + * @display: a #GdkDisplay * * Sets the display to show windows of the #GtkMountOperation on. */ diff --git a/gtk/gtkoverlay.c b/gtk/gtkoverlay.c index 1b3dfbc754..f790256911 100644 --- a/gtk/gtkoverlay.c +++ b/gtk/gtkoverlay.c @@ -514,8 +514,7 @@ gtk_overlay_get_measure_overlay (GtkOverlay *overlay, * @widget: an overlay child of #GtkOverlay * @clip_overlay: whether the child should be clipped * - * Convenience function to set the value of the #GtkOverlay:clip-overlay - * child property for @widget. + * Sets whether @widget should be clipped within the parent. */ void gtk_overlay_set_clip_overlay (GtkOverlay *overlay, @@ -538,8 +537,7 @@ gtk_overlay_set_clip_overlay (GtkOverlay *overlay, * @overlay: a #GtkOverlay * @widget: an overlay child of #GtkOverlay * - * Convenience function to get the value of the #GtkOverlay:clip-overlay - * child property for @widget. + * Gets whether @widget should be clipped within the parent. * * Returns: whether the widget is clipped within the parent. */ diff --git a/gtk/gtkpicture.c b/gtk/gtkpicture.c index 401e0a8a07..0833b11a6f 100644 --- a/gtk/gtkpicture.c +++ b/gtk/gtkpicture.c @@ -452,7 +452,7 @@ gtk_picture_new_for_pixbuf (GdkPixbuf *pixbuf) * isn’t found or can’t be loaded, the resulting #GtkPicture be empty. * * If you need to detect failures to load the file, use - * gdk_texture_new_for_file() to load the file yourself, then create + * gdk_texture_new_from_file() to load the file yourself, then create * the #GtkPicture from the texture. * * Returns: a new #GtkPicture diff --git a/gtk/gtkpopovermenu.c b/gtk/gtkpopovermenu.c index eacd370f6b..cb920d0289 100644 --- a/gtk/gtkpopovermenu.c +++ b/gtk/gtkpopovermenu.c @@ -115,7 +115,7 @@ * * Menu items will also show accelerators, which are usually associated * with actions via gtk_application_set_accels_for_action(), - * gtk_widget_add_binding_action() or gtk_shortcut_controller_add_shortcut(). + * gtk_widget_class_add_binding_action() or gtk_shortcut_controller_add_shortcut(). * * # CSS Nodes * @@ -663,7 +663,7 @@ gtk_popover_menu_new_from_model_full (GMenuModel *model, /** * gtk_popover_menu_set_menu_model: * @popover: a #GtkPopoverMenu - * @model: (nullable): a #GtkMenuModel, or %NULL + * @model: (nullable): a #GMenuModel, or %NULL * * Sets a new menu model on @popover. * diff --git a/gtk/gtkrecentmanager.c b/gtk/gtkrecentmanager.c index c4238d079a..fcd50dce8f 100644 --- a/gtk/gtkrecentmanager.c +++ b/gtk/gtkrecentmanager.c @@ -73,7 +73,7 @@ * ]| * * In order to retrieve the list of recently used files, you can use - * gtk_recent_manager_get_items(), which returns a list of #GtkRecentInfo-structs. + * gtk_recent_manager_get_items(), which returns a list of #GtkRecentInfo. * * A #GtkRecentManager is the model used to populate the contents of * one, or more #GtkRecentChooser implementations. @@ -131,10 +131,10 @@ typedef struct /** * GtkRecentInfo: * - * #GtkRecentInfo-struct contains private data only, and should - * be accessed using the provided API. + * #GtkRecentInfo contains private data only, and should be accessed using the + * provided API. * - * #GtkRecentInfo constains all the meta-data + * #GtkRecentInfo contains all the meta-data * associated with an entry in the recently used files list. */ struct _GtkRecentInfo @@ -865,19 +865,19 @@ gtk_recent_manager_add_item (GtkRecentManager *manager, * * Adds a new resource, pointed by @uri, into the recently used * resources list, using the metadata specified inside the - * #GtkRecentData-struct passed in @recent_data. + * #GtkRecentData passed in @recent_data. * * The passed URI will be used to identify this resource inside the * list. * * In order to register the new recently used resource, metadata about * the resource must be passed as well as the URI; the metadata is - * stored in a #GtkRecentData-struct, which must contain the MIME + * stored in a #GtkRecentData, which must contain the MIME * type of the resource pointed by the URI; the name of the application * that is registering the item, and a command line to be used when * launching the item. * - * Optionally, a #GtkRecentData-struct might contain a UTF-8 string + * Optionally, a #GtkRecentData might contain a UTF-8 string * to be used when viewing the item instead of the last component of * the URI; a short description of the item; whether the item should * be considered private - that is, should be displayed only by the @@ -1152,10 +1152,10 @@ build_recent_info (GBookmarkFile *bookmarks, * @error: (allow-none): a return location for a #GError, or %NULL * * Searches for a URI inside the recently used resources list, and - * returns a #GtkRecentInfo-struct containing informations about the resource + * returns a #GtkRecentInfo containing informations about the resource * like its MIME type, or its display name. * - * Returns: (nullable): a #GtkRecentInfo-struct containing information + * Returns: (nullable): a #GtkRecentInfo containing information * about the resource pointed by @uri, or %NULL if the URI was * not registered in the recently used resources list. Free with * gtk_recent_info_unref(). @@ -1962,10 +1962,9 @@ gtk_recent_info_exists (GtkRecentInfo *info) * @info_a: a #GtkRecentInfo * @info_b: a #GtkRecentInfo * - * Checks whether two #GtkRecentInfo-struct point to the same - * resource. + * Checks whether two #GtkRecentInfo point to the same resource. * - * Returns: %TRUE if both #GtkRecentInfo-struct point to the same + * Returns: %TRUE if both #GtkRecentInfo point to the same * resource, %FALSE otherwise */ gboolean diff --git a/gtk/gtkscrolledwindow.c b/gtk/gtkscrolledwindow.c index b74ecccdb6..7eb696465e 100644 --- a/gtk/gtkscrolledwindow.c +++ b/gtk/gtkscrolledwindow.c @@ -96,7 +96,7 @@ * gtk_bin_get_child (GTK_BIN (scrolled_window))); * ]| * - * Unless #GtkScrolledWindow:hscrolbar-policy and #GtkScrolledWindow:vscrollbar-policy + * Unless #GtkScrolledWindow:hscrollbar-policy and #GtkScrolledWindow:vscrollbar-policy * are GTK_POLICY_NEVER or GTK_POLICY_EXTERNAL, * GtkScrolledWindow adds internal #GtkScrollbar widgets around its child. The * scroll position of the child, and if applicable the scrollbars, is controlled @@ -689,7 +689,7 @@ gtk_scrolled_window_class_init (GtkScrolledWindowClass *class) * as narrow indicators. * * Note that overlay scrolling can also be globally disabled, with - * the #GtkSettings::gtk-overlay-scrolling setting. + * the #GtkSettings:gtk-overlay-scrolling setting. */ properties[PROP_OVERLAY_SCROLLING] = g_param_spec_boolean ("overlay-scrolling", diff --git a/gtk/gtkshortcutaction.c b/gtk/gtkshortcutaction.c index a117cf042e..648875b0db 100644 --- a/gtk/gtkshortcutaction.c +++ b/gtk/gtkshortcutaction.c @@ -42,7 +42,6 @@ * - #GtkSignalAction: a shortcut action that emits a given signal * - #GtkActivateAction: a shortcut action that calls gtk_widget_activate() * - #GtkNamedAction: a shortcut action that calls gtk_widget_activate_action() -* - #GtkGActionAction: a shortcut action that activates a given #GAction * - #GtkNothingAction: a shortcut action that does nothing * * # GtkShortcutAction as GtkBuildable diff --git a/gtk/gtkshortcutsshortcut.c b/gtk/gtkshortcutsshortcut.c index eed5b9c369..dc9558c9e2 100644 --- a/gtk/gtkshortcutsshortcut.c +++ b/gtk/gtkshortcutsshortcut.c @@ -711,7 +711,7 @@ gtk_shortcuts_shortcut_class_init (GtkShortcutsShortcutClass *klass) * of type %GTK_SHORTCUT_ACCELERATOR, then GTK+ will use * the accelerators that are associated with the action * via gtk_application_set_accels_for_action(), and setting - * #GtkShortcutsShortcut::accelerator is not necessary. + * #GtkShortcutsShortcut:accelerator is not necessary. */ properties[PROP_ACTION_NAME] = g_param_spec_string ("action-name", diff --git a/gtk/gtkshow.c b/gtk/gtkshow.c index f688f79ad2..3425d02a10 100644 --- a/gtk/gtkshow.c +++ b/gtk/gtkshow.c @@ -100,7 +100,7 @@ window_handle_exported (GtkWindow *window, * - `mailto:me@gnome.org` * * The @callback will be called when the launch is completed. - * It should call gtk_show_uri_finish() to obtain the result. + * It should call gtk_show_uri_full_finish() to obtain the result. * * This is the recommended call to be used as it passes information * necessary for sandbox helpers to parent their dialogs properly. @@ -144,7 +144,7 @@ gtk_show_uri_full (GtkWindow *parent, /** * gtk_show_uri_full_finish: * @parent: the #GtkWindow passed to gtk_show_uri() - * @result: #GASyncResult that was passed to @callback + * @result: #GAsyncResult that was passed to @callback * @error: return location for an error * * Finished the gtk_show_uri() call and returns the result diff --git a/gtk/gtksnapshot.c b/gtk/gtksnapshot.c index f2654c202e..ef47909750 100644 --- a/gtk/gtksnapshot.c +++ b/gtk/gtksnapshot.c @@ -41,7 +41,7 @@ * @Title: GtkSnapshot * * GtkSnapshot is an auxiliary object that assists in creating #GskRenderNodes - * in the #GtkWidget::snapshot vfunc. It functions in a similar way to + * in the #GdkPaintableInterface.snapshot() vfunc. It functions in a similar way to * a cairo context, and maintains a stack of render nodes and their associated * transformations. * @@ -50,7 +50,7 @@ * to change the current node. * * The typical way to obtain a GtkSnapshot object is as an argument to - * the #GtkWidget::snapshot vfunc. If you need to create your own GtkSnapshot, + * the #GtkWidgetClass.snapshot() vfunc. If you need to create your own GtkSnapshot, * use gtk_snapshot_new(). */ @@ -1150,7 +1150,7 @@ gtk_snapshot_pop_collect (GtkSnapshot *snapshot) * by @snapshot. After calling this function, it * is no longer possible to add more nodes to * @snapshot. The only function that should be - * called after this is gtk_snapshot_unref(). + * called after this is g_object_unref(). * * Returns: (transfer full): the constructed #GskRenderNode */ @@ -1186,7 +1186,7 @@ gtk_snapshot_to_node (GtkSnapshot *snapshot) * that was constructed by @snapshot. After calling * this function, it is no longer possible to add more * nodes to @snapshot. The only function that should be - * called after this is gtk_snapshot_unref(). + * called after this is g_object_unref(). * * Returns: (transfer full): a new #GdkPaintable */ diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c index 37f7f00b25..edccc567c7 100644 --- a/gtk/gtktextbuffer.c +++ b/gtk/gtktextbuffer.c @@ -482,7 +482,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) /** * GtkTextBuffer:can-undo: * - * The :can-undo property denotes that the buffer can undo the last + * The #GtkTextBuffer:can-undo property denotes that the buffer can undo the last * applied action. */ text_buffer_props[PROP_CAN_UNDO] = @@ -495,7 +495,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) /** * GtkTextBuffer:can-redo: * - * The :can-redo property denotes that the buffer can reapply the + * The #GtkTextBuffer:can-redo property denotes that the buffer can reapply the * last undone action. */ text_buffer_props[PROP_CAN_REDO] = @@ -508,8 +508,8 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) /** * GtkTextBuffer:enable-undo: * - * The :enable-undo property denotes if support for undoing and redoing - * changes to the buffer is allowed. + * The #GtkTextBuffer:enable-undo property denotes if support for undoing and + * redoing changes to the buffer is allowed. */ text_buffer_props[PROP_ENABLE_UNDO] = g_param_spec_boolean ("enable-undo", @@ -601,7 +601,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * @location: position to insert @paintable in @textbuffer * @paintable: the #GdkPaintable to be inserted * - * The ::insert-paintable signal is emitted to insert a #GdkPaintable + * The #GtkTextBuffer::insert-paintable signal is emitted to insert a #GdkPaintable * in a #GtkTextBuffer. Insertion actually occurs in the default handler. * * Note that if your handler runs before the default handler it must not @@ -633,7 +633,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * @location: position to insert @anchor in @textbuffer * @anchor: the #GtkTextChildAnchor to be inserted * - * The ::insert-child-anchor signal is emitted to insert a + * The #GtkTextBuffer::insert-child-anchor signal is emitted to insert a * #GtkTextChildAnchor in a #GtkTextBuffer. * Insertion actually occurs in the default handler. * @@ -665,7 +665,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * @start: the start of the range to be deleted * @end: the end of the range to be deleted * - * The ::delete-range signal is emitted to delete a range + * The #GtkTextBuffer::delete-range signal is emitted to delete a range * from a #GtkTextBuffer. * * Note that if your handler runs before the default handler it must not @@ -696,7 +696,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * GtkTextBuffer::changed: * @textbuffer: the object which received the signal * - * The ::changed signal is emitted when the content of a #GtkTextBuffer + * The #GtkTextBuffer::changed signal is emitted when the content of a #GtkTextBuffer * has changed. */ signals[CHANGED] = @@ -713,7 +713,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * GtkTextBuffer::modified-changed: * @textbuffer: the object which received the signal * - * The ::modified-changed signal is emitted when the modified bit of a + * The #GtkTextBuffer::modified-changed signal is emitted when the modified bit of a * #GtkTextBuffer flips. * * See also: @@ -735,7 +735,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * @location: The location of @mark in @textbuffer * @mark: The mark that is set * - * The ::mark-set signal is emitted as notification + * The #GtkTextBuffer::mark-set signal is emitted as notification * after a #GtkTextMark is set. * * See also: @@ -762,7 +762,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * @textbuffer: the object which received the signal * @mark: The mark that was deleted * - * The ::mark-deleted signal is emitted as notification + * The #GtkTextBuffer::mark-deleted signal is emitted as notification * after a #GtkTextMark is deleted. * * See also: @@ -786,7 +786,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * @start: the start of the range the tag is applied to * @end: the end of the range the tag is applied to * - * The ::apply-tag signal is emitted to apply a tag to a + * The #GtkTextBuffer::apply-tag signal is emitted to apply a tag to a * range of text in a #GtkTextBuffer. * Applying actually occurs in the default handler. * @@ -822,8 +822,8 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * @start: the start of the range the tag is removed from * @end: the end of the range the tag is removed from * - * The ::remove-tag signal is emitted to remove all occurrences of @tag from - * a range of text in a #GtkTextBuffer. + * The #GtkTextBuffer::remove-tag signal is emitted to remove all occurrences + * of @tag from a range of text in a #GtkTextBuffer. * Removal actually occurs in the default handler. * * Note that if your handler runs before the default handler it must not @@ -852,7 +852,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * GtkTextBuffer::begin-user-action: * @textbuffer: the object which received the signal * - * The ::begin-user-action signal is emitted at the beginning of a single + * The #GtkTextBuffer::begin-user-action signal is emitted at the beginning of a single * user-visible operation on a #GtkTextBuffer. * * See also: @@ -877,7 +877,7 @@ gtk_text_buffer_class_init (GtkTextBufferClass *klass) * GtkTextBuffer::end-user-action: * @textbuffer: the object which received the signal * - * The ::end-user-action signal is emitted at the end of a single + * The #GtkTextBuffer::end-user-action signal is emitted at the end of a single * user-visible operation on the #GtkTextBuffer. * * See also: @@ -3764,7 +3764,7 @@ find_selection_clipboard (GtkTextBuffer *buffer, * * Adds @clipboard to the list of clipboards in which the selection * contents of @buffer are available. In most cases, @clipboard will be - * the #GdkClipboard returned by gdk_widget_get_primary_clipboard() + * the #GdkClipboard returned by gtk_widget_get_primary_clipboard() * for a view of @buffer. **/ void @@ -5122,7 +5122,7 @@ gtk_text_buffer_set_enable_undo (GtkTextBuffer *buffer, /** * gtk_text_buffer_begin_irreversible_action: - * @buffer: a #Gtktextbuffer + * @buffer: a #GtkTextBuffer * * Denotes the beginning of an action that may not be undone. This will cause * any previous operations in the undo/redo queue to be cleared. @@ -5144,7 +5144,7 @@ gtk_text_buffer_begin_irreversible_action (GtkTextBuffer *buffer) /** * gtk_text_buffer_end_irreversible_action: - * @buffer: a #Gtktextbuffer + * @buffer: a #GtkTextBuffer * * Denotes the end of an action that may not be undone. This will cause * any previous operations in the undo/redo queue to be cleared. diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c index 0f1eef567c..65af198a77 100644 --- a/gtk/gtktextview.c +++ b/gtk/gtktextview.c @@ -3659,7 +3659,7 @@ gtk_text_view_toggle_cursor_visible (GtkTextView *text_view) * want to turn the cursor off. * * Note that this property may be overridden by the - * #GtkSettings:gtk-keynave-use-caret settings. + * #GtkSettings:gtk-keynav-use-caret settings. */ void gtk_text_view_set_cursor_visible (GtkTextView *text_view, diff --git a/gtk/gtktextview.h b/gtk/gtktextview.h index 3d824b2517..8227d9f0ec 100644 --- a/gtk/gtktextview.h +++ b/gtk/gtktextview.h @@ -129,7 +129,7 @@ struct _GtkTextView * keybinding signal. * @cut_clipboard: The class handler for the #GtkTextView::cut-clipboard * keybinding signal - * @copy_clipboard: The class handler for the #GtkTextview::copy-clipboard + * @copy_clipboard: The class handler for the #GtkTextView::copy-clipboard * keybinding signal. * @paste_clipboard: The class handler for the #GtkTextView::paste-clipboard * keybinding signal. diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index b7c14e5223..cd812a73b2 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -6267,7 +6267,7 @@ gtk_widget_peek_pango_context (GtkWidget *widget) * the widget (it can be used until the screen for the widget changes * or the widget is removed from its toplevel), and will be updated to * match any changes to the widget’s attributes. This can be tracked - * by using the #GtkWidget::display-changed signal on the widget. + * by listening to changes of the #GtkWidget:root property on the widget. * * Returns: (transfer none): the #PangoContext for the widget. **/ @@ -6495,7 +6495,7 @@ gtk_widget_create_pango_context (GtkWidget *widget) * * If you keep a #PangoLayout created in this way around, you need * to re-create it when the widget #PangoContext is replaced. - * This can be tracked by using the #GtkWidget::display-changed signal + * This can be tracked by listening to changes of the #GtkWidget:root property * on the widget. * * Returns: (transfer full): the new #PangoLayout @@ -10222,7 +10222,7 @@ gtk_widget_get_allocated_height (GtkWidget *widget) * * Returns the baseline that has currently been allocated to @widget. * This function is intended to be used when implementing handlers - * for the #GtkWidget::snapshot function, and when allocating child + * for the #GtkWidgetClass.snapshot() function, and when allocating child * widgets in #GtkWidget::size_allocate. * * Returns: the baseline of the @widget, or -1 if none @@ -12049,9 +12049,9 @@ gtk_widget_forall (GtkWidget *widget, * have been made. * * When a widget receives a call to the snapshot function, it must send - * synthetic #GtkWidget::snapshot calls to all children. This function + * synthetic #GtkWidgetClass.snapshot() calls to all children. This function * provides a convenient way of doing this. A widget, when it receives - * a call to its #GtkWidget::snapshot function, calls + * a call to its #GtkWidgetClass.snapshot() function, calls * gtk_widget_snapshot_child() once for each child, passing in * the @snapshot the widget received. * diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index f18ae9899e..fe9da19380 100644 --- a/gtk/gtkwidget.h +++ b/gtk/gtkwidget.h @@ -200,7 +200,7 @@ struct _GtkWidget * redraws accordingly. The default implementation will take care of this for * all the default CSS properties, so implementations must chain up. * @system_setting_changed: Emitted when a system setting was changed. Must chain up. - * @snapshot: Vfunc for gtk_widget_snapshot(). + * @snapshot: Vfunc called when a new snapshot of the widget has to be taken. * @contains: Vfunc for gtk_widget_contains(). */ struct _GtkWidgetClass diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index fc949183cc..c7cbcf99ee 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -6262,7 +6262,7 @@ gtk_window_present_with_time (GtkWindow *window, * in which case the window will be minimized before it ever appears * onscreen. * - * You can track result of this operation via the #GdkSurface:state + * You can track result of this operation via the #GdkToplevel:state * property. */ void @@ -6290,7 +6290,7 @@ gtk_window_minimize (GtkWindow *window) * could minimize it again, or there may not be a window manager in * which case minimization isn’t possible, etc. * - * You can track result of this operation via the #GdkSurface:state + * You can track result of this operation via the #GdkToplevel:state * property. */ void @@ -6321,7 +6321,7 @@ gtk_window_unminimize (GtkWindow *window) * in which case the window will be maximized when it appears onscreen * initially. * - * You can track the result of this operation via the #GdkSurface:state + * You can track the result of this operation via the #GdkToplevel:state * property, or by listening to notifications on the #GtkWindow:is-maximized * property. */ @@ -6348,7 +6348,7 @@ gtk_window_maximize (GtkWindow *window) * managers honor requests to unmaximize. But normally the window will * end up unmaximized. Just don’t write code that crashes if not. * - * You can track the result of this operation via the #GdkSurface:state + * You can track the result of this operation via the #GdkToplevel:state * property, or by listening to notifications on the #GtkWindow:is-maximized * property. */ @@ -6376,7 +6376,7 @@ gtk_window_unmaximize (GtkWindow *window) * windows. But normally the window will end up fullscreen. Just * don’t write code that crashes if not. * - * You can track iconification via the #GdkSurface::state property + * You can track iconification via the #GdkToplevel:state property **/ void gtk_window_fullscreen (GtkWindow *window) @@ -6411,7 +6411,7 @@ unset_fullscreen_monitor (GtkWindow *window) * Asks to place @window in the fullscreen state. Note that you shouldn't assume * the window is definitely full screen afterward. * - * You can track iconification via the #GdkSurface::state property + * You can track iconification via the #GdkToplevel:state property */ void gtk_window_fullscreen_on_monitor (GtkWindow *window, @@ -6448,7 +6448,7 @@ gtk_window_fullscreen_on_monitor (GtkWindow *window, * windows. But normally the window will end up restored to its normal * state. Just don’t write code that crashes if not. * - * You can track iconification via the #GdkSurface::state property + * You can track iconification via the #GdkToplevel:state property **/ void gtk_window_unfullscreen (GtkWindow *window) -- cgit v1.2.1