[gtk/wip/tintou/doc-fixes] docs: Fix several missing references in the documentation
- From: Corentin Noël <corentinnoel src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk/wip/tintou/doc-fixes] docs: Fix several missing references in the documentation
- Date: Mon, 11 May 2020 16:56:22 +0000 (UTC)
commit dd8c1f988cebdad751242493fc07795b65a31d7d
Author: Corentin Noël <corentin elementary io>
Date: Mon May 11 18:47:20 2020 +0200
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 | 97 ++++++++++++++++++++++++++++++-----
docs/reference/gsk/gsk4-docs.xml | 2 +
docs/reference/gsk/gsk4-sections.txt | 74 ++++++++++++++++++++++++--
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, 342 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 @@
<xi:include href="xml/gdkdrawcontext.xml" />
<xi:include href="xml/gdkglcontext.xml" />
<xi:include href="xml/gdkvulkancontext.xml" />
+ <xi:include href="xml/gdkcairocontext.xml" />
<xi:include href="xml/events.xml" />
<xi:include href="xml/keys.xml" />
<xi:include href="xml/gdkclipboard.xml" />
diff --git a/docs/reference/gdk/gdk4-sections.txt b/docs/reference/gdk/gdk4-sections.txt
index 12128deb49..35011a8d2b 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
<SUBSECTION>
gdk_display_map_keyval
@@ -145,6 +147,7 @@ gdk_display_manager_get_type
<TITLE>Pixbufs</TITLE>
<FILE>pixbufs</FILE>
gdk_pixbuf_get_from_surface
+gdk_pixbuf_get_from_texture
</SECTION>
<SECTION>
@@ -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
<SUBSECTION>
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
<SUBSECTION>
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
<SUBSECTION>
gdk_device_get_state
@@ -469,8 +474,24 @@ gdk_seat_capabilities_get_type
<TITLE>Events</TITLE>
<FILE>events</FILE>
GdkEvent
+GdkButtonEvent
+GdkConfigureEvent
+GdkCrossingEvent
+GdkDeleteEvent
+GdkDNDEvent
+GdkFocusEvent
+GdkGrabBrokenEvent
+GdkKeyEvent
+GdkMotionEvent
+GdkPadEvent
+GdkProximityEvent
+GdkScrollEvent
+GdkTouchEvent
+GdkTouchpadEvent
GdkEventType
GdkEventMask
+GdkKeyMatch
+GdkTouchpadGesturePhase
GdkScrollDirection
GdkCrossingMode
GdkNotifyType
@@ -512,25 +533,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
<SUBSECTION>
gdk_events_get_angle
@@ -545,14 +566,44 @@ GDK_TYPE_CROSSING_MODE
GDK_TYPE_SCROLL_DIRECTION
GDK_TYPE_NOTIFY_TYPE
GDK_IS_EVENT
+GDK_TYPE_EVENT_SEQUENCE
+GDK_TYPE_FOCUS_EVENT
+GDK_TYPE_BUTTON_EVENT
+GDK_TYPE_CONFIGURE_EVENT
+GDK_TYPE_CROSSING_EVENT
+GDK_TYPE_DELETE_EVENT
+GDK_TYPE_DND_EVENT
+GDK_TYPE_GRAB_BROKEN_EVENT
+GDK_TYPE_KEY_EVENT
+GDK_TYPE_MOTION_EVENT
+GDK_TYPE_PROXIMITY_EVENT
+GDK_TYPE_SCROLL_EVENT
+GDK_TYPE_TOUCHPAD_EVENT
+GDK_TYPE_TOUCH_EVENT
+GDK_TYPE_PAD_EVENT
gdk_event_get_type
gdk_event_sequence_get_type
+gdk_focus_event_get_type
+gdk_button_event_get_type
+gdk_configure_event_get_type
+gdk_crossing_event_get_type
+gdk_delete_event_get_type
+gdk_dnd_event_get_type
+gdk_grab_broken_event_get_type
+gdk_key_event_get_type
+gdk_motion_event_get_type
+gdk_proximity_event_get_type
+gdk_scroll_event_get_type
+gdk_touchpad_event_get_type
+gdk_touch_event_get_type
+gdk_pad_event_get_type
</SECTION>
<SECTION>
<FILE>gdkpaintable</FILE>
<TITLE>GdkPaintable</TITLE>
GdkPaintable
+GdkPaintableInterface
GdkPaintableFlags
gdk_paintable_get_current_image
gdk_paintable_snapshot
@@ -567,9 +618,19 @@ gdk_paintable_invalidate_contents
gdk_paintable_invalidate_size
gdk_paintable_new_empty
-<SUBSECTION Private>
+<SUBSECTION>
+GdkSnapshot
+
+<SUBSECTION Standard>
+GDK_SNAPSHOT
GDK_TYPE_PAINTABLE
+GDK_TYPE_SNAPSHOT
+GDK_IS_SNAPSHOT
+
+<SUBSECTION Private>
+GdkSnapshotClass
gdk_paintable_get_type
+gdk_snapshot_get_type
</SECTION>
@@ -657,6 +718,7 @@ gdk_toplevel_set_deletable
gdk_toplevel_supports_edge_constraints
gdk_toplevel_inhibit_system_shortcuts
gdk_toplevel_restore_system_shortcuts
+gdk_toplevel_install_properties
<SUBSECTION Standard>
GDK_TYPE_TOPLEVEL
gdk_toplevel_get_type
@@ -743,6 +805,11 @@ gdk_drag_set_hotspot
<SUBSECTION>
gdk_drag_action_is_unique
+<SUBSECTION>
+GdkDragSurface
+GdkDragSurfaceInterface
+gdk_drag_surface_present
+
<SUBSECTION>
gdk_drop_get_display
gdk_drop_get_device
@@ -769,6 +836,7 @@ GDK_TYPE_DRAG_PROTOCOL
GDK_TYPE_DROP
GDK_DROP
GDK_IS_DROP
+GDK_TYPE_DRAG_SURFACE
<SUBSECTION Private>
GdkDragClass
@@ -1195,6 +1263,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 @@
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index>
+ <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+
</book>
diff --git a/docs/reference/gsk/gsk4-sections.txt b/docs/reference/gsk/gsk4-sections.txt
index fcacabf12e..64f471ee33 100644
--- a/docs/reference/gsk/gsk4-sections.txt
+++ b/docs/reference/gsk/gsk4-sections.txt
@@ -1,5 +1,6 @@
<SECTION>
<FILE>GskRenderer</FILE>
+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
<SECTION>
<FILE>GskRenderNode</FILE>
+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
@@ -105,10 +128,12 @@ gsk_cross_fade_node_new
gsk_cross_fade_node_get_start_child
gsk_cross_fade_node_get_end_child
gsk_cross_fade_node_get_progress
+gsk_render_node_deserialize_from_bytes
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 +146,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
<SUBSECTION Standard>
gsk_serialization_error_quark
@@ -185,6 +252,7 @@ gsk_transform_transform_bounds
gsk_transform_transform_point
<SUBSECTION Private>
GSK_TYPE_TRANSFORM
+GSK_TYPE_TRANSFORM_CATEGORY
gsk_transform_get_type
gsk_transform_new
</SECTION>
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 @@
<para>
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.
</para>
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 @@
<xi:include href="xml/gtkdragicon.xml"/>
<xi:include href="xml/gtkdroptarget.xml"/>
<xi:include href="xml/gtkdroptargetasync.xml"/>
+ <xi:include href="xml/gtkdropcontrollermotion.xml"/>
</chapter>
</part>
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
</SECTION>
-<SECTION>
-<FILE>gtkcenterlayout</FILE>
-<TITLE>GtkCenterLayout</TITLE>
-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
-<SUBSECTION Private>
-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
-<SUBSECTION Private>
-gtk_center_layout_get_type
-</SECTION>
-
<SECTION>
<FILE>gtklistbox</FILE>
<TITLE>GtkListBox</TITLE>
@@ -464,6 +440,7 @@ gtk_builder_cscope_get_type
<FILE>gtkbuilder</FILE>
<TITLE>GtkBuilder</TITLE>
GtkBuilder
+GtkBuilderClosureFlags
GtkBuilderError
gtk_builder_new
gtk_builder_new_from_file
@@ -771,6 +748,8 @@ gtk_drawing_area_get_type
<FILE>gtkeditable</FILE>
<TITLE>GtkEditable</TITLE>
GtkEditable
+GtkEditableInterface
+GtkEditableProperties
gtk_editable_get_text
gtk_editable_set_text
gtk_editable_get_chars
@@ -1096,6 +1075,7 @@ gtk_file_chooser_get_type
<SECTION>
<FILE>gtkfilechoosernative</FILE>
<TITLE>GtkFileChooserNative</TITLE>
+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
<FILE>gtkfilterlistmodel</FILE>
<TITLE>GtkFilterListModel</TITLE>
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
<FILE>gtkscale</FILE>
<TITLE>GtkScale</TITLE>
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
<SUBSECTION Standard>
GTK_TEXT_BUFFER
@@ -3931,6 +3915,7 @@ gtk_snapshot_get_type
<SECTION>
<FILE>gtkwidgetpaintable</FILE>
<TITLE>GtkWidgetPaintable</TITLE>
+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
<FILE>gtkpopovermenu</FILE>
<TITLE>GtkPopoverMenu</TITLE>
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
<SUBSECTION Private>
gtk_popover_menu_get_type
@@ -6013,7 +6002,6 @@ gtk_event_controller_motion_get_type
<FILE>gtkshortcuttrigger</FILE>
<TITLE>GtkShortcutTrigger</TITLE>
GtkShortcutTrigger
-GtkNeverTrigger
gtk_shortcut_trigger_trigger
gtk_shortcut_trigger_hash
@@ -6054,6 +6042,8 @@ gtk_shortcut_trigger_get_type
<FILE>gtkshortcutaction</FILE>
<TITLE>GtkShortcutAction</TITLE>
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
<SECTION>
<FILE>gtknative</FILE>
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 @@
<title>Stop using gdk_pixbuf_get_from_window() and gdk_cairo_set_source_surface()</title>
<para>
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().
</para>
</section>
@@ -331,12 +331,12 @@
</para>
<para>
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.
</para>
<para>
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.
</para>
</section>
@@ -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.
</para>
<para>
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 @@
<section>
<title>Widgets are now visible by default</title>
<para>
- 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.
</para>
@@ -719,7 +719,7 @@
on them.
</para>
<para>
- 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.
</para>
</section>
@@ -781,7 +781,7 @@
<title>Stop using GtkWidget::draw</title>
<para>
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.
</para>
</section>
@@ -1009,7 +1009,7 @@
<para>
The #GdkSurface functions <function>gdk_surface_iconify()</function>
and <function>gdk_surface_deiconify()</function> have been renamed to
- gdk_surface_minimize() and gdk_surface_unminimize(), respectively.
+ gdk_toplevel_minimize() and gdk_toplevel_present(), respectively.
</para>
<para>
The corresponding #GtkWindow functions <function>gtk_window_iconify()</function>
@@ -1096,7 +1096,7 @@
</para>
<para>
The destination-side DND apis in GTK 4 have also been changed to use and event controller,
- #GTkDropTarget.
+ #GtkDropTarget.
</para>
<para>
Instead of calling gtk_drag_dest_set() and connecting to #GtkWidget signals, you create
@@ -1104,9 +1104,9 @@
connect to #GtkDropTarget signals.
</para>
<para>
- 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().
</para>
</section>
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 ?
</para></question>
<answer><para>
-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.
</para>
</answer>
</qandaentry>
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.
</para>
<para>
-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)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
