Merge branch 'doc-fixes' into 'master'

Doc fixes

See merge request GNOME/gtk!2314

docs/reference/gtk/gtk4-sections.txt

@@ -862,7 +862,6 @@ gtk_combo_box_set_active_id
 gtk_combo_box_get_model
 gtk_combo_box_set_model
 gtk_combo_box_popdown
-gtk_combo_box_get_popup_accessible
 gtk_combo_box_get_row_separator_func
 gtk_combo_box_set_row_separator_func
 GtkSensitivityType
@@ -1204,9 +1203,6 @@ gtk_entry_completion_compute_prefix
 gtk_entry_completion_complete
 gtk_entry_completion_get_completion_prefix
 gtk_entry_completion_insert_prefix
-gtk_entry_completion_insert_action_text
-gtk_entry_completion_insert_action_markup
-gtk_entry_completion_delete_action
 gtk_entry_completion_set_text_column
 gtk_entry_completion_get_text_column
 gtk_entry_completion_set_inline_completion
@@ -2813,7 +2809,7 @@ gtk_sort_list_model_set_model
 gtk_sort_list_model_get_model
 gtk_sort_list_model_set_incremental
 gtk_sort_list_model_get_incremental
-gtk_sort_list_model_get_peanding
+gtk_sort_list_model_get_pending
 <SUBSECTION Standard>
 GTK_SORT_LIST_MODEL
 GTK_IS_SORT_LIST_MODEL
@@ -4055,7 +4051,6 @@ GtkCellRendererState
 GtkCellRendererMode
 GtkCellRenderer
 GtkCellRendererClass
-gtk_cell_renderer_class_set_accessible_type
 gtk_cell_renderer_get_aligned_area
 gtk_cell_renderer_snapshot
 gtk_cell_renderer_activate
@@ -4468,9 +4463,7 @@ gtk_widget_get_cursor
 gtk_widget_set_cursor
 gtk_widget_set_cursor_from_name
 gtk_widget_mnemonic_activate
-gtk_widget_class_set_accessible_type
 gtk_widget_class_set_accessible_role
-gtk_widget_get_accessible
 gtk_widget_child_focus
 gtk_widget_get_child_visible
 gtk_widget_get_parent
@@ -7645,6 +7638,7 @@ GtkAccessibleTristate
 GtkAccessibleInvalidState
 GtkAccessibleAutocomplete
 GtkAccessibleSort
+gtk_accessible_get_accessible_role
 gtk_accessible_update_state
 gtk_accessible_update_state_value
 gtk_accessible_reset_state

docs/reference/gtk/meson.build

@@ -6,17 +6,24 @@ private_headers = [
   'gdkpixbufutilsprivate.h',
   'gtkaccelgroupprivate.h',
   'gtkaccelmapprivate.h',
+  'gtkaccessibleattributesetprivate.h',
+  'gtkaccessibleattributevalueprivate.h',
+  'gtkaccessibleprivate.h',
+  'gtkaccessiblevalueprivate.h',
   'gtkactionhelperprivate.h',
   'gtkactionmuxerprivate.h',
+  'gtkactionobservableprivate.h',
+  'gtkactionobserverprivate.h',
   'gtkadjustmentprivate.h',
   'gtkallocatedbitmaskprivate.h',
   'gtkappchooserprivate.h',
   'gtkapplicationaccelsprivate.h',
   'gtkapplicationprivate.h',
-  'gtkarrayimplprivate.h',
+  'gtkatcontextprivate.h',
   'gtkbindingsprivate.h',
   'gtkbitmaskprivate.h',
   'gtkbuilderprivate.h',
+  'gtkbuilderscopeprivate.h',
   'gtkbuttonprivate.h',
   'gtkcellareaboxcontextprivate.h',
   'gtkcheckbuttonprivate.h',
@@ -45,6 +52,7 @@ private_headers = [
   'gtkcssarrayvalueprivate.h',
   'gtkcssbgsizevalueprivate.h',
   'gtkcssbordervalueprivate.h',
+  'gtkcssboxesimplprivate.h',
   'gtkcssboxesprivate.h',
   'gtkcsscalcvalueprivate.h',
   'gtkcsscolorvalueprivate.h',

gdk/gdkdevicetool.c

@@ -210,6 +210,14 @@ gdk_device_tool_get_tool_type (GdkDeviceTool *tool)
   return tool->type;
 }
 
+/**
+ * gdk_device_tool_get_axes:
+ * @tool: a #GdkDeviceTool
+ *
+ * Gets the axes of the tool.
+ *
+ * Returns: the axes of @tool
+ */
 GdkAxisFlags
 gdk_device_tool_get_axes (GdkDeviceTool *tool)
 {

gdk/gdkseat.c

@@ -465,7 +465,7 @@ gdk_seat_get_tool (GdkSeat *seat,
  * gdk_seat_get_tools:
  * @seat: A #GdkSeat
  *
- * Returns all #GdkDeviceTool<!-- -->s that are known to the
+ * Returns all #GdkDeviceTools that are known to the
  * application.
  *
  * Returns: (transfer container) (element-type Gdk.DeviceTool): A list of tools. Free with

gtk/gtkatcontext.c

@@ -172,6 +172,19 @@ gtk_at_context_class_init (GtkATContextClass *klass)
                          G_PARAM_CONSTRUCT_ONLY |
                          G_PARAM_STATIC_STRINGS);
 
+  /**
+   * GtkATContext::state-change:
+   * @self: the #GtkATContext
+   * @changed_states: flags for the changed states
+   * @changed_properties: flags for the changed properties
+   * @changed_relations,
+   * @states: the new states
+   * @properties: the new properties
+   * @relations: the new relations
+   *
+   * Emitted when the attributes of the accessible for the
+   * #GtkATContext instance change.
+   */
   obj_signals[STATE_CHANGE] =
     g_signal_new ("state-change",
                   G_TYPE_FROM_CLASS (gobject_class),

gtk/gtkenums.h

@@ -1187,19 +1187,21 @@ typedef enum {
  * @GTK_ACCESSIBLE_ROLE_LANDMARK: Unused
  * @GTK_ACCESSIBLE_ROLE_LEGEND: Unused
  * @GTK_ACCESSIBLE_ROLE_LINK: Unused
+ * @GTK_ACCESSIBLE_ROLE_LIST: Unused
  * @GTK_ACCESSIBLE_ROLE_LIST_BOX: Unused
  * @GTK_ACCESSIBLE_ROLE_LIST_ITEM: Unused
  * @GTK_ACCESSIBLE_ROLE_LOG: Unused
  * @GTK_ACCESSIBLE_ROLE_MAIN: Unused
  * @GTK_ACCESSIBLE_ROLE_MARQUEE: Unused
- * @GTK_ACCESSIBLE_ROLE_METER: Unused
  * @GTK_ACCESSIBLE_ROLE_MATH: Unused
+ * @GTK_ACCESSIBLE_ROLE_METER: Unused
  * @GTK_ACCESSIBLE_ROLE_MENU: Unused
  * @GTK_ACCESSIBLE_ROLE_MENU_BAR: Unused
  * @GTK_ACCESSIBLE_ROLE_MENU_ITEM: Unused
  * @GTK_ACCESSIBLE_ROLE_MENU_ITEM_CHECKBOX: Unused
  * @GTK_ACCESSIBLE_ROLE_MENU_ITEM_RADIO: Unused
  * @GTK_ACCESSIBLE_ROLE_NAVIGATION: Unused
+ * @GTK_ACCESSIBLE_ROLE_NONE: Unused
  * @GTK_ACCESSIBLE_ROLE_NOTE: Unused
  * @GTK_ACCESSIBLE_ROLE_OPTION: Unused
  * @GTK_ACCESSIBLE_ROLE_PRESENTATION: Unused
@@ -1287,6 +1289,7 @@ typedef enum {
   GTK_ACCESSIBLE_ROLE_LOG,
   GTK_ACCESSIBLE_ROLE_MAIN,
   GTK_ACCESSIBLE_ROLE_MARQUEE,
+  GTK_ACCESSIBLE_ROLE_MATH,
   GTK_ACCESSIBLE_ROLE_METER,
   GTK_ACCESSIBLE_ROLE_MENU,
   GTK_ACCESSIBLE_ROLE_MENU_BAR,
@@ -1295,6 +1298,7 @@ typedef enum {
   GTK_ACCESSIBLE_ROLE_MENU_ITEM_RADIO,
   GTK_ACCESSIBLE_ROLE_NAVIGATION,
   GTK_ACCESSIBLE_ROLE_NONE,
+  GTK_ACCESSIBLE_ROLE_NOTE,
   GTK_ACCESSIBLE_ROLE_OPTION,
   GTK_ACCESSIBLE_ROLE_PRESENTATION,
   GTK_ACCESSIBLE_ROLE_PROGRESS_BAR,

gtk/gtkfilechooserdialog.c

@@ -304,6 +304,11 @@ gtk_file_chooser_dialog_class_init (GtkFileChooserDialogClass *class)
   gtk_widget_class_bind_template_child_private (widget_class, GtkFileChooserDialog, buttons);
   gtk_widget_class_bind_template_callback (widget_class, response_cb);
 
+  /**
+   * GtkFileChooserDialog|response.activate:
+   *
+   * Activate the default response of the dialog.
+   */
   gtk_widget_class_install_action (widget_class, "response.activate", NULL, gtk_file_chooser_dialog_activate_response);
 }
 

gtk/gtkfilter.c

@@ -83,7 +83,7 @@ gtk_filter_class_init (GtkFilterClass *class)
   class->get_strictness = gtk_filter_default_get_strictness;
 
   /**
-   * GtkFilter:changed:
+   * GtkFilter::changed:
    * @self: The #GtkFilter
    * @change: how the filter changed
    *