diff --git a/gdk/gdkcursor.h b/gdk/gdkcursor.h index a28840e7e9..1525964f3f 100644 --- a/gdk/gdkcursor.h +++ b/gdk/gdkcursor.h @@ -52,7 +52,7 @@ GdkCursor* gdk_cursor_new_from_name (const char *name, GdkCursor *fallback); /** - * GdkCursorGetTestureCallback: + * GdkCursorGetTextureCallback: * @cursor: the `GdkCursor` * @cursor_size: the nominal cursor size, in application pixels * @scale: the device scale diff --git a/gsk/gskglshader.c b/gsk/gskglshader.c index d14d0a48de..bee2e9a7d9 100644 --- a/gsk/gskglshader.c +++ b/gsk/gskglshader.c @@ -439,7 +439,7 @@ gsk_gl_shader_class_init (GskGLShaderClass *klass) object_class->constructed = gsk_gl_shader_constructed; /** - * GskGLShader:sourcecode: (attributes org.gtk.Property.get=gsk_gl_shader_get_source) + * GskGLShader:source: (attributes org.gtk.Property.get=gsk_gl_shader_get_source) * * The source code for the shader, as a `GBytes`. */ diff --git a/gsk/gsktransform.c b/gsk/gsktransform.c index 4ab9e9dc79..d2cfcd241e 100644 --- a/gsk/gsktransform.c +++ b/gsk/gsktransform.c @@ -2023,7 +2023,7 @@ GskTransformCategory return self->category; } -/* +/** * gsk_transform_new: (constructor): * * Creates a new identity transform. diff --git a/gtk/deprecated/gtkcellrendererspinner.c b/gtk/deprecated/gtkcellrendererspinner.c index 5f4e0672c4..a4c6b3fdc3 100644 --- a/gtk/deprecated/gtkcellrendererspinner.c +++ b/gtk/deprecated/gtkcellrendererspinner.c @@ -175,7 +175,8 @@ gtk_cell_renderer_spinner_class_init (GtkCellRendererSpinnerClass *klass) cell_class->get_preferred_height = gtk_cell_renderer_spinner_get_preferred_height; cell_class->snapshot = gtk_cell_renderer_spinner_snapshot; - /* GtkCellRendererSpinner:active: + /** + * GtkCellRendererSpinner:active: * * Whether the spinner is active (ie. shown) in the cell */ diff --git a/gtk/gtkbuilderscope.c b/gtk/gtkbuilderscope.c index 8d18c44c96..e24cd62618 100644 --- a/gtk/gtkbuilderscope.c +++ b/gtk/gtkbuilderscope.c @@ -434,11 +434,10 @@ gtk_builder_cscope_new (void) /** * gtk_builder_cscope_add_callback: - * @self: a `GtkBuilderCScope` - * @callback_symbols: (scope async): The callback pointer + * @scope: a `GtkBuilderCScope` + * @callback: (scope async): The callback pointer * - * Adds the @callback_symbol to the scope of @builder under its - * own name. + * Adds the @callback to the scope of @builder under its own name. * * This is a convenience wrapper of [method@Gtk.BuilderCScope.add_callback_symbol]. * diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c index 30521f640c..f787fbfe32 100644 --- a/gtk/gtkentry.c +++ b/gtk/gtkentry.c @@ -876,7 +876,7 @@ gtk_entry_class_init (GtkEntryClass *class) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** - * GtkEntry::tabs: (attributes org.gtk.Property.get=gtk_entry_get_tabs org.gtk.Property.set=gtk_entry_set_tabs) + * GtkEntry:tabs: (attributes org.gtk.Property.get=gtk_entry_get_tabs org.gtk.Property.set=gtk_entry_set_tabs) * * A list of tabstops to apply to the text of the entry. */ @@ -886,7 +886,7 @@ gtk_entry_class_init (GtkEntryClass *class) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** - * GtkEntry::show-emoji-icon: + * GtkEntry:show-emoji-icon: * * Whether the entry will show an Emoji icon in the secondary icon position * to open the Emoji chooser. diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h index b17b7c70bf..eed63be988 100644 --- a/gtk/gtkenums.h +++ b/gtk/gtkenums.h @@ -1821,16 +1821,17 @@ typedef enum { /*< prefix=GTK_ACCESSIBLE_SORT >*/ /** * GtkAccessibleAnnouncementPriority: - * @GTK_ANNOUNCEMENT_PRIORITY_LOW: The announcement is low priority, and might be read only - * on the user's request. - * @GTK_ANNOUNCEMENT_PRIORITY_MEDIUM: The announcement is of medium priority, and is usually - * spoken at the next opportunity, such as at the end of speaking the current sentence - * or when the user pauses typing. - * @GTK_ANNOUNCEMENT_PRIORITY_HIGH: The announcement is of high priority, and is usually - * spoken immediately. Because an interruption might disorient users or cause them to - * not complete their current task, authors SHOULD NOT use high priority announcements - * unless the interruption is imperative. An example would be a notification about a - * critical battery power level. + * @GTK_ACCESSIBLE_ANNOUNCEMENT_PRIORITY_LOW: The announcement is low priority, + * and might be read only on the user's request. + * @GTK_ACCESSIBLE_ANNOUNCEMENT_PRIORITY_MEDIUM: The announcement is of medium + * priority, and is usually spoken at the next opportunity, such as at the + * end of speaking the current sentence or when the user pauses typing. + * @GTK_ACCESSIBLE_ANNOUNCEMENT_PRIORITY_HIGH: The announcement is of high + * priority, and is usually spoken immediately. Because an interruption + * might disorient users or cause them to not complete their current task, + * authors SHOULD NOT use high priority announcements unless the + * interruption is imperative. An example would be a notification about a + * critical battery power level. * * The priority of an accessibility announcement. * diff --git a/gtk/gtkflowbox.c b/gtk/gtkflowbox.c index 10fe3521c5..b629ea2d1e 100644 --- a/gtk/gtkflowbox.c +++ b/gtk/gtkflowbox.c @@ -3675,7 +3675,7 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class) GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); /** - * GtkFlwoBox:accept-unpaired-release: + * GtkFlowBox:accept-unpaired-release: * * Whether to accept unpaired release events. */ @@ -3835,9 +3835,9 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class) * move by individual children * - Home, End move to the ends of the box * - PgUp, PgDn move vertically by pages - + * * Returns: %TRUE to stop other handlers from being invoked for the event. - * %FALSE to propagate the event further. + * %FALSE to propagate the event further. */ signals[MOVE_CURSOR] = g_signal_new (I_("move-cursor"), GTK_TYPE_FLOW_BOX, diff --git a/gtk/gtkgraphicsoffload.c b/gtk/gtkgraphicsoffload.c index 97d07bf47d..f21cfa3bcb 100644 --- a/gtk/gtkgraphicsoffload.c +++ b/gtk/gtkgraphicsoffload.c @@ -271,7 +271,7 @@ gtk_graphics_offload_class_init (GtkGraphicsOffloadClass *class) GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY | G_PARAM_STATIC_STRINGS); /** - * GtkGraphicsOffload:black_background: (attributes org.gtk.Property.get=gtk_graphics_offload_get_black_background org.gtk.Property.set=gtk_graphics_offload_set_black_background) + * GtkGraphicsOffload:black-background: (attributes org.gtk.Property.get=gtk_graphics_offload_get_black_background org.gtk.Property.set=gtk_graphics_offload_set_black_background) * * Whether to draw a black background. * diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c index a51376cbe6..e7a4006429 100644 --- a/gtk/gtkicontheme.c +++ b/gtk/gtkicontheme.c @@ -1699,7 +1699,7 @@ gtk_icon_theme_set_theme_name (GtkIconTheme *self, * * Gets the current icon theme name. * - * Returns (transfer full): the current icon theme name, + * Returns: (transfer full): the current icon theme name, */ char * gtk_icon_theme_get_theme_name (GtkIconTheme *self) diff --git a/gtk/gtkscrolledwindow.c b/gtk/gtkscrolledwindow.c index c4fca8033a..8cbdd3a996 100644 --- a/gtk/gtkscrolledwindow.c +++ b/gtk/gtkscrolledwindow.c @@ -582,7 +582,7 @@ gtk_scrolled_window_class_init (GtkScrolledWindowClass *class) class->move_focus_out = gtk_scrolled_window_move_focus_out; /** - * GtkScrolleWindow:hadjustment: (attributes org.gtk.Property.get=gtk_scrolled_window_get_hadjustment org.gtk.Property.set=gtk_scrolled_window_set_hadjustment) + * GtkScrolledWindow:hadjustment: (attributes org.gtk.Property.get=gtk_scrolled_window_get_hadjustment org.gtk.Property.set=gtk_scrolled_window_set_hadjustment) * * The `GtkAdjustment` for the horizontal position. */ @@ -592,7 +592,7 @@ gtk_scrolled_window_class_init (GtkScrolledWindowClass *class) GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_EXPLICIT_NOTIFY); /** - * GtkScrolleWindow:vadjustment: (attributes org.gtk.Property.get=gtk_scrolled_window_get_vadjustment org.gtk.Property.set=gtk_scrolled_window_set_vadjustment) + * GtkScrolledWindow:vadjustment: (attributes org.gtk.Property.get=gtk_scrolled_window_get_vadjustment org.gtk.Property.set=gtk_scrolled_window_set_vadjustment) * * The `GtkAdjustment` for the vertical position. */ diff --git a/gtk/gtksectionmodel.c b/gtk/gtksectionmodel.c index a13c79e798..8883c51e35 100644 --- a/gtk/gtksectionmodel.c +++ b/gtk/gtksectionmodel.c @@ -188,12 +188,12 @@ gtk_list_model_get_section (GListModel *self, } /** - * gtk_section_model_section_changed: + * gtk_section_model_sections_changed: * @self: a `GtkSectionModel` * @position: the first changed item * @n_items: the number of changed items * - * This function emits the [signal@Gtk.SectionModel::section-changed] + * This function emits the [signal@Gtk.SectionModel::sections-changed] * signal to notify about changes to sections. * * It must cover all positions that used to be a section start or that @@ -201,7 +201,7 @@ gtk_list_model_get_section (GListModel *self, * which the section has changed. * * The [signal@Gio.ListModel::items-changed] implies the effect of the - * [signal@Gtk.SectionModel::section-changed] signal for all the items + * [signal@Gtk.SectionModel::sections-changed] signal for all the items * it covers. * * It is recommended that when changes to the items cause section changes diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c index 5a2110ff65..0277abcd53 100644 --- a/gtk/gtktextview.c +++ b/gtk/gtktextview.c @@ -68,7 +68,7 @@ * * A widget that displays the contents of a [class@Gtk.TextBuffer]. * - * ![An example GtkTextview](multiline-text.png) + * ![An example GtkTextView](multiline-text.png) * * You may wish to begin by reading the [conceptual overview](section-text-widget.html), * which gives an overview of all the objects and data types related to the @@ -883,7 +883,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass) */ /** - * GtkTextview:pixels-above-lines: (attributes org.gtk.Property.get=gtk_text_view_get_pixels_above_lines org.gtk.Property.set=gtk_text_view_set_pixels_above_lines) + * GtkTextView:pixels-above-lines: (attributes org.gtk.Property.get=gtk_text_view_get_pixels_above_lines org.gtk.Property.set=gtk_text_view_set_pixels_above_lines) * * Pixels of blank space above paragraphs. */ @@ -894,7 +894,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** - * GtkTextview:pixels-below-lines: (attributes org.gtk.Property.get=gtk_text_view_get_pixels_below_lines org.gtk.Property.set=gtk_text_view_set_pixels_below_lines) + * GtkTextView:pixels-below-lines: (attributes org.gtk.Property.get=gtk_text_view_get_pixels_below_lines org.gtk.Property.set=gtk_text_view_set_pixels_below_lines) * * Pixels of blank space below paragraphs. */ @@ -905,7 +905,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** - * GtkTextview:pixels-inside-wrap: (attributes org.gtk.Property.get=gtk_text_view_get_pixels_inside_wrap org.gtk.Property.set=gtk_text_view_set_pixels_inside_wrap) + * GtkTextView:pixels-inside-wrap: (attributes org.gtk.Property.get=gtk_text_view_get_pixels_inside_wrap org.gtk.Property.set=gtk_text_view_set_pixels_inside_wrap) * * Pixels of blank space between wrapped lines in a paragraph. */ @@ -916,7 +916,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** - * GtkTextview:editable: (attributes org.gtk.Property.get=gtk_text_view_get_editable org.gtk.Property.set=gtk_text_view_set_editable) + * GtkTextView:editable: (attributes org.gtk.Property.get=gtk_text_view_get_editable org.gtk.Property.set=gtk_text_view_set_editable) * * Whether the text can be modified by the user. */ @@ -927,7 +927,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** - * GtkTextview:wrap-mode: (attributes org.gtk.Property.get=gtk_text_view_get_wrap_mode org.gtk.Property.set=gtk_text_view_set_wrap_mode) + * GtkTextView:wrap-mode: (attributes org.gtk.Property.get=gtk_text_view_get_wrap_mode org.gtk.Property.set=gtk_text_view_set_wrap_mode) * * Whether to wrap lines never, at word boundaries, or at character boundaries. */ @@ -939,7 +939,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** - * GtkTextview:justification: (attributes org.gtk.Property.get=gtk_text_view_get_justification org.gtk.Property.set=gtk_text_view_set_justification) + * GtkTextView:justification: (attributes org.gtk.Property.get=gtk_text_view_get_justification org.gtk.Property.set=gtk_text_view_set_justification) * * Left, right, or center justification. */ @@ -1035,7 +1035,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass) GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** - * GtkTextview:tabs: (attributes org.gtk.Property.get=gtk_text_view_get_tabs org.gtk.Property.set=gtk_text_view_set_tabs) + * GtkTextView:tabs: (attributes org.gtk.Property.get=gtk_text_view_get_tabs org.gtk.Property.set=gtk_text_view_set_tabs) * * Custom tabs for this text. */ diff --git a/gtk/print/gtkprintsettings.c b/gtk/print/gtkprintsettings.c index 2c8c3a2f33..68c0924132 100644 --- a/gtk/print/gtkprintsettings.c +++ b/gtk/print/gtkprintsettings.c @@ -779,7 +779,7 @@ gtk_print_settings_set_collate (GtkPrintSettings *settings, * * Gets the value of %GTK_PRINT_SETTINGS_REVERSE. * - * Returns: whether to reverse the order of the printed pages + * Returns: whether to reverse the order of the printed pages */ gboolean gtk_print_settings_get_reverse (GtkPrintSettings *settings)