[libadwaita] docs: Replace @self docstrings



commit a0a92761a9fad862e8fc34e5940dd6217264081c
Author: Maximiliano Sandoval R <msandova gnome org>
Date:   Tue Dec 28 22:35:57 2021 +0100

    docs: Replace @self docstrings

 src/adw-action-row.c               |  30 +++++-----
 src/adw-animation.c                |  18 +++---
 src/adw-application-window.c       |   4 +-
 src/adw-application.c              |   2 +-
 src/adw-avatar.c                   |  22 +++----
 src/adw-bin.c                      |   4 +-
 src/adw-button-content.c           |  12 ++--
 src/adw-carousel-indicator-dots.c  |   4 +-
 src/adw-carousel-indicator-lines.c |   4 +-
 src/adw-carousel.c                 |  48 +++++++--------
 src/adw-clamp-layout.c             |   8 +--
 src/adw-clamp-scrollable.c         |  12 ++--
 src/adw-clamp.c                    |  12 ++--
 src/adw-combo-row.c                |  26 ++++----
 src/adw-easing.c                   |   2 +-
 src/adw-expander-row.c             |  28 ++++-----
 src/adw-flap.c                     |  60 +++++++++----------
 src/adw-header-bar.c               |  26 ++++----
 src/adw-indicator-bin.c            |   4 +-
 src/adw-leaflet.c                  |  74 +++++++++++------------
 src/adw-preferences-group.c        |  14 ++---
 src/adw-preferences-page.c         |  22 +++----
 src/adw-preferences-row.c          |   8 +--
 src/adw-preferences-window.c       |  26 ++++----
 src/adw-split-button.c             |  32 +++++-----
 src/adw-spring-animation.c         |  28 ++++-----
 src/adw-spring-params.c            |  12 ++--
 src/adw-squeezer.c                 |  50 ++++++++--------
 src/adw-status-page.c              |  20 +++----
 src/adw-style-manager.c            |  12 ++--
 src/adw-swipe-tracker.c            |  28 ++++-----
 src/adw-swipeable.c                |  10 ++--
 src/adw-tab-bar.c                  |  32 +++++-----
 src/adw-tab-view.c                 | 118 ++++++++++++++++++-------------------
 src/adw-timed-animation.c          |  28 ++++-----
 src/adw-toast-overlay.c            |   6 +-
 src/adw-toast.c                    |  30 +++++-----
 src/adw-view-stack.c               |  60 +++++++++----------
 src/adw-view-switcher-bar.c        |   8 +--
 src/adw-view-switcher-button.c     |  16 ++---
 src/adw-view-switcher-title.c      |  18 +++---
 src/adw-view-switcher.c            |   8 +--
 src/adw-window-title.c             |   8 +--
 src/adw-window.c                   |   4 +-
 44 files changed, 499 insertions(+), 499 deletions(-)
---
diff --git a/src/adw-action-row.c b/src/adw-action-row.c
index 278537e4..2f9ade75 100644
--- a/src/adw-action-row.c
+++ b/src/adw-action-row.c
@@ -315,7 +315,7 @@ adw_action_row_class_init (AdwActionRowClass *klass)
 
   /**
    * AdwActionRow::activated:
-   * @self: the `AdwActionRow` instance
+   * @self: an action row
    *
    * This signal is emitted after the row has been activated.
    *
@@ -396,7 +396,7 @@ adw_action_row_new (void)
 
 /**
  * adw_action_row_get_subtitle: (attributes org.gtk.Method.get_property=subtitle)
- * @self: a `AdwActionRow`
+ * @self: an action row
  *
  * Gets the subtitle for @self.
  *
@@ -418,7 +418,7 @@ adw_action_row_get_subtitle (AdwActionRow *self)
 
 /**
  * adw_action_row_set_subtitle: (attributes org.gtk.Method.set_property=subtitle)
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @subtitle: the subtitle
  *
  * Sets the subtitle for @self.
@@ -445,7 +445,7 @@ adw_action_row_set_subtitle (AdwActionRow *self,
 
 /**
  * adw_action_row_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwActionRow`
+ * @self: an action row
  *
  * Gets the icon name for @self.
  *
@@ -467,7 +467,7 @@ adw_action_row_get_icon_name (AdwActionRow *self)
 
 /**
  * adw_action_row_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @icon_name: (nullable): the icon name
  *
  * Sets the icon name for @self.
@@ -496,7 +496,7 @@ adw_action_row_set_icon_name (AdwActionRow *self,
 
 /**
  * adw_action_row_get_activatable_widget: (attributes org.gtk.Method.get_property=activatable-widget)
- * @self: a `AdwActionRow`
+ * @self: an action row
  *
  * Gets the widget activated when @self is activated.
  *
@@ -530,7 +530,7 @@ activatable_widget_weak_notify (gpointer  data,
 
 /**
  * adw_action_row_set_activatable_widget: (attributes org.gtk.Method.set_property=activatable-widget)
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @widget: (nullable): the target widget
  *
  * Sets the widget to activate when @self is activated.
@@ -570,7 +570,7 @@ adw_action_row_set_activatable_widget (AdwActionRow *self,
 
 /**
  * adw_action_row_get_title_lines: (attributes org.gtk.Method.get_property=title-lines)
- * @self: a `AdwActionRow`
+ * @self: an action row
  *
  * Gets the number of lines at the end of which the title label will be
  * ellipsized.
@@ -596,7 +596,7 @@ adw_action_row_get_title_lines (AdwActionRow *self)
 
 /**
  * adw_action_row_set_title_lines: (attributes org.gtk.Method.set_property=title-lines)
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @title_lines: the number of lines at the end of which the title label will be ellipsized
  *
  * Sets the number of lines at the end of which the title label will be
@@ -630,7 +630,7 @@ adw_action_row_set_title_lines (AdwActionRow *self,
 
 /**
  * adw_action_row_get_subtitle_lines: (attributes org.gtk.Method.get_property=subtitle-lines)
- * @self: a `AdwActionRow`
+ * @self: an action row
  *
  * Gets the number of lines at the end of which the subtitle label will be
  * ellipsized.
@@ -656,7 +656,7 @@ adw_action_row_get_subtitle_lines (AdwActionRow *self)
 
 /**
  * adw_action_row_set_subtitle_lines: (attributes org.gtk.Method.set_property=subtitle-lines)
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @subtitle_lines: the number of lines at the end of which the subtitle label will be ellipsized
  *
  * Sets the number of lines at the end of which the subtitle label will be
@@ -690,7 +690,7 @@ adw_action_row_set_subtitle_lines (AdwActionRow *self,
 
 /**
  * adw_action_row_add_prefix:
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @widget: a widget
  *
  * Adds a prefix widget to @self.
@@ -714,7 +714,7 @@ adw_action_row_add_prefix (AdwActionRow *self,
 
 /**
  * adw_action_row_add_suffix:
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @widget: a widget
  *
  * Adds a suffix widget to @self.
@@ -738,7 +738,7 @@ adw_action_row_add_suffix (AdwActionRow *self,
 
 /**
  * adw_action_row_remove:
- * @self: a `AdwActionRow`
+ * @self: an action row
  * @widget: the child to be removed
  *
  * Removes a child from @self.
@@ -769,7 +769,7 @@ adw_action_row_remove (AdwActionRow *self,
 
 /**
  * adw_action_row_activate:
- * @self: a `AdwActionRow`
+ * @self: an action row
  *
  * Activates @self.
  *
diff --git a/src/adw-animation.c b/src/adw-animation.c
index 822d7415..1104671f 100644
--- a/src/adw-animation.c
+++ b/src/adw-animation.c
@@ -440,7 +440,7 @@ adw_animation_init (AdwAnimation *self)
 
 /**
  * adw_animation_get_widget: (attributes org.gtk.Method.get_property=widget)
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Gets the widget @self was created for.
  *
@@ -462,7 +462,7 @@ adw_animation_get_widget (AdwAnimation *self)
 
 /**
  * adw_animation_get_target: (attributes org.gtk.Method.get_property=target)
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Gets the target @self animates.
  *
@@ -484,7 +484,7 @@ adw_animation_get_target (AdwAnimation *self)
 
 /**
  * adw_animation_get_value: (attributes org.gtk.Method.get_property=value)
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Gets the current value of @self.
  *
@@ -506,7 +506,7 @@ adw_animation_get_value (AdwAnimation *self)
 
 /**
  * adw_animation_get_state: (attributes org.gtk.Method.get_property=state)
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Gets the current value of @self.
  *
@@ -531,7 +531,7 @@ adw_animation_get_state (AdwAnimation *self)
 
 /**
  * adw_animation_play:
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Starts the animation for @self.
  *
@@ -571,7 +571,7 @@ adw_animation_play (AdwAnimation *self)
 
 /**
  * adw_animation_pause:
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Pauses a playing animation for @self.
  *
@@ -609,7 +609,7 @@ adw_animation_pause (AdwAnimation *self)
 
 /**
  * adw_animation_resume:
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Resumes a paused animation for @self.
  *
@@ -640,7 +640,7 @@ adw_animation_resume (AdwAnimation *self)
 
 /**
  * adw_animation_skip:
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Skips the animation for @self.
  *
@@ -689,7 +689,7 @@ adw_animation_skip (AdwAnimation *self)
 
 /**
  * adw_animation_reset:
- * @self: a `AdwAnimation`
+ * @self: an animation
  *
  * Resets the animation for @self.
  *
diff --git a/src/adw-application-window.c b/src/adw-application-window.c
index 38ecfa4d..d10a88f2 100644
--- a/src/adw-application-window.c
+++ b/src/adw-application-window.c
@@ -190,7 +190,7 @@ adw_application_window_new (GtkApplication *app)
 
 /**
  * adw_application_window_set_content: (attributes org.gtk.Method.set_property=content)
- * @self: a `AdwApplicationWindow`
+ * @self: an application window
  * @content: (nullable): the content widget
  *
  * Sets the content widget of @self.
@@ -213,7 +213,7 @@ adw_application_window_set_content (AdwApplicationWindow *self,
 
 /**
  * adw_application_window_get_content: (attributes org.gtk.Method.get_property=content)
- * @self: a `AdwApplicationWindow`
+ * @self: an application window
  *
  * Gets the content widget of @self.
  *
diff --git a/src/adw-application.c b/src/adw-application.c
index ee9c04ef..217ca926 100644
--- a/src/adw-application.c
+++ b/src/adw-application.c
@@ -278,7 +278,7 @@ adw_application_new (const char        *application_id,
 
 /**
  * adw_application_get_style_manager: (attributes org.gtk.Method.get_property=style-manager)
- * @self: a `AdwApplication`
+ * @self: an application
  *
  * Gets the style manager for @self.
  *
diff --git a/src/adw-avatar.c b/src/adw-avatar.c
index bb19c5af..6e706502 100644
--- a/src/adw-avatar.c
+++ b/src/adw-avatar.c
@@ -458,7 +458,7 @@ adw_avatar_new (int         size,
 
 /**
  * adw_avatar_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  *
  * Gets the name of an icon to use as a fallback.
  *
@@ -476,7 +476,7 @@ adw_avatar_get_icon_name (AdwAvatar *self)
 
 /**
  * adw_avatar_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  * @icon_name: (nullable): the icon name
  *
  * Sets the name of an icon to use as a fallback.
@@ -504,7 +504,7 @@ adw_avatar_set_icon_name (AdwAvatar  *self,
 
 /**
  * adw_avatar_get_text: (attributes org.gtk.Method.get_property=text)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  *
  * Gets the text used to generate the fallback initials and color.
  *
@@ -523,7 +523,7 @@ adw_avatar_get_text (AdwAvatar *self)
 
 /**
  * adw_avatar_set_text: (attributes org.gtk.Method.set_property=text)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  * @text: (nullable): the text used to get the initials and color
  *
  * Sets the text used to generate the fallback initials and color.
@@ -553,7 +553,7 @@ adw_avatar_set_text (AdwAvatar  *self,
 
 /**
  * adw_avatar_get_show_initials: (attributes org.gtk.Method.get_property=show-initials)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  *
  * Gets whether initials are used instead of an icon on the fallback avatar.
  *
@@ -571,7 +571,7 @@ adw_avatar_get_show_initials (AdwAvatar *self)
 
 /**
  * adw_avatar_set_show_initials: (attributes org.gtk.Method.set_property=show-initials)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  * @show_initials: whether to use initials instead of an icon as fallback
  *
  * Sets whether to use initials instead of an icon on the fallback avatar.
@@ -598,7 +598,7 @@ adw_avatar_set_show_initials (AdwAvatar *self,
 
 /**
  * adw_avatar_get_custom_image: (attributes org.gtk.Method.get_property=custom-image)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  *
  * Gets the custom image paintable.
  *
@@ -616,7 +616,7 @@ adw_avatar_get_custom_image (AdwAvatar *self)
 
 /**
  * adw_avatar_set_custom_image: (attributes org.gtk.Method.set_property=custom-image)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  * @custom_image: (nullable) (transfer none): a custom image
  *
  * Sets the custom image paintable.
@@ -668,7 +668,7 @@ adw_avatar_set_custom_image (AdwAvatar    *self,
 
 /**
  * adw_avatar_get_size: (attributes org.gtk.Method.get_property=size)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  *
  * Gets the size of the avatar.
  *
@@ -686,7 +686,7 @@ adw_avatar_get_size (AdwAvatar *self)
 
 /**
  * adw_avatar_set_size: (attributes org.gtk.Method.set_property=size)
- * @self: a `AdwAvatar`
+ * @self: an avatar
  * @size: The size of the avatar
  *
  * Sets the size of the avatar.
@@ -721,7 +721,7 @@ adw_avatar_set_size (AdwAvatar *self,
 
 /**
  * adw_avatar_draw_to_texture:
- * @self: a `AdwAvatar`
+ * @self: an avatar
  * @scale_factor: The scale factor
  *
  * Renders @self into a [class@Gdk.Texture] at @scale_factor.
diff --git a/src/adw-bin.c b/src/adw-bin.c
index 01f179b6..038db1f4 100644
--- a/src/adw-bin.c
+++ b/src/adw-bin.c
@@ -169,7 +169,7 @@ adw_bin_new (void)
 
 /**
  * adw_bin_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwBin`
+ * @self: a bin
  *
  * Gets the child widget of @self.
  *
@@ -191,7 +191,7 @@ adw_bin_get_child (AdwBin *self)
 
 /**
  * adw_bin_set_child: (attributes org.gtk.Method.set_property=child)
- * @self: a `AdwBin`
+ * @self: a bin
  * @child: (nullable): the child widget
  *
  * Sets the child widget of @self.
diff --git a/src/adw-button-content.c b/src/adw-button-content.c
index f475be3e..4889a3fd 100644
--- a/src/adw-button-content.c
+++ b/src/adw-button-content.c
@@ -305,7 +305,7 @@ adw_button_content_new (void)
 
 /**
  * adw_button_content_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwButtonContent`
+ * @self: a button content
  *
  * Gets the name of the displayed icon.
  *
@@ -323,7 +323,7 @@ adw_button_content_get_icon_name (AdwButtonContent *self)
 
 /**
  * adw_button_content_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwButtonContent`
+ * @self: a button content
  * @icon_name: the new icon name
  *
  * Sets the name of the displayed icon.
@@ -353,7 +353,7 @@ adw_button_content_set_icon_name (AdwButtonContent *self,
 
 /**
  * adw_button_content_get_label: (attributes org.gtk.Method.get_property=label)
- * @self: a `AdwButtonContent`
+ * @self: a button content
  *
  * Gets the displayed label.
  *
@@ -371,7 +371,7 @@ adw_button_content_get_label (AdwButtonContent *self)
 
 /**
  * adw_button_content_set_label: (attributes org.gtk.Method.set_property=label)
- * @self: a `AdwButtonContent`
+ * @self: a button content
  * @label: the new label
  *
  * Sets the displayed label.
@@ -398,7 +398,7 @@ adw_button_content_set_label (AdwButtonContent *self,
 
 /**
  * adw_button_content_get_use_underline: (attributes org.gtk.Method.get_property=use-underline)
- * @self: a `AdwButtonContent`
+ * @self: a button content
  *
  * Gets whether an underline in the text indicates a mnemonic.
  *
@@ -416,7 +416,7 @@ adw_button_content_get_use_underline (AdwButtonContent *self)
 
 /**
  * adw_button_content_set_use_underline: (attributes org.gtk.Method.set_property=use-underline)
- * @self: a `AdwButtonContent`
+ * @self: a button content
  * @use_underline: whether an underline in the text indicates a mnemonic
  *
  * Sets whether an underline in the text indicates a mnemonic.
diff --git a/src/adw-carousel-indicator-dots.c b/src/adw-carousel-indicator-dots.c
index a23b8ab8..04cea99b 100644
--- a/src/adw-carousel-indicator-dots.c
+++ b/src/adw-carousel-indicator-dots.c
@@ -379,7 +379,7 @@ adw_carousel_indicator_dots_new (void)
 
 /**
  * adw_carousel_indicator_dots_get_carousel: (attributes org.gtk.Method.get_property=carousel)
- * @self: a `AdwCarouselIndicatorDots`
+ * @self: an indicator
  *
  * Gets the displayed carousel.
  *
@@ -397,7 +397,7 @@ adw_carousel_indicator_dots_get_carousel (AdwCarouselIndicatorDots *self)
 
 /**
  * adw_carousel_indicator_dots_set_carousel: (attributes org.gtk.Method.set_property=carousel)
- * @self: a `AdwCarouselIndicatorDots`
+ * @self: an indicator
  * @carousel: (nullable): a carousel
  *
  * Sets the displayed carousel.
diff --git a/src/adw-carousel-indicator-lines.c b/src/adw-carousel-indicator-lines.c
index bf851049..db7bfca2 100644
--- a/src/adw-carousel-indicator-lines.c
+++ b/src/adw-carousel-indicator-lines.c
@@ -364,7 +364,7 @@ adw_carousel_indicator_lines_new (void)
 
 /**
  * adw_carousel_indicator_lines_get_carousel: (attributes org.gtk.Method.get_property=carousel)
- * @self: a `AdwCarouselIndicatorLines`
+ * @self: an indicator
  *
  * Gets the displayed carousel.
  *
@@ -382,7 +382,7 @@ adw_carousel_indicator_lines_get_carousel (AdwCarouselIndicatorLines *self)
 
 /**
  * adw_carousel_indicator_lines_set_carousel: (attributes org.gtk.Method.set_property=carousel)
- * @self: a `AdwCarouselIndicatorLines`
+ * @self: an indicator
  * @carousel: (nullable): a carousel
  *
  * Sets the displayed carousel.
diff --git a/src/adw-carousel.c b/src/adw-carousel.c
index 6e6bb3ce..e69cd17a 100644
--- a/src/adw-carousel.c
+++ b/src/adw-carousel.c
@@ -1035,7 +1035,7 @@ adw_carousel_class_init (AdwCarouselClass *klass)
 
   /**
    * AdwCarousel::page-changed:
-   * @self: a `AdwCarousel`
+   * @self: a carousel
    * @index: current page
    *
    * This signal is emitted after a page has been changed.
@@ -1191,7 +1191,7 @@ adw_carousel_new (void)
 
 /**
  * adw_carousel_prepend:
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @child: a widget to add
  *
  * Prepends @child to @self.
@@ -1210,7 +1210,7 @@ adw_carousel_prepend (AdwCarousel *self,
 
 /**
  * adw_carousel_append:
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @child: a widget to add
  *
  * Appends @child to @self.
@@ -1229,7 +1229,7 @@ adw_carousel_append (AdwCarousel *self,
 
 /**
  * adw_carousel_insert:
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @child: a widget to add
  * @position: the position to insert @child at
  *
@@ -1278,7 +1278,7 @@ adw_carousel_insert (AdwCarousel *self,
 }
 /**
  * adw_carousel_reorder:
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @child: a widget to add
  * @position: the position to move @child to
  *
@@ -1370,7 +1370,7 @@ adw_carousel_reorder (AdwCarousel *self,
 
 /**
  * adw_carousel_remove:
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @child: a widget to remove
  *
  * Removes @child from @self.
@@ -1405,7 +1405,7 @@ adw_carousel_remove (AdwCarousel *self,
 
 /**
  * adw_carousel_scroll_to:
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @widget: a child of @self
  * @animate: whether to animate the transition
  *
@@ -1432,7 +1432,7 @@ adw_carousel_scroll_to (AdwCarousel *self,
 
 /**
  * adw_carousel_get_nth_page:
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @n: index of the page
  *
  * Gets the page at position @n.
@@ -1457,7 +1457,7 @@ adw_carousel_get_nth_page (AdwCarousel *self,
 
 /**
  * adw_carousel_get_n_pages: (attributes org.gtk.Method.get_property=n-pages)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets the number of pages in @self.
  *
@@ -1486,7 +1486,7 @@ adw_carousel_get_n_pages (AdwCarousel *self)
 
 /**
  * adw_carousel_get_position: (attributes org.gtk.Method.get_property=position)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets current scroll position in @self.
  *
@@ -1506,7 +1506,7 @@ adw_carousel_get_position (AdwCarousel *self)
 
 /**
  * adw_carousel_get_interactive: (attributes org.gtk.Method.get_property=interactive)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets whether @self can be navigated.
  *
@@ -1524,7 +1524,7 @@ adw_carousel_get_interactive (AdwCarousel *self)
 
 /**
  * adw_carousel_set_interactive: (attributes org.gtk.Method.set_property=interactive)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @interactive: whether @self can be navigated
  *
  * Sets whether @self can be navigated.
@@ -1549,7 +1549,7 @@ adw_carousel_set_interactive (AdwCarousel *self,
 
 /**
  * adw_carousel_get_spacing: (attributes org.gtk.Method.get_property=spacing)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets spacing between pages in pixels.
  *
@@ -1567,7 +1567,7 @@ adw_carousel_get_spacing (AdwCarousel *self)
 
 /**
  * adw_carousel_set_spacing: (attributes org.gtk.Method.set_property=spacing)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @spacing: the new spacing value
  *
  * Sets spacing between pages in pixels.
@@ -1591,7 +1591,7 @@ adw_carousel_set_spacing (AdwCarousel *self,
 
 /**
  * adw_carousel_get_scroll_params: (attributes org.gtk.Method.get_property=scroll-params)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets the scroll animation spring parameters for @self.
  *
@@ -1609,7 +1609,7 @@ adw_carousel_get_scroll_params (AdwCarousel *self)
 
 /**
  * adw_carousel_set_scroll_params: (attributes org.gtk.Method.set_property=scroll-params)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @params: the new parameters
  *
  * Sets the scroll animation spring parameters for @self.
@@ -1633,7 +1633,7 @@ adw_carousel_set_scroll_params (AdwCarousel     *self,
 
 /**
  * adw_carousel_get_allow_mouse_drag: (attributes org.gtk.Method.get_property=allow-mouse-drag)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Sets whether @self can be dragged with mouse pointer.
  *
@@ -1651,7 +1651,7 @@ adw_carousel_get_allow_mouse_drag (AdwCarousel *self)
 
 /**
  * adw_carousel_set_allow_mouse_drag: (attributes org.gtk.Method.set_property=allow-mouse-drag)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @allow_mouse_drag: whether @self can be dragged with mouse pointer
  *
  * Sets whether @self can be dragged with mouse pointer.
@@ -1676,7 +1676,7 @@ adw_carousel_set_allow_mouse_drag (AdwCarousel *self,
 
 /**
  * adw_carousel_get_allow_scroll_wheel: (attributes org.gtk.Method.get_property=allow-scroll-wheel)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets whether @self will respond to scroll wheel events.
  *
@@ -1694,7 +1694,7 @@ adw_carousel_get_allow_scroll_wheel (AdwCarousel *self)
 
 /**
  * adw_carousel_set_allow_scroll_wheel: (attributes org.gtk.Method.set_property=allow-scroll-wheel)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @allow_scroll_wheel: whether @self will respond to scroll wheel events
  *
  * Sets whether @self will respond to scroll wheel events.
@@ -1719,7 +1719,7 @@ adw_carousel_set_allow_scroll_wheel (AdwCarousel *self,
 
 /**
  * adw_carousel_get_allow_long_swipes: (attributes org.gtk.Method.get_property=allow-long-swipes)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets whether to allow swiping for more than one page at a time.
  *
@@ -1737,7 +1737,7 @@ adw_carousel_get_allow_long_swipes (AdwCarousel *self)
 
 /**
  * adw_carousel_set_allow_long_swipes: (attributes org.gtk.Method.set_property=allow-long-swipes)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @allow_long_swipes: whether to allow long swipes
  *
  * Sets whether to allow swiping for more than one page at a time.
@@ -1762,7 +1762,7 @@ adw_carousel_set_allow_long_swipes (AdwCarousel *self,
 
 /**
  * adw_carousel_get_reveal_duration: (attributes org.gtk.Method.get_property=reveal-duration)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  *
  * Gets duration of the animation used when adding or removing pages.
  *
@@ -1780,7 +1780,7 @@ adw_carousel_get_reveal_duration (AdwCarousel *self)
 
 /**
  * adw_carousel_set_reveal_duration: (attributes org.gtk.Method.set_property=reveal-duration)
- * @self: a `AdwCarousel`
+ * @self: a carousel
  * @reveal_duration: the new reveal duration value
  *
  * Sets duration of the animation used when adding or removing pages.
diff --git a/src/adw-clamp-layout.c b/src/adw-clamp-layout.c
index be398f3c..5ffa64b2 100644
--- a/src/adw-clamp-layout.c
+++ b/src/adw-clamp-layout.c
@@ -411,7 +411,7 @@ adw_clamp_layout_new (void)
 
 /**
  * adw_clamp_layout_get_maximum_size: (attributes org.gtk.Method.get_property=maximum-size)
- * @self: a `AdwClampLayout`
+ * @self: a clamp layout
  *
  * Gets the maximum size allocated to the children.
  *
@@ -429,7 +429,7 @@ adw_clamp_layout_get_maximum_size (AdwClampLayout *self)
 
 /**
  * adw_clamp_layout_set_maximum_size: (attributes org.gtk.Method.set_property=maximum-size)
- * @self: a `AdwClampLayout`
+ * @self: a clamp layout
  * @maximum_size: the maximum size
  *
  * Sets the maximum size allocated to the children.
@@ -454,7 +454,7 @@ adw_clamp_layout_set_maximum_size (AdwClampLayout *self,
 
 /**
  * adw_clamp_layout_get_tightening_threshold: (attributes org.gtk.Method.get_property=tightening-threshold)
- * @self: a `AdwClampLayout`
+ * @self: a clamp layout
  *
  * Gets the size above which the children are clamped.
  *
@@ -472,7 +472,7 @@ adw_clamp_layout_get_tightening_threshold (AdwClampLayout *self)
 
 /**
  * adw_clamp_layout_set_tightening_threshold: (attributes org.gtk.Method.set_property=tightening-threshold)
- * @self: a `AdwClampLayout`
+ * @self: a clamp layout
  * @tightening_threshold: the tightening threshold
  *
  * Sets the size above which the children are clamped.
diff --git a/src/adw-clamp-scrollable.c b/src/adw-clamp-scrollable.c
index c014b693..beb521e9 100644
--- a/src/adw-clamp-scrollable.c
+++ b/src/adw-clamp-scrollable.c
@@ -358,7 +358,7 @@ adw_clamp_scrollable_new (void)
 
 /**
  * adw_clamp_scrollable_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwClampScrollable`
+ * @self: a clamp scrollable
  *
  * Gets the child widget of @self.
  *
@@ -376,7 +376,7 @@ adw_clamp_scrollable_get_child (AdwClampScrollable *self)
 
 /**
  * adw_clamp_scrollable_set_child: (attributes org.gtk.Method.set_property=child)
- * @self: a `AdwClampScrollable`
+ * @self: a clamp scrollable
  * @child: (nullable): the child widget
  *
  * Sets the child widget of @self.
@@ -430,7 +430,7 @@ adw_clamp_scrollable_set_child (AdwClampScrollable *self,
 
 /**
  * adw_clamp_scrollable_get_maximum_size: (attributes org.gtk.Method.get_property=maximum-size)
- * @self: a `AdwClampScrollable`
+ * @self: a clamp scrollable
  *
  * Gets the maximum size allocated to the child.
  *
@@ -452,7 +452,7 @@ adw_clamp_scrollable_get_maximum_size (AdwClampScrollable *self)
 
 /**
  * adw_clamp_scrollable_set_maximum_size: (attributes org.gtk.Method.set_property=maximum-size)
- * @self: a `AdwClampScrollable`
+ * @self: a clamp scrollable
  * @maximum_size: the maximum size
  *
  * Sets the maximum size allocated to the child.
@@ -479,7 +479,7 @@ adw_clamp_scrollable_set_maximum_size (AdwClampScrollable *self,
 
 /**
  * adw_clamp_scrollable_get_tightening_threshold: (attributes 
org.gtk.Method.get_property=tightening-threshold)
- * @self: a `AdwClampScrollable`
+ * @self: a clamp scrollable
  *
  * Gets the size above which the child is clamped.
  *
@@ -501,7 +501,7 @@ adw_clamp_scrollable_get_tightening_threshold (AdwClampScrollable *self)
 
 /**
  * adw_clamp_scrollable_set_tightening_threshold: (attributes 
org.gtk.Method.set_property=tightening-threshold)
- * @self: a `AdwClampScrollable`
+ * @self: a clamp scrollable
  * @tightening_threshold: the tightening threshold
  *
  * Sets the size above which the child is clamped.
diff --git a/src/adw-clamp.c b/src/adw-clamp.c
index bac5b000..58eabe59 100644
--- a/src/adw-clamp.c
+++ b/src/adw-clamp.c
@@ -275,7 +275,7 @@ adw_clamp_new (void)
 
 /**
  * adw_clamp_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwClamp`
+ * @self: a clamp
  *
  * Gets the child widget of @self.
  *
@@ -293,7 +293,7 @@ adw_clamp_get_child (AdwClamp  *self)
 
 /**
  * adw_clamp_set_child: (attributes org.gtk.Method.set_property=child)
- * @self: a `AdwClamp`
+ * @self: a clamp
  * @child: (nullable): the child widget
  *
  * Sets the child widget of @self.
@@ -322,7 +322,7 @@ adw_clamp_set_child (AdwClamp  *self,
 
 /**
  * adw_clamp_get_maximum_size: (attributes org.gtk.Method.get_property=maximum-size)
- * @self: a `AdwClamp`
+ * @self: a clamp
  *
  * Gets the maximum size allocated to the child.
  *
@@ -344,7 +344,7 @@ adw_clamp_get_maximum_size (AdwClamp *self)
 
 /**
  * adw_clamp_set_maximum_size: (attributes org.gtk.Method.set_property=maximum-size)
- * @self: a `AdwClamp`
+ * @self: a clamp
  * @maximum_size: the maximum size
  *
  * Sets the maximum size allocated to the child.
@@ -371,7 +371,7 @@ adw_clamp_set_maximum_size (AdwClamp *self,
 
 /**
  * adw_clamp_get_tightening_threshold: (attributes org.gtk.Method.get_property=tightening-threshold)
- * @self: a `AdwClamp`
+ * @self: a clamp
  *
  * Gets the size above which the child is clamped.
  *
@@ -393,7 +393,7 @@ adw_clamp_get_tightening_threshold (AdwClamp *self)
 
 /**
  * adw_clamp_set_tightening_threshold: (attributes org.gtk.Method.set_property=tightening-threshold)
- * @self: a `AdwClamp`
+ * @self: a clamp
  * @tightening_threshold: the tightening threshold
  *
  * Sets the size above which the child is clamped.
diff --git a/src/adw-combo-row.c b/src/adw-combo-row.c
index 64878116..a1d46aee 100644
--- a/src/adw-combo-row.c
+++ b/src/adw-combo-row.c
@@ -570,7 +570,7 @@ adw_combo_row_new (void)
 
 /**
  * adw_combo_row_set_selected: (attributes org.gtk.Method.set_property=selected)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  * @position: the position of the item to select, or
  *   [const@Gtk.INVALID_LIST_POSITION]
  *
@@ -599,7 +599,7 @@ adw_combo_row_set_selected (AdwComboRow *self,
 
 /**
  * adw_combo_row_get_selected: (attributes org.gtk.Method.get_property=selected)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  *
  * Gets the position of the selected item.
  *
@@ -625,7 +625,7 @@ adw_combo_row_get_selected (AdwComboRow *self)
 
 /**
  * adw_combo_row_get_selected_item: (attributes org.gtk.Method.get_property=selected-item)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  *
  * Gets the selected item.
  *
@@ -650,7 +650,7 @@ adw_combo_row_get_selected_item (AdwComboRow *self)
 
 /**
  * adw_combo_row_get_model: (attributes org.gtk.Method.get_property=model)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  *
  * Gets the model that provides the displayed items.
  *
@@ -672,7 +672,7 @@ adw_combo_row_get_model (AdwComboRow *self)
 
 /**
  * adw_combo_row_set_model: (attributes org.gtk.Method.set_property=model)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  * @model: (nullable) (transfer none): the model to use
  *
  * Sets the [iface@Gio.ListModel] to use.
@@ -736,7 +736,7 @@ adw_combo_row_set_model (AdwComboRow *self,
 
 /**
  * adw_combo_row_get_factory: (attributes org.gtk.Method.get_property=factory)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  *
  * Gets the factory that's currently used to populate list items.
  *
@@ -758,7 +758,7 @@ adw_combo_row_get_factory (AdwComboRow *self)
 
 /**
  * adw_combo_row_set_factory: (attributes org.gtk.Method.set_property=factory)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  * @factory: (nullable) (transfer none): the factory to use
  *
  * Sets the `GtkListItemFactory` to use for populating list items.
@@ -789,7 +789,7 @@ adw_combo_row_set_factory (AdwComboRow        *self,
 
 /**
  * adw_combo_row_get_list_factory: (attributes org.gtk.Method.get_property=list-factory)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  *
  * Gets the factory that's currently used to populate list items in the popup.
  *
@@ -811,7 +811,7 @@ adw_combo_row_get_list_factory (AdwComboRow *self)
 
 /**
  * adw_combo_row_set_list_factory: (attributes org.gtk.Method.set_property=list-factory)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  * @factory: (nullable) (transfer none): the factory to use
  *
  * Sets the `GtkListItemFactory` to use for populating list items in the popup.
@@ -842,7 +842,7 @@ adw_combo_row_set_list_factory (AdwComboRow        *self,
 
 /**
  * adw_combo_row_get_expression: (attributes org.gtk.Method.get_property=expression)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  *
  * Gets the expression used to obtain strings from items.
  *
@@ -864,7 +864,7 @@ adw_combo_row_get_expression (AdwComboRow *self)
 
 /**
  * adw_combo_row_set_expression: (attributes org.gtk.Method.set_property=expression)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  * @expression: (nullable): an expression
  *
  * Sets the expression used to obtain strings from items.
@@ -901,7 +901,7 @@ adw_combo_row_set_expression (AdwComboRow   *self,
 
 /**
  * adw_combo_row_get_use_subtitle: (attributes org.gtk.Method.get_property=use-subtitle)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  *
  * Gets whether to use the current value as the subtitle.
  *
@@ -923,7 +923,7 @@ adw_combo_row_get_use_subtitle (AdwComboRow *self)
 
 /**
  * adw_combo_row_set_use_subtitle: (attributes org.gtk.Method.set_property=use-subtitle)
- * @self: a `AdwComboRow`
+ * @self: a combo row
  * @use_subtitle: whether to use the current value as the subtitle
  *
  * Sets whether to use the current value as the subtitle.
diff --git a/src/adw-easing.c b/src/adw-easing.c
index 5dac81b9..b6cd4990 100644
--- a/src/adw-easing.c
+++ b/src/adw-easing.c
@@ -429,7 +429,7 @@ ease_in_out_bounce (double t,
 
 /**
  * adw_easing_ease:
- * @self: a `AdwEasing`
+ * @self: an easing value
  * @value: a value to ease
  *
  * Computes easing with @easing for @value.
diff --git a/src/adw-expander-row.c b/src/adw-expander-row.c
index 60eb6776..0f53ad06 100644
--- a/src/adw-expander-row.c
+++ b/src/adw-expander-row.c
@@ -331,7 +331,7 @@ adw_expander_row_new (void)
 
 /**
  * adw_expander_row_get_subtitle: (attributes org.gtk.Method.get_property=subtitle)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  *
  * Gets the subtitle for @self.
  *
@@ -353,7 +353,7 @@ adw_expander_row_get_subtitle (AdwExpanderRow *self)
 
 /**
  * adw_expander_row_set_subtitle: (attributes org.gtk.Method.set_property=subtitle)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @subtitle: the subtitle
  *
  * Sets the subtitle for @self.
@@ -375,7 +375,7 @@ adw_expander_row_set_subtitle (AdwExpanderRow *self,
 
 /**
  * adw_expander_row_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  *
  * Gets the icon name for @self.
  *
@@ -397,7 +397,7 @@ adw_expander_row_get_icon_name (AdwExpanderRow *self)
 
 /**
  * adw_expander_row_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @icon_name: (nullable): the icon name
  *
  * Sets the icon name for @self.
@@ -419,7 +419,7 @@ adw_expander_row_set_icon_name (AdwExpanderRow *self,
 
 /**
  * adw_expander_row_get_expanded: (attributes org.gtk.Method.get_property=expanded)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  *
  * Gets whether @self is expanded.
  *
@@ -441,7 +441,7 @@ adw_expander_row_get_expanded (AdwExpanderRow *self)
 
 /**
  * adw_expander_row_set_expanded: (attributes org.gtk.Method.set_property=expanded)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @expanded: whether to expand the row
  *
  * Sets whether @self is expanded.
@@ -475,7 +475,7 @@ adw_expander_row_set_expanded (AdwExpanderRow *self,
 
 /**
  * adw_expander_row_get_enable_expansion: (attributes org.gtk.Method.get_property=enable-expansion)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  *
  * Gets whether the expansion of @self is enabled.
  *
@@ -497,7 +497,7 @@ adw_expander_row_get_enable_expansion (AdwExpanderRow *self)
 
 /**
  * adw_expander_row_set_enable_expansion: (attributes org.gtk.Method.set_property=enable-expansion)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @enable_expansion: whether to enable the expansion
  *
  * Sets whether the expansion of @self is enabled.
@@ -528,7 +528,7 @@ adw_expander_row_set_enable_expansion (AdwExpanderRow *self,
 
 /**
  * adw_expander_row_get_show_enable_switch: (attributes org.gtk.Method.get_property=show-enable-switch)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  *
  * Gets whether the switch enabling the expansion of @self is visible.
  *
@@ -550,7 +550,7 @@ adw_expander_row_get_show_enable_switch (AdwExpanderRow *self)
 
 /**
  * adw_expander_row_set_show_enable_switch: (attributes org.gtk.Method.set_property=show-enable-switch)
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @show_enable_switch: whether to show the switch enabling the expansion
  *
  * Sets whether the switch enabling the expansion of @self is visible.
@@ -579,7 +579,7 @@ adw_expander_row_set_show_enable_switch (AdwExpanderRow *self,
 
 /**
  * adw_expander_row_add_action:
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @widget: a widget
  *
  * Adds an action widget to @self.
@@ -603,7 +603,7 @@ adw_expander_row_add_action (AdwExpanderRow *self,
 
 /**
  * adw_expander_row_add_prefix:
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @widget: a widget
  *
  * Adds a prefix widget to @self.
@@ -630,7 +630,7 @@ adw_expander_row_add_prefix (AdwExpanderRow *self,
 
 /**
  * adw_expander_row_add_row:
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @child: a widget
  *
  * Adds a widget to @self.
@@ -660,7 +660,7 @@ adw_expander_row_add_row (AdwExpanderRow *self,
 
 /**
  * adw_action_row_expander:
- * @self: a `AdwExpanderRow`
+ * @self: an expander row
  * @widget: the child to be removed
  *
  * Removes a child from @self.
diff --git a/src/adw-flap.c b/src/adw-flap.c
index 9a4146b5..0f768994 100644
--- a/src/adw-flap.c
+++ b/src/adw-flap.c
@@ -1837,7 +1837,7 @@ adw_flap_new (void)
 
 /**
  * adw_flap_get_content: (attributes org.gtk.Method.get_property=content)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the content widget for @self.
  *
@@ -1855,7 +1855,7 @@ adw_flap_get_content (AdwFlap *self)
 
 /**
  * adw_flap_set_content: (attributes org.gtk.Method.set_property=content)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @content: (nullable): the content widget
  *
  * Sets the content widget for @self.
@@ -1887,7 +1887,7 @@ adw_flap_set_content (AdwFlap   *self,
 
 /**
  * adw_flap_get_flap: (attributes org.gtk.Method.get_property=flap)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the flap widget for @self.
  *
@@ -1905,7 +1905,7 @@ adw_flap_get_flap (AdwFlap *self)
 
 /**
  * adw_flap_set_flap: (attributes org.gtk.Method.set_property=flap)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @flap: (nullable): the flap widget
  *
  * Sets the flap widget for @self.
@@ -1938,7 +1938,7 @@ adw_flap_set_flap (AdwFlap   *self,
 
 /**
  * adw_flap_get_separator: (attributes org.gtk.Method.get_property=separator)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the separator widget for @self.
  *
@@ -1956,7 +1956,7 @@ adw_flap_get_separator (AdwFlap *self)
 
 /**
  * adw_flap_set_separator: (attributes org.gtk.Method.set_property=separator)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @separator: (nullable): the separator widget
  *
  * Sets the separator widget for @self.
@@ -1988,7 +1988,7 @@ adw_flap_set_separator (AdwFlap   *self,
 
 /**
  * adw_flap_get_flap_position: (attributes org.gtk.Method.get_property=flap-position)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the flap position for @self.
  *
@@ -2006,7 +2006,7 @@ adw_flap_get_flap_position (AdwFlap *self)
 
 /**
  * adw_flap_set_flap_position: (attributes org.gtk.Method.set_property=flap-position)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @position: the new value
  *
  * Sets the flap position for @self.
@@ -2033,7 +2033,7 @@ adw_flap_set_flap_position (AdwFlap     *self,
 
 /**
  * adw_flap_get_reveal_flap: (attributes org.gtk.Method.get_property=reveal-flap)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets whether the flap widget is revealed for @self.
  *
@@ -2051,7 +2051,7 @@ adw_flap_get_reveal_flap (AdwFlap *self)
 
 /**
  * adw_flap_set_reveal_flap: (attributes org.gtk.Method.set_property=reveal-flap)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @reveal_flap: whether to reveal the flap widget
  *
  * Sets whether the flap widget is revealed for @self.
@@ -2069,7 +2069,7 @@ adw_flap_set_reveal_flap (AdwFlap  *self,
 
 /**
  * adw_flap_get_reveal_params: (attributes org.gtk.Method.get_property=reveal-params)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the reveal animation spring parameters for @self.
  *
@@ -2087,7 +2087,7 @@ adw_flap_get_reveal_params (AdwFlap *self)
 
 /**
  * adw_flap_set_reveal_params: (attributes org.gtk.Method.set_property=reveal-params)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @params: the new parameters
  *
  * Sets the reveal animation spring parameters for @self.
@@ -2112,7 +2112,7 @@ adw_flap_set_reveal_params (AdwFlap         *self,
 
 /**
  * adw_flap_get_reveal_progress: (attributes org.gtk.Method.get_property=reveal-progress)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the current reveal progress for @self.
  *
@@ -2130,7 +2130,7 @@ adw_flap_get_reveal_progress (AdwFlap *self)
 
 /**
  * adw_flap_get_fold_policy: (attributes org.gtk.Method.get_property=fold-policy)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the fold policy for @self.
  *
@@ -2148,7 +2148,7 @@ adw_flap_get_fold_policy (AdwFlap *self)
 
 /**
  * adw_flap_set_fold_policy: (attributes org.gtk.Method.set_property=fold-policy)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @policy: the fold policy
  *
  * Sets the fold policy for @self.
@@ -2189,7 +2189,7 @@ adw_flap_set_fold_policy (AdwFlap           *self,
 
 /**
  * adw_flap_get_fold_duration: (attributes org.gtk.Method.get_property=fold-duration)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the duration that fold transitions in @self will take.
  *
@@ -2207,7 +2207,7 @@ adw_flap_get_fold_duration (AdwFlap *self)
 
 /**
  * adw_flap_set_fold_duration: (attributes org.gtk.Method.set_property=fold-duration)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @duration: the new duration, in milliseconds
  *
  * Sets the duration that fold transitions in @self will take.
@@ -2230,7 +2230,7 @@ adw_flap_set_fold_duration (AdwFlap *self,
 
 /**
  * adw_flap_get_folded: (attributes org.gtk.Method.get_property=folded)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets whether @self is currently folded.
  *
@@ -2248,7 +2248,7 @@ adw_flap_get_folded (AdwFlap *self)
 
 /**
  * adw_flap_get_locked: (attributes org.gtk.Method.get_property=locked)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets whether @self is locked.
  *
@@ -2266,7 +2266,7 @@ adw_flap_get_locked (AdwFlap *self)
 
 /**
  * adw_flap_set_locked: (attributes org.gtk.Method.set_property=locked)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @locked: the new value
  *
  * Sets whether @self is locked.
@@ -2291,7 +2291,7 @@ adw_flap_set_locked (AdwFlap  *self,
 
 /**
  * adw_flap_get_transition_type: (attributes org.gtk.Method.get_property=transition-type)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the type of animation used for reveal and fold transitions in @self.
  *
@@ -2309,7 +2309,7 @@ adw_flap_get_transition_type (AdwFlap *self)
 
 /**
  * adw_flap_set_transition_type: (attributes org.gtk.Method.set_property=transition-type)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @transition_type: the new transition type
  *
  * Sets the type of animation used for reveal and fold transitions in @self.
@@ -2338,7 +2338,7 @@ adw_flap_set_transition_type (AdwFlap               *self,
 
 /**
  * adw_flap_get_modal: (attributes org.gtk.Method.get_property=modal)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets whether @self is modal.
  *
@@ -2356,7 +2356,7 @@ adw_flap_get_modal (AdwFlap *self)
 
 /**
  * adw_flap_set_modal: (attributes org.gtk.Method.set_property=modal)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @modal: whether @self is modal
  *
  * Sets whether @self is modal.
@@ -2386,7 +2386,7 @@ adw_flap_set_modal (AdwFlap  *self,
 
 /**
  * adw_flap_get_swipe_to_open: (attributes org.gtk.Method.get_property=swipe-to-open)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets whether @self can be opened with a swipe gesture.
  *
@@ -2404,7 +2404,7 @@ adw_flap_get_swipe_to_open (AdwFlap *self)
 
 /**
  * adw_flap_set_swipe_to_open: (attributes org.gtk.Method.set_property=swipe-to-open)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @swipe_to_open: whether @self can be opened with a swipe gesture
  *
  * Sets whether @self can be opened with a swipe gesture.
@@ -2431,7 +2431,7 @@ adw_flap_set_swipe_to_open (AdwFlap  *self,
 
 /**
  * adw_flap_get_swipe_to_close: (attributes org.gtk.Method.get_property=swipe-to-close)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets whether @self can be closed with a swipe gesture.
  *
@@ -2449,7 +2449,7 @@ adw_flap_get_swipe_to_close (AdwFlap *self)
 
 /**
  * adw_flap_set_swipe_to_close: (attributes org.gtk.Method.set_property=swipe-to-close)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @swipe_to_close: whether @self can be closed with a swipe gesture
  *
  * Sets whether @self can be closed with a swipe gesture.
@@ -2476,7 +2476,7 @@ adw_flap_set_swipe_to_close (AdwFlap  *self,
 
 /**
  * adw_flap_get_fold_threshold_policy: (attributes org.gtk.Method.get_property=fold-threshold-policy)
- * @self: a `AdwFlap`
+ * @self: a flap
  *
  * Gets the fold threshold policy for @self.
  *
@@ -2492,7 +2492,7 @@ adw_flap_get_fold_threshold_policy (AdwFlap *self)
 
 /**
  * adw_flap_set_fold_threshold_policy: (attributes org.gtk.Method.set_property=fold-threshold-policy)
- * @self: a `AdwFlap`
+ * @self: a flap
  * @policy: the policy to use
  *
  * Sets the fold threshold policy for @self.
diff --git a/src/adw-header-bar.c b/src/adw-header-bar.c
index 2ff30eb2..b53cdf34 100644
--- a/src/adw-header-bar.c
+++ b/src/adw-header-bar.c
@@ -587,7 +587,7 @@ adw_header_bar_new (void)
 
 /**
  * adw_header_bar_pack_start:
- * @self: A `AdwHeaderBar`
+ * @self: a header bar
  * @child: the widget to be added to @self
  *
  * Adds @child to @self, packed with reference to the start of the @self.
@@ -603,7 +603,7 @@ adw_header_bar_pack_start (AdwHeaderBar *self,
 
 /**
  * adw_header_bar_pack_end:
- * @self: A `AdwHeaderBar`
+ * @self: a header bar
  * @child: the widget to be added to @self
  *
  * Adds @child to @self, packed with reference to the end of @self.
@@ -619,7 +619,7 @@ adw_header_bar_pack_end (AdwHeaderBar *self,
 
 /**
  * adw_header_bar_set_title_widget: (attributes org.gtk.Method.set_property=title-widget)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  * @title_widget: (nullable): a widget to use for a title
  *
  * Sets the title widget for @self.
@@ -656,7 +656,7 @@ adw_header_bar_set_title_widget (AdwHeaderBar *self,
 
 /**
  * adw_header_bar_get_title_widget: (attributes org.gtk.Method.get_property=title-widget)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  *
  * Gets the title widget widget of @self.
  *
@@ -674,7 +674,7 @@ adw_header_bar_get_title_widget (AdwHeaderBar *self)
 
 /**
  * adw_header_bar_remove:
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  * @child: the child to remove
  *
  * Removes a child from @self.
@@ -707,7 +707,7 @@ adw_header_bar_remove (AdwHeaderBar *self,
 
 /**
  * adw_header_bar_get_show_start_title_buttons: (attributes 
org.gtk.Method.get_property=show-start-title-buttons)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  *
  * Gets whether to show title buttons at the start of @self.
  *
@@ -725,7 +725,7 @@ adw_header_bar_get_show_start_title_buttons (AdwHeaderBar *self)
 
 /**
  * adw_header_bar_set_show_start_title_buttons: (attributes 
org.gtk.Method.set_property=show-start-title-buttons)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  * @setting: `TRUE` to show standard title buttons
  *
  * Sets whether to show title buttons at the start of @self.
@@ -759,7 +759,7 @@ adw_header_bar_set_show_start_title_buttons (AdwHeaderBar *self,
 
 /**
  * adw_header_bar_get_show_end_title_buttons: (attributes org.gtk.Method.get_property=show-end-title-buttons)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  *
  * Gets whether to show title buttons at the end of @self.
  *
@@ -777,7 +777,7 @@ adw_header_bar_get_show_end_title_buttons (AdwHeaderBar *self)
 
 /**
  * adw_header_bar_set_show_end_title_buttons: (attributes org.gtk.Method.set_property=show-end-title-buttons)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  * @setting: `TRUE` to show standard title buttons
  *
  * Sets whether to show title buttons at the end of @self.
@@ -811,7 +811,7 @@ adw_header_bar_set_show_end_title_buttons (AdwHeaderBar *self,
 
 /**
  * adw_header_bar_set_decoration_layout: (attributes org.gtk.Method.set_property=decoration-layout)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  * @layout: (nullable): a decoration layout, or `NULL` to unset the layout
  *
  * Sets the decoration layout for @self.
@@ -832,7 +832,7 @@ adw_header_bar_set_decoration_layout (AdwHeaderBar *self,
 
 /**
  * adw_header_bar_get_decoration_layout: (attributes org.gtk.Method.get_property=decoration-layout)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  *
  * Gets the decoration layout for @self.
  *
@@ -850,7 +850,7 @@ adw_header_bar_get_decoration_layout (AdwHeaderBar *self)
 
 /**
  * adw_header_bar_get_centering_policy: (attributes org.gtk.Method.get_property=centering-policy)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  *
  * Gets the policy for aligning the center widget.
  *
@@ -868,7 +868,7 @@ adw_header_bar_get_centering_policy (AdwHeaderBar *self)
 
 /**
  * adw_header_bar_set_centering_policy: (attributes org.gtk.Method.set_property=centering-policy)
- * @self: a `AdwHeaderBar`
+ * @self: a header bar
  * @centering_policy: the centering policy
  *
  * Sets the policy for aligning the center widget.
diff --git a/src/adw-indicator-bin.c b/src/adw-indicator-bin.c
index cc2c7e16..a255d5a6 100644
--- a/src/adw-indicator-bin.c
+++ b/src/adw-indicator-bin.c
@@ -395,7 +395,7 @@ adw_indicator_bin_new (void)
 
 /**
  * adw_indicator_bin_get_child:
- * @self: an `AdwIndicatorBin`
+ * @self: an indicator bin
  *
  * Gets the child widget of @self.
  *
@@ -413,7 +413,7 @@ adw_indicator_bin_get_child (AdwIndicatorBin *self)
 
 /**
  * adw_indicator_bin_set_child:
- * @self: an `AdwIndicatorBin`
+ * @self: an indicator bin
  * @child: (nullable): the child widget
  *
  * Sets the child widget of @self.
diff --git a/src/adw-leaflet.c b/src/adw-leaflet.c
index 83340b5d..eea8886a 100644
--- a/src/adw-leaflet.c
+++ b/src/adw-leaflet.c
@@ -2658,7 +2658,7 @@ adw_leaflet_swipeable_init (AdwSwipeableInterface *iface)
 
 /**
  * adw_leaflet_page_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwLeafletPage`
+ * @self: a leaflet page
  *
  * Gets the leaflet child th which @self belongs.
  *
@@ -2676,7 +2676,7 @@ adw_leaflet_page_get_child (AdwLeafletPage *self)
 
 /**
  * adw_leaflet_page_get_name: (attributes org.gtk.Method.get_property=name)
- * @self: a `AdwLeafletPage`
+ * @self: a leaflet page
  *
  * Gets the name of @self.
  *
@@ -2694,7 +2694,7 @@ adw_leaflet_page_get_name (AdwLeafletPage *self)
 
 /**
  * adw_leaflet_page_set_name: (attributes org.gtk.Method.set_property=name)
- * @self: a `AdwLeafletPage`
+ * @self: a leaflet page
  * @name: (nullable): the new value to set
  *
  * Sets the name of the @self.
@@ -2743,7 +2743,7 @@ adw_leaflet_page_set_name (AdwLeafletPage *self,
 
 /**
  * adw_leaflet_page_get_navigatable: (attributes org.gtk.Method.get_property=navigatable)
- * @self: a `AdwLeafletPage`
+ * @self: a leaflet page
  *
  * Gets whether the child can be navigated to when folded.
  *
@@ -2761,7 +2761,7 @@ adw_leaflet_page_get_navigatable (AdwLeafletPage *self)
 
 /**
  * adw_leaflet_page_set_navigatable: (attributes org.gtk.Method.set_property=navigatable)
- * @self: a `AdwLeafletPage`
+ * @self: a leaflet page
  * @navigatable: whether @self can be navigated to when folded
  *
  * Sets whether @self can be navigated to when folded.
@@ -2808,7 +2808,7 @@ adw_leaflet_new (void)
 
 /**
  * adw_leaflet_append:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @child: the widget to add
  *
  * Adds a child to @self.
@@ -2837,7 +2837,7 @@ adw_leaflet_append (AdwLeaflet *self,
 
 /**
  * adw_leaflet_prepend:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @child: the widget to prepend
  *
  * Inserts @child at the first position in @self.
@@ -2859,7 +2859,7 @@ adw_leaflet_prepend (AdwLeaflet *self,
 
 /**
  * adw_leaflet_insert_child_after:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @child: the widget to insert
  * @sibling: (nullable): the sibling after which to insert @child
  *
@@ -2898,7 +2898,7 @@ adw_leaflet_insert_child_after (AdwLeaflet *self,
 
 /**
  * adw_leaflet_reorder_child_after:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @child: the widget to move, must be a child of @self
  * @sibling: (nullable): the sibling to move @child after
  *
@@ -2968,7 +2968,7 @@ adw_leaflet_reorder_child_after (AdwLeaflet *self,
 
 /**
  * adw_leaflet_remove:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @child: the child to remove
  *
  * Removes a child widget from @self.
@@ -3001,7 +3001,7 @@ adw_leaflet_remove (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_page:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @child: a child of @self
  *
  * Returns the [class@LeafletPage] object for @child.
@@ -3022,7 +3022,7 @@ adw_leaflet_get_page (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_folded: (attributes org.gtk.Method.get_property=folded)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets whether @self is folded.
  *
@@ -3040,7 +3040,7 @@ adw_leaflet_get_folded (AdwLeaflet *self)
 
 /**
  * adw_leaflet_get_homogeneous: (attributes org.gtk.Method.get_property=homogeneous)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets whether @self is homogeneous.
  *
@@ -3056,7 +3056,7 @@ adw_leaflet_get_homogeneous (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_homogeneous: (attributes org.gtk.Method.set_property=homogeneous)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @homogeneous: whether to make @self homogeneous
  *
  * Sets @self to be homogeneous or not.
@@ -3086,7 +3086,7 @@ adw_leaflet_set_homogeneous (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_transition_type: (attributes org.gtk.Method.get_property=transition-type)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets the type of animation used for transitions between modes and children.
  *
@@ -3104,7 +3104,7 @@ adw_leaflet_get_transition_type (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_transition_type: (attributes org.gtk.Method.set_property=transition-type)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @transition: the new transition type
  *
  * Sets the type of animation used for transitions between modes and children.
@@ -3140,7 +3140,7 @@ adw_leaflet_set_transition_type (AdwLeaflet               *self,
 
 /**
  * adw_leaflet_get_mode_transition_duration: (attributes 
org.gtk.Method.get_property=mode-transition-duration)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets the mode transition animation duration for @self.
  *
@@ -3158,7 +3158,7 @@ adw_leaflet_get_mode_transition_duration (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_mode_transition_duration: (attributes 
org.gtk.Method.set_property=mode-transition-duration)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @duration: the new duration, in milliseconds
  *
  * Sets the mode transition animation duration for @self.
@@ -3185,7 +3185,7 @@ adw_leaflet_set_mode_transition_duration (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_child_transition_params: (attributes org.gtk.Method.get_property=child-transition-params)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets the child transition spring parameters for @self.
  *
@@ -3203,7 +3203,7 @@ adw_leaflet_get_child_transition_params (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_child_transition_params: (attributes org.gtk.Method.set_property=child-transition-params)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @params: the new parameters
  *
  * Sets the child transition spring parameters for @self.
@@ -3228,7 +3228,7 @@ adw_leaflet_set_child_transition_params (AdwLeaflet      *self,
 
 /**
  * adw_leaflet_get_visible_child: (attributes org.gtk.Method.get_property=visible-child)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets the widget currently visible when the leaflet is folded.
  *
@@ -3249,7 +3249,7 @@ adw_leaflet_get_visible_child (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_visible_child: (attributes org.gtk.Method.set_property=visible-child)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @visible_child: the new child
  *
  * Sets the widget currently visible when the leaflet is folded.
@@ -3277,7 +3277,7 @@ adw_leaflet_set_visible_child (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_visible_child_name: (attributes org.gtk.Method.get_property=visible-child-name)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets the name of the currently visible child widget.
  *
@@ -3298,7 +3298,7 @@ adw_leaflet_get_visible_child_name (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_visible_child_name: (attributes org.gtk.Method.set_property=visible-child-name)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @name: the name of a child
  *
  * Makes the child with the name @name visible.
@@ -3327,7 +3327,7 @@ adw_leaflet_set_visible_child_name (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_child_transition_running: (attributes 
org.gtk.Method.get_property=child-transition-running)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets whether a child transition is currently running for @self.
  *
@@ -3345,7 +3345,7 @@ adw_leaflet_get_child_transition_running (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_can_navigate_back: (attributes org.gtk.Method.set_property=can-navigate-back)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @can_navigate_back: the new value
  *
  * Sets whether gestures and shortcuts for navigating backward are enabled.
@@ -3371,7 +3371,7 @@ adw_leaflet_set_can_navigate_back (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_can_navigate_back: (attributes org.gtk.Method.get_property=can-navigate-back)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets whether gestures and shortcuts for navigating backward are enabled.
  *
@@ -3389,7 +3389,7 @@ adw_leaflet_get_can_navigate_back (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_can_navigate_forward: (attributes org.gtk.Method.set_property=can-navigate-forward)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @can_navigate_forward: the new value
  *
  * Sets whether gestures and shortcuts for navigating forward are enabled.
@@ -3415,7 +3415,7 @@ adw_leaflet_set_can_navigate_forward (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_can_navigate_forward: (attributes org.gtk.Method.get_property=can-navigate-forward)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets whether gestures and shortcuts for navigating forward are enabled.
  *
@@ -3433,7 +3433,7 @@ adw_leaflet_get_can_navigate_forward (AdwLeaflet *self)
 
 /**
  * adw_leaflet_get_adjacent_child:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @direction: the direction
  *
  * Finds the previous or next navigatable child.
@@ -3464,7 +3464,7 @@ adw_leaflet_get_adjacent_child (AdwLeaflet             *self,
 
 /**
  * adw_leaflet_navigate:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @direction: the direction
  *
  * Navigates to the previous or next child.
@@ -3499,7 +3499,7 @@ adw_leaflet_navigate (AdwLeaflet             *self,
 
 /**
  * adw_leaflet_get_child_by_name:
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @name: the name of the child to find
  *
  * Finds the child of @self with @name.
@@ -3528,7 +3528,7 @@ adw_leaflet_get_child_by_name (AdwLeaflet  *self,
 
 /**
  * adw_leaflet_set_can_unfold: (attributes org.gtk.Method.set_property=can-unfold)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @can_unfold: whether @self can unfold
  *
  * Sets whether @self can unfold.
@@ -3555,7 +3555,7 @@ adw_leaflet_set_can_unfold (AdwLeaflet *self,
 
 /**
  * adw_leaflet_get_can_unfold: (attributes org.gtk.Method.get_property=can-unfold)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets whether @self can unfold.
  *
@@ -3573,7 +3573,7 @@ adw_leaflet_get_can_unfold (AdwLeaflet *self)
 
 /**
  * adw_leaflet_get_pages: (attributes org.gtk.Method.get_property=pages)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Returns a [iface@Gio.ListModel] that contains the pages of the leaflet.
  *
@@ -3601,7 +3601,7 @@ adw_leaflet_get_pages (AdwLeaflet *self)
 
 /**
  * adw_leaflet_get_fold_threshold_policy: (attributes org.gtk.Method.get_property=fold-threshold-policy)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  *
  * Gets the fold threshold policy for @self.
  *
@@ -3618,7 +3618,7 @@ adw_leaflet_get_fold_threshold_policy (AdwLeaflet *self)
 
 /**
  * adw_leaflet_set_fold_threshold_policy: (attributes org.gtk.Method.set_property=fold-threshold-policy)
- * @self: a `AdwLeaflet`
+ * @self: a leaflet
  * @policy: the policy to use
  *
  * Sets the fold threshold policy for @self.
diff --git a/src/adw-preferences-group.c b/src/adw-preferences-group.c
index e05c84af..1c9fd1e4 100644
--- a/src/adw-preferences-group.c
+++ b/src/adw-preferences-group.c
@@ -355,7 +355,7 @@ adw_preferences_group_new (void)
 
 /**
  * adw_preferences_group_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwPreferencesGroup`
+ * @self: a preferences group
  *
  * Gets the title of @self.
  *
@@ -377,7 +377,7 @@ adw_preferences_group_get_title (AdwPreferencesGroup *self)
 
 /**
  * adw_preferences_group_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwPreferencesGroup`
+ * @self: a preferences group
  * @title: the title
  *
  * Sets the title for @self.
@@ -406,7 +406,7 @@ adw_preferences_group_set_title (AdwPreferencesGroup *self,
 
 /**
  * adw_preferences_group_get_description: (attributes org.gtk.Method.get_property=description)
- * @self: a `AdwPreferencesGroup`
+ * @self: a preferences group
  *
  * Gets the description of @self.
  *
@@ -428,7 +428,7 @@ adw_preferences_group_get_description (AdwPreferencesGroup *self)
 
 /**
  * adw_preferences_group_set_description: (attributes org.gtk.Method.set_property=description)
- * @self: a `AdwPreferencesGroup`
+ * @self: a preferences group
  * @description: (nullable): the description
  *
  * Sets the description for @self.
@@ -473,7 +473,7 @@ row_has_title (AdwPreferencesRow *row,
 
 /**
  * adw_preferences_group_get_rows:
- * @self: a `AdwPreferencesGroup`
+ * @self: a preferences group
  *
  * Gets a [iface@Gio.ListModel] that contains the rows of the group.
  *
@@ -503,7 +503,7 @@ adw_preferences_group_get_rows (AdwPreferencesGroup *self)
 
 /**
  * adw_preferences_group_add:
- * @self: a `AdwPreferencesGroup`
+ * @self: a preferences group
  * @child: the widget to add
  *
  * Adds a child to @self.
@@ -529,7 +529,7 @@ adw_preferences_group_add (AdwPreferencesGroup *self,
 
 /**
  * adw_preferences_group_remove:
- * @self: a `AdwPreferencesGroup`
+ * @self: a preferences group
  * @child: the child to remove
  *
  * Removes a child from @self.
diff --git a/src/adw-preferences-page.c b/src/adw-preferences-page.c
index 973dfe49..06655cdd 100644
--- a/src/adw-preferences-page.c
+++ b/src/adw-preferences-page.c
@@ -274,7 +274,7 @@ adw_preferences_page_new (void)
 
 /**
  * adw_preferences_page_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  *
  * Gets the icon name for @self.
  *
@@ -296,7 +296,7 @@ adw_preferences_page_get_icon_name (AdwPreferencesPage *self)
 
 /**
  * adw_preferences_page_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  * @icon_name: (nullable): the icon name
  *
  * Sets the icon name for @self.
@@ -324,7 +324,7 @@ adw_preferences_page_set_icon_name (AdwPreferencesPage *self,
 
 /**
  * adw_preferences_page_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  *
  * Gets the title of @self.
  *
@@ -346,7 +346,7 @@ adw_preferences_page_get_title (AdwPreferencesPage *self)
 
 /**
  * adw_preferences_page_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  * @title: the title
  *
  * Sets the title of @self.
@@ -374,7 +374,7 @@ adw_preferences_page_set_title (AdwPreferencesPage *self,
 
 /**
  * adw_preferences_page_get_name: (attributes org.gtk.Method.get_property=name)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  *
  * Gets the name of @self.
  *
@@ -396,7 +396,7 @@ adw_preferences_page_get_name (AdwPreferencesPage *self)
 
 /**
  * adw_preferences_page_set_name: (attributes org.gtk.Method.set_property=name)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  * @name: (nullable): the name
  *
  * Sets the name of @self.
@@ -424,7 +424,7 @@ adw_preferences_page_set_name (AdwPreferencesPage *self,
 
 /**
  * adw_preferences_page_get_rows:
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  *
  * Gets a [iface@Gio.ListModel] that contains the rows of the page.
  *
@@ -459,7 +459,7 @@ adw_preferences_page_get_rows (AdwPreferencesPage *self)
 
 /**
  * adw_preferences_page_get_use_underline: (attributes org.gtk.Method.get_property=use-underline)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  *
  * Gets whether an embedded underline in the title indicates a mnemonic.
  *
@@ -481,7 +481,7 @@ adw_preferences_page_get_use_underline (AdwPreferencesPage *self)
 
 /**
  * adw_preferences_page_set_use_underline: (attributes org.gtk.Method.set_property=use-underline)
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  * @use_underline: `TRUE` if underlines in the text indicate mnemonics
  *
  * Sets whether an embedded underline in the title indicates a mnemonic.
@@ -510,7 +510,7 @@ adw_preferences_page_set_use_underline (AdwPreferencesPage *self,
 
 /**
  * adw_preferences_page_add:
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  * @group: the group to add
  *
  * Adds a preferences group to @self.
@@ -533,7 +533,7 @@ adw_preferences_page_add (AdwPreferencesPage  *self,
 
 /**
  * adw_preferences_page_remove:
- * @self: a `AdwPreferencesPage`
+ * @self: a preferences page
  * @group: the group to remove
  *
  * Removes a group from @self.
diff --git a/src/adw-preferences-row.c b/src/adw-preferences-row.c
index 7c40fc75..71eb7da7 100644
--- a/src/adw-preferences-row.c
+++ b/src/adw-preferences-row.c
@@ -157,7 +157,7 @@ adw_preferences_row_new (void)
 
 /**
  * adw_preferences_row_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwPreferencesRow`
+ * @self: a preferences row
  *
  * Gets the title of the preference represented by @self.
  *
@@ -179,7 +179,7 @@ adw_preferences_row_get_title (AdwPreferencesRow *self)
 
 /**
  * adw_preferences_row_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwPreferencesRow`
+ * @self: a preferences row
  * @title: the title
  *
  * Sets the title of the preference represented by @self.
@@ -207,7 +207,7 @@ adw_preferences_row_set_title (AdwPreferencesRow *self,
 
 /**
  * adw_preferences_row_get_use_underline: (attributes org.gtk.Method.get_property=use-underline)
- * @self: a `AdwPreferencesRow`
+ * @self: a preferences row
  *
  * Gets whether an embedded underline in the title indicates a mnemonic.
  *
@@ -229,7 +229,7 @@ adw_preferences_row_get_use_underline (AdwPreferencesRow *self)
 
 /**
  * adw_preferences_row_set_use_underline: (attributes org.gtk.Method.set_property=use-underline)
- * @self: a `AdwPreferencesRow`
+ * @self: a preferences row
  * @use_underline: `TRUE` if underlines in the text indicate mnemonics
  *
  * Sets whether an embedded underline in the title indicates a mnemonic.
diff --git a/src/adw-preferences-window.c b/src/adw-preferences-window.c
index bb69eeb5..d9308d0f 100644
--- a/src/adw-preferences-window.c
+++ b/src/adw-preferences-window.c
@@ -709,7 +709,7 @@ adw_preferences_window_new (void)
 
 /**
  * adw_preferences_window_get_search_enabled: (attributes org.gtk.Method.get_property=search-enabled)
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  *
  * Gets whether search is enabled for @self.
  *
@@ -731,7 +731,7 @@ adw_preferences_window_get_search_enabled (AdwPreferencesWindow *self)
 
 /**
  * adw_preferences_window_set_search_enabled: (attributes org.gtk.Method.set_property=search-enabled)
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @search_enabled: whether search is enabled
  *
  * Sets whether search is enabled for @self.
@@ -767,7 +767,7 @@ adw_preferences_window_set_search_enabled (AdwPreferencesWindow *self,
 
 /**
  * adw_preferences_window_set_can_navigate_back: (attributes org.gtk.Method.set_property=can-navigate-back)
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @can_navigate_back: the new value
  *
  * Sets whether gestures and shortcuts for closing subpages are enabled.
@@ -796,7 +796,7 @@ adw_preferences_window_set_can_navigate_back (AdwPreferencesWindow *self,
 
 /**
  * adw_preferences_window_get_can_navigate_back: (attributes org.gtk.Method.get_property=can-navigate-back)
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  *
  * Gets whether gestures and shortcuts for closing subpages are enabled.
  *
@@ -818,7 +818,7 @@ adw_preferences_window_get_can_navigate_back (AdwPreferencesWindow *self)
 
 /**
  * adw_preferences_window_present_subpage:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @subpage: the subpage
  *
  * Sets @subpage as the window's subpage and opens it.
@@ -855,7 +855,7 @@ adw_preferences_window_present_subpage (AdwPreferencesWindow *self,
 
 /**
  * adw_preferences_window_close_subpage:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  *
  * Closes the current subpage.
  *
@@ -882,7 +882,7 @@ adw_preferences_window_close_subpage (AdwPreferencesWindow *self)
 
 /**
  * adw_preferences_window_add:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @page: the page to add
  *
  * Adds a preferences page to @self.
@@ -911,7 +911,7 @@ adw_preferences_window_add (AdwPreferencesWindow *self,
 
 /**
  * adw_preferences_window_remove:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @page: the page to remove
  *
  * Removes a page from @self.
@@ -937,7 +937,7 @@ adw_preferences_window_remove (AdwPreferencesWindow *self,
 
 /**
  * adw_preferences_window_get_visible_page:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  *
  * Gets the currently visible page of @self.
  *
@@ -959,7 +959,7 @@ adw_preferences_window_get_visible_page (AdwPreferencesWindow *self)
 
 /**
  * adw_preferences_window_set_visible_page:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @page: a page of @self
  *
  * Makes @page the visible page of @self.
@@ -982,7 +982,7 @@ adw_preferences_window_set_visible_page (AdwPreferencesWindow *self,
 
 /**
  * adw_preferences_window_get_visible_page_name:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  *
  * Gets the name of currently visible page of @self.
  *
@@ -1004,7 +1004,7 @@ adw_preferences_window_get_visible_page_name (AdwPreferencesWindow *self)
 
 /**
  * adw_preferences_window_set_visible_page_name:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @name: the name of the page to make visible
  *
  * Makes the page with the given name visible.
@@ -1026,7 +1026,7 @@ adw_preferences_window_set_visible_page_name (AdwPreferencesWindow *self,
 
 /**
  * adw_preferences_window_add_toast:
- * @self: a `AdwPreferencesWindow`
+ * @self: a preferences window
  * @toast: (transfer full): a toast
  *
  * Displays @toast.
diff --git a/src/adw-split-button.c b/src/adw-split-button.c
index 268d196b..4aad04e4 100644
--- a/src/adw-split-button.c
+++ b/src/adw-split-button.c
@@ -591,7 +591,7 @@ adw_split_button_new (void)
 
 /**
  * adw_split_button_get_label: (attributes org.gtk.Method.get_property=label)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Gets the label for @self.
  *
@@ -609,7 +609,7 @@ adw_split_button_get_label (AdwSplitButton *self)
 
 /**
  * adw_split_button_set_label: (attributes org.gtk.Method.set_property=label)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  * @label: the label to set
  *
  * Sets the label for @self.
@@ -641,7 +641,7 @@ adw_split_button_set_label (AdwSplitButton *self,
 
 /**
  * adw_split_button_get_use_underline: (attributes org.gtk.Method.get_property=use-underline)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Gets whether an underline in the text indicates a mnemonic.
  *
@@ -659,7 +659,7 @@ adw_split_button_get_use_underline (AdwSplitButton *self)
 
 /**
  * adw_split_button_set_use_underline: (attributes org.gtk.Method.set_property=use-underline)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  * @use_underline: whether an underline in the text indicates a mnemonic
  *
  * Sets whether an underline in the text indicates a mnemonic.
@@ -682,7 +682,7 @@ adw_split_button_set_use_underline (AdwSplitButton *self,
 
 /**
  * adw_split_button_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Gets the name of the icon used to automatically populate the button.
  *
@@ -703,7 +703,7 @@ adw_split_button_get_icon_name (AdwSplitButton *self)
 
 /**
  * adw_split_button_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  * @icon_name: the icon name to set
  *
  * Sets the name of the icon used to automatically populate the button.
@@ -736,7 +736,7 @@ adw_split_button_set_icon_name (AdwSplitButton *self,
 
 /**
  * adw_split_button_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Gets the child widget.
  *
@@ -754,7 +754,7 @@ adw_split_button_get_child (AdwSplitButton *self)
 
 /**
  * adw_split_button_set_child: (attributes org.gtk.Method.set_property=child)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  * @child: (nullable): the new child widget
  *
  * Sets the child widget.
@@ -786,7 +786,7 @@ adw_split_button_set_child (AdwSplitButton *self,
 
 /**
  * adw_split_button_get_menu_model: (attributes org.gtk.Method.get_property=menu-model)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Gets the menu model from which the popup will be created.
  *
@@ -804,7 +804,7 @@ adw_split_button_get_menu_model (AdwSplitButton *self)
 
 /**
  * adw_split_button_set_menu_model: (attributes org.gtk.Method.set_property=menu-model)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  * @menu_model: (nullable): the menu model
  *
  * Sets the menu model from which the popup will be created.
@@ -825,7 +825,7 @@ adw_split_button_set_menu_model (AdwSplitButton *self,
 
 /**
  * adw_split_button_get_popover: (attributes org.gtk.Method.get_property=popover)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Gets the popover that will be popped up when the dropdown is clicked.
  *
@@ -843,7 +843,7 @@ adw_split_button_get_popover (AdwSplitButton *self)
 
 /**
  * adw_split_button_set_popover: (attributes org.gtk.Method.set_property=popover)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  * @popover: (nullable): the popover
  *
  * Sets the popover that will be popped up when the dropdown is clicked.
@@ -864,7 +864,7 @@ adw_split_button_set_popover (AdwSplitButton *self,
 
 /**
  * adw_split_button_get_direction: (attributes org.gtk.Method.get_property=direction)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Gets the direction in which the popup will be popped up.
  *
@@ -882,7 +882,7 @@ adw_split_button_get_direction (AdwSplitButton *self)
 
 /**
  * adw_split_button_set_direction: (attributes org.gtk.Method.set_property=direction)
- * @self: a `AdwSplitButton`
+ * @self: a split button
  * @direction: the direction
  *
  * Sets the direction in which the popup will be popped up.
@@ -905,7 +905,7 @@ adw_split_button_set_direction (AdwSplitButton *self,
 
 /**
  * adw_split_button_popup:
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Pops up the menu.
  *
@@ -921,7 +921,7 @@ adw_split_button_popup (AdwSplitButton *self)
 
 /**
  * adw_split_button_popdown:
- * @self: a `AdwSplitButton`
+ * @self: a split button
  *
  * Dismisses the menu.
  *
diff --git a/src/adw-spring-animation.c b/src/adw-spring-animation.c
index 2e106286..7f282de0 100644
--- a/src/adw-spring-animation.c
+++ b/src/adw-spring-animation.c
@@ -596,7 +596,7 @@ adw_spring_animation_new (GtkWidget         *widget,
 
 /**
  * adw_spring_animation_get_value_from: (attributes org.gtk.Method.get_property=value-from)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets the value @self will animate from.
  *
@@ -614,7 +614,7 @@ adw_spring_animation_get_value_from (AdwSpringAnimation *self)
 
 /**
  * adw_spring_animation_set_value_from: (attributes org.gtk.Method.set_property=value-from)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  * @value: the value to animate from
  *
  * Sets the value @self will animate from.
@@ -639,7 +639,7 @@ adw_spring_animation_set_value_from (AdwSpringAnimation *self,
 
 /**
  * adw_spring_animation_get_value_to: (attributes org.gtk.Method.get_property=value-to)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets the value @self will animate to.
  *
@@ -657,7 +657,7 @@ adw_spring_animation_get_value_to (AdwSpringAnimation *self)
 
 /**
  * adw_spring_animation_set_value_to: (attributes org.gtk.Method.set_property=value-to)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  * @value: the value to animate to
  *
  * Sets the value @self will animate to.
@@ -682,7 +682,7 @@ adw_spring_animation_set_value_to (AdwSpringAnimation *self,
 
 /**
  * adw_spring_animation_get_spring_params: (attributes org.gtk.Method.get_property=spring-params)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets the physical parameters of the spring of @self.
  *
@@ -700,7 +700,7 @@ adw_spring_animation_get_spring_params (AdwSpringAnimation *self)
 
 /**
  * adw_spring_animation_set_spring_params: (attributes org.gtk.Method.set_property=spring-params)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  * @spring_params: the new spring parameters
  *
  * Sets the physical parameters of the spring of @self.
@@ -727,7 +727,7 @@ adw_spring_animation_set_spring_params (AdwSpringAnimation *self,
 
 /**
  * adw_spring_animation_get_initial_velocity: (attributes org.gtk.Method.get_property=initial-velocity)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets the initial velocity of @self.
  *
@@ -745,7 +745,7 @@ adw_spring_animation_get_initial_velocity (AdwSpringAnimation *self)
 
 /**
  * adw_spring_animation_set_initial_velocity: (attributes org.gtk.Method.set_property=initial-velocity)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  * @velocity: the initial velocity
  *
  * Sets the initial velocity of @self.
@@ -770,7 +770,7 @@ adw_spring_animation_set_initial_velocity (AdwSpringAnimation *self,
 
 /**
  * adw_spring_animation_get_epsilon: (attributes org.gtk.Method.get_property=epsilon)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets the precision used to determine the duration of @self.
  *
@@ -788,7 +788,7 @@ adw_spring_animation_get_epsilon (AdwSpringAnimation *self)
 
 /**
  * adw_spring_animation_set_epsilon: (attributes org.gtk.Method.set_property=epsilon)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  * @epsilon: the new value
  *
  * Sets the precision used to determine the duration of @self.
@@ -814,7 +814,7 @@ adw_spring_animation_set_epsilon (AdwSpringAnimation *self,
 
 /**
  * adw_spring_animation_get_clamp: (attributes org.gtk.Method.get_property=clamp)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets whether @self should be clamped.
  *
@@ -832,7 +832,7 @@ adw_spring_animation_get_clamp (AdwSpringAnimation *self)
 
 /**
  * adw_spring_animation_set_clamp: (attributes org.gtk.Method.set_property=clamp)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  * @clamp: the new value
  *
  * Sets whether @self should be clamped.
@@ -857,7 +857,7 @@ adw_spring_animation_set_clamp (AdwSpringAnimation *self,
 
 /**
  * adw_spring_animation_get_estimated_duration: (attributes org.gtk.Method.get_property=estimated-duration)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets the estimated duration of @self.
  *
@@ -875,7 +875,7 @@ adw_spring_animation_get_estimated_duration (AdwSpringAnimation *self)
 
 /**
  * adw_spring_animation_get_velocity: (attributes org.gtk.Method.get_property=velocity)
- * @self: a `AdwSpringAnimation`
+ * @self: a spring animation
  *
  * Gets the current velocity of @self.
  *
diff --git a/src/adw-spring-params.c b/src/adw-spring-params.c
index 60f8a0fc..0cc3ed3b 100644
--- a/src/adw-spring-params.c
+++ b/src/adw-spring-params.c
@@ -139,7 +139,7 @@ adw_spring_params_new_full (double damping,
 
 /**
  * adw_spring_params_ref:
- * @self: a `AdwSpringParams`
+ * @self: spring params
  *
  * Increases the reference count of @self.
  *
@@ -159,7 +159,7 @@ adw_spring_params_ref (AdwSpringParams *self)
 
 /**
  * adw_spring_params_unref:
- * @self: a `AdwSpringParams`
+ * @self: spring params
  *
  * Decreases the reference count of @self.
  *
@@ -178,7 +178,7 @@ adw_spring_params_unref (AdwSpringParams *self)
 
 /**
  * adw_spring_params_get_damping:
- * @self: a `AdwSpringParams`
+ * @self: spring params
  *
  * Gets the damping of @self.
  *
@@ -196,7 +196,7 @@ adw_spring_params_get_damping (AdwSpringParams *self)
 
 /**
  * adw_spring_params_get_damping_ratio:
- * @self: a `AdwSpringParams`
+ * @self: spring params
  *
  * Gets the damping ratio of @self.
  *
@@ -218,7 +218,7 @@ adw_spring_params_get_damping_ratio (AdwSpringParams *self)
 
 /**
  * adw_spring_params_get_mass:
- * @self: a `AdwSpringParams`
+ * @self: spring params
  *
  * Gets the mass of @self.
  *
@@ -236,7 +236,7 @@ adw_spring_params_get_mass (AdwSpringParams *self)
 
 /**
  * adw_spring_params_get_stiffness:
- * @self: a `AdwSpringParams`
+ * @self: spring params
  *
  * Gets the stiffness of @self.
  *
diff --git a/src/adw-squeezer.c b/src/adw-squeezer.c
index dbc97b33..15c75fbe 100644
--- a/src/adw-squeezer.c
+++ b/src/adw-squeezer.c
@@ -1301,7 +1301,7 @@ adw_squeezer_buildable_init (GtkBuildableIface *iface)
 
 /**
  * adw_squeezer_page_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwSqueezerPage`
+ * @self: a squeezer page
  *
  * Returns the squeezer child to which @self belongs.
  *
@@ -1319,7 +1319,7 @@ adw_squeezer_page_get_child (AdwSqueezerPage *self)
 
 /**
  * adw_squeezer_page_get_enabled: (attributes org.gtk.Method.get_property=enabled)
- * @self: a `AdwSqueezerPage`
+ * @self: a squeezer page
  *
  * Gets whether @self is enabled.
  *
@@ -1337,7 +1337,7 @@ adw_squeezer_page_get_enabled (AdwSqueezerPage *self)
 
 /**
  * adw_squeezer_page_set_enabled: (attributes org.gtk.Method.set_property=enabled)
- * @self: a `AdwSqueezerPage`
+ * @self: a squeezer page
  * @enabled: whether @self is enabled
  *
  * Sets whether @self is enabled.
@@ -1384,7 +1384,7 @@ adw_squeezer_new (void)
 
 /**
  * adw_squeezer_add:
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @child: the widget to add
  *
  * Adds a child to @self.
@@ -1414,7 +1414,7 @@ adw_squeezer_add (AdwSqueezer *self,
 
 /**
  * adw_squeezer_remove:
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @child: the child to remove
  *
  * Removes a child widget from @self.
@@ -1447,7 +1447,7 @@ adw_squeezer_remove (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_page:
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @child: a child of @self
  *
  * Returns the [class@SqueezerPage] object for @child.
@@ -1468,7 +1468,7 @@ adw_squeezer_get_page (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_homogeneous: (attributes org.gtk.Method.get_property=homogeneous)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets whether all children have the same size for the opposite orientation.
  *
@@ -1486,7 +1486,7 @@ adw_squeezer_get_homogeneous (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_homogeneous: (attributes org.gtk.Method.set_property=homogeneous)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @homogeneous: whether @self is homogeneous
  *
  * Sets whether all children have the same size for the opposite orientation.
@@ -1514,7 +1514,7 @@ adw_squeezer_set_homogeneous (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_switch_threshold_policy: (attributes org.gtk.Method.get_property=switch-threshold-policy)
- * @self: a `AdwLeaflet`
+ * @self: a squeezer
  *
  * Gets the fold threshold policy for @self.
  *
@@ -1531,7 +1531,7 @@ adw_squeezer_get_switch_threshold_policy (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_switch_threshold_policy: (attributes org.gtk.Method.set_property=switch-threshold-policy)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @policy: the policy to use
  *
  * Sets the fold threshold policy for @self.
@@ -1557,7 +1557,7 @@ adw_squeezer_set_switch_threshold_policy (AdwSqueezer            *self,
 
 /**
  * adw_squeezer_get_allow_none: (attributes org.gtk.Method.get_property=allow-none)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets whether to allow squeezing beyond the last child's minimum size.
  *
@@ -1575,7 +1575,7 @@ adw_squeezer_get_allow_none (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_allow_none: (attributes org.gtk.Method.set_property=allow-none)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @allow_none: whether @self allows squeezing beyond the last child
  *
  * Sets whether to allow squeezing beyond the last child's minimum size.
@@ -1602,7 +1602,7 @@ adw_squeezer_set_allow_none (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_transition_duration: (attributes org.gtk.Method.get_property=transition-duration)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets the transition animation duration for @self.
  *
@@ -1620,7 +1620,7 @@ adw_squeezer_get_transition_duration (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_transition_duration: (attributes org.gtk.Method.set_property=transition-duration)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @duration: the new duration, in milliseconds
  *
  * Sets the transition animation duration for @self.
@@ -1643,7 +1643,7 @@ adw_squeezer_set_transition_duration (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_transition_type: (attributes org.gtk.Method.get_property=transition-type)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets the type of animation used for transitions between children in @self.
  *
@@ -1661,7 +1661,7 @@ adw_squeezer_get_transition_type (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_transition_type: (attributes org.gtk.Method.set_property=transition-type)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @transition: the new transition type
  *
  * Sets the type of animation used for transitions between children in @self.
@@ -1683,7 +1683,7 @@ adw_squeezer_set_transition_type (AdwSqueezer               *self,
 
 /**
  * adw_squeezer_get_transition_running: (attributes org.gtk.Method.get_property=transition-running)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets whether a transition is currently running for @self.
  *
@@ -1701,7 +1701,7 @@ adw_squeezer_get_transition_running (AdwSqueezer *self)
 
 /**
  * adw_squeezer_get_interpolate_size: (attributes org.gtk.Method.get_property=interpolate-size)
- * @self: A `AdwSqueezer`
+ * @self: A squeezer
  *
  * Gets whether @self interpolates its size when changing the visible child.
  *
@@ -1719,7 +1719,7 @@ adw_squeezer_get_interpolate_size (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_interpolate_size: (attributes org.gtk.Method.set_property=interpolate-size)
- * @self: A `AdwSqueezer`
+ * @self: A squeezer
  * @interpolate_size: whether to interpolate the size
  *
  * Sets whether @self interpolates its size when changing the visible child.
@@ -1743,7 +1743,7 @@ adw_squeezer_set_interpolate_size (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_visible_child: (attributes org.gtk.Method.get_property=visible-child)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets the currently visible child of @self.
  *
@@ -1761,7 +1761,7 @@ adw_squeezer_get_visible_child (AdwSqueezer *self)
 
 /**
  * adw_squeezer_get_xalign: (attributes org.gtk.Method.get_property=xalign)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets the horizontal alignment, from 0 (start) to 1 (end).
  *
@@ -1779,7 +1779,7 @@ adw_squeezer_get_xalign (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_xalign: (attributes org.gtk.Method.set_property=xalign)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @xalign: the new alignment value
  *
  * Sets the horizontal alignment, from 0 (start) to 1 (end).
@@ -1804,7 +1804,7 @@ adw_squeezer_set_xalign (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_yalign: (attributes org.gtk.Method.get_property=yalign)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Gets the vertical alignment, from 0 (top) to 1 (bottom).
  *
@@ -1822,7 +1822,7 @@ adw_squeezer_get_yalign (AdwSqueezer *self)
 
 /**
  * adw_squeezer_set_yalign: (attributes org.gtk.Method.set_property=yalign)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  * @yalign: the new alignment value
  *
  * Sets the vertical alignment, from 0 (top) to 1 (bottom).
@@ -1847,7 +1847,7 @@ adw_squeezer_set_yalign (AdwSqueezer *self,
 
 /**
  * adw_squeezer_get_pages: (attributes org.gtk.Method.get_property=pages)
- * @self: a `AdwSqueezer`
+ * @self: a squeezer
  *
  * Returns a [iface@Gio.ListModel] that contains the pages of @self.
  *
diff --git a/src/adw-status-page.c b/src/adw-status-page.c
index 3a6de4f1..a4951e87 100644
--- a/src/adw-status-page.c
+++ b/src/adw-status-page.c
@@ -328,7 +328,7 @@ adw_status_page_new (void)
 
 /**
  * adw_status_page_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  *
  * Gets the icon name for @self.
  *
@@ -346,7 +346,7 @@ adw_status_page_get_icon_name (AdwStatusPage *self)
 
 /**
  * adw_status_page_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  * @icon_name: (nullable): the icon name
  *
  * Sets the icon name for @self.
@@ -379,7 +379,7 @@ adw_status_page_set_icon_name (AdwStatusPage *self,
 
 /**
  * adw_status_page_get_paintable: (attributes org.gtk.Method.get_property=paintable)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  *
  * Gets the paintable for @self.
  *
@@ -397,7 +397,7 @@ adw_status_page_get_paintable (AdwStatusPage *self)
 
 /**
  * adw_status_page_set_paintable: (attributes org.gtk.Method.set_property=paintable)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  * @paintable: (nullable): the paintable
  *
  * Sets the paintable for @self.
@@ -430,7 +430,7 @@ adw_status_page_set_paintable (AdwStatusPage *self,
 
 /**
  * adw_status_page_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  *
  * Gets the title for @self.
  *
@@ -448,7 +448,7 @@ adw_status_page_get_title (AdwStatusPage *self)
 
 /**
  * adw_status_page_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  * @title: the title
  *
  * Sets the title for @self.
@@ -471,7 +471,7 @@ adw_status_page_set_title (AdwStatusPage *self,
 
 /**
  * adw_status_page_get_description: (attributes org.gtk.Method.get_property=description)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  *
  * Gets the description for @self.
  *
@@ -489,7 +489,7 @@ adw_status_page_get_description (AdwStatusPage *self)
 
 /**
  * adw_status_page_set_description: (attributes org.gtk.Method.set_property=description)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  * @description: (nullable): the description
  *
  * Sets the description for @self.
@@ -512,7 +512,7 @@ adw_status_page_set_description (AdwStatusPage *self,
 
 /**
  * adw_status_page_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  *
  * Gets the child widget of @self.
  *
@@ -530,7 +530,7 @@ adw_status_page_get_child (AdwStatusPage *self)
 
 /**
  * adw_status_page_set_child: (attributes org.gtk.Method.set_property=child)
- * @self: a `AdwStatusPage`
+ * @self: a status page
  * @child: (nullable): the child widget
  *
  * Sets the child widget of @self.
diff --git a/src/adw-style-manager.c b/src/adw-style-manager.c
index 05cfc0f4..f0ba01df 100644
--- a/src/adw-style-manager.c
+++ b/src/adw-style-manager.c
@@ -587,7 +587,7 @@ adw_style_manager_get_for_display (GdkDisplay *display)
 
 /**
  * adw_style_manager_get_display: (attributes org.gtk.Method.get_property=display)
- * @self: a `AdwStyleManager`
+ * @self: a style manager
  *
  * Gets the display the style manager is associated with.
  *
@@ -608,7 +608,7 @@ adw_style_manager_get_display (AdwStyleManager *self)
 
 /**
  * adw_style_manager_get_color_scheme: (attributes org.gtk.Method.get_property=color-scheme)
- * @self: a `AdwStyleManager`
+ * @self: a style manager
  *
  * Gets the requested application color scheme.
  *
@@ -626,7 +626,7 @@ adw_style_manager_get_color_scheme (AdwStyleManager *self)
 
 /**
  * adw_style_manager_set_color_scheme: (attributes org.gtk.Method.set_property=color-scheme)
- * @self: a `AdwStyleManager`
+ * @self: a style manager
  * @color_scheme: the color scheme
  *
  * Sets the requested application color scheme.
@@ -671,7 +671,7 @@ adw_style_manager_set_color_scheme (AdwStyleManager *self,
 
 /**
  * adw_style_manager_get_system_supports_color_schemes: (attributes 
org.gtk.Method.get_property=system-supports-color-schemes)
- * @self: a `AdwStyleManager`
+ * @self: a style manager
  *
  * Gets whether the system supports color schemes.
  *
@@ -689,7 +689,7 @@ adw_style_manager_get_system_supports_color_schemes (AdwStyleManager *self)
 
 /**
  * adw_style_manager_get_dark: (attributes org.gtk.Method.get_property=dark)
- * @self: a `AdwStyleManager`
+ * @self: a style manager
  *
  * Gets whether the application is using dark appearance.
  *
@@ -707,7 +707,7 @@ adw_style_manager_get_dark (AdwStyleManager *self)
 
 /**
  * adw_style_manager_get_high_contrast: (attributes org.gtk.Method.get_property=high-contrast)
- * @self: a `AdwStyleManager`
+ * @self: a style manager
  *
  * Gets whether the application is using high contrast appearance.
  *
diff --git a/src/adw-swipe-tracker.c b/src/adw-swipe-tracker.c
index 9c557b92..2f90a000 100644
--- a/src/adw-swipe-tracker.c
+++ b/src/adw-swipe-tracker.c
@@ -1087,7 +1087,7 @@ adw_swipe_tracker_class_init (AdwSwipeTrackerClass *klass)
 
   /**
    * AdwSwipeTracker::prepare:
-   * @self: the `AdwSwipeTracker` instance
+   * @self: a swipe tracker
    * @direction: the direction of the swipe
    *
    * This signal is emitted when a possible swipe is detected.
@@ -1109,7 +1109,7 @@ adw_swipe_tracker_class_init (AdwSwipeTrackerClass *klass)
 
   /**
    * AdwSwipeTracker::begin-swipe:
-   * @self: the `AdwSwipeTracker` instance
+   * @self: a swipe tracker
    *
    * This signal is emitted right before a swipe will be started, after the
    * drag threshold has been passed.
@@ -1127,7 +1127,7 @@ adw_swipe_tracker_class_init (AdwSwipeTrackerClass *klass)
 
   /**
    * AdwSwipeTracker::update-swipe:
-   * @self: the `AdwSwipeTracker` instance
+   * @self: a swipe tracker
    * @progress: the current animation progress value
    *
    * This signal is emitted every time the progress value changes.
@@ -1146,7 +1146,7 @@ adw_swipe_tracker_class_init (AdwSwipeTrackerClass *klass)
 
   /**
    * AdwSwipeTracker::end-swipe:
-   * @self: the `AdwSwipeTracker` instance
+   * @self: a swipe tracker
    * @velocity: the velocity of the swipe
    * @to: the progress value to animate to
    *
@@ -1202,7 +1202,7 @@ adw_swipe_tracker_new (AdwSwipeable *swipeable)
 
 /**
  * adw_swipe_tracker_get_swipeable: (attributes org.gtk.Method.get_property=swipeable)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  *
  * Get the widget @self is attached to.
  *
@@ -1220,7 +1220,7 @@ adw_swipe_tracker_get_swipeable (AdwSwipeTracker *self)
 
 /**
  * adw_swipe_tracker_get_enabled: (attributes org.gtk.Method.get_property=enabled)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  *
  * Gets whether @self is enabled.
  *
@@ -1238,7 +1238,7 @@ adw_swipe_tracker_get_enabled (AdwSwipeTracker *self)
 
 /**
  * adw_swipe_tracker_set_enabled: (attributes org.gtk.Method.set_property=enabled)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  * @enabled: whether @self is enabled
  *
  * Sets whether @self is enabled.
@@ -1268,7 +1268,7 @@ adw_swipe_tracker_set_enabled (AdwSwipeTracker *self,
 
 /**
  * adw_swipe_tracker_get_reversed: (attributes org.gtk.Method.get_property=reversed)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  *
  * Gets whether @self is reversing the swipe direction.
  *
@@ -1286,7 +1286,7 @@ adw_swipe_tracker_get_reversed (AdwSwipeTracker *self)
 
 /**
  * adw_swipe_tracker_set_reversed: (attributes org.gtk.Method.set_property=reversed)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  * @reversed: whether to reverse the swipe direction
  *
  * Sets whether to reverse the swipe direction.
@@ -1310,7 +1310,7 @@ adw_swipe_tracker_set_reversed (AdwSwipeTracker *self,
 
 /**
  * adw_swipe_tracker_get_allow_mouse_drag: (attributes org.gtk.Method.get_property=allow-mouse-drag)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  *
  * Gets whether @self can be dragged with mouse pointer.
  *
@@ -1328,7 +1328,7 @@ adw_swipe_tracker_get_allow_mouse_drag (AdwSwipeTracker *self)
 
 /**
  * adw_swipe_tracker_set_allow_mouse_drag: (attributes org.gtk.Method.set_property=allow-mouse-drag)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  * @allow_mouse_drag: whether to allow mouse dragging
  *
  * Sets whether @self can be dragged with mouse pointer.
@@ -1355,7 +1355,7 @@ adw_swipe_tracker_set_allow_mouse_drag (AdwSwipeTracker *self,
 
 /**
  * adw_swipe_tracker_get_allow_long_swipes: (attributes org.gtk.Method.get_property=allow-long-swipes)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  *
  * Gets whether to allow swiping for more than one snap point at a time.
  *
@@ -1373,7 +1373,7 @@ adw_swipe_tracker_get_allow_long_swipes (AdwSwipeTracker *self)
 
 /**
  * adw_swipe_tracker_set_allow_long_swipes: (attributes org.gtk.Method.set_property=allow-long-swipes)
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  * @allow_long_swipes: whether to allow long swipes
  *
  * Sets whether to allow swiping for more than one snap point at a time.
@@ -1398,7 +1398,7 @@ adw_swipe_tracker_set_allow_long_swipes (AdwSwipeTracker *self,
 
 /**
  * adw_swipe_tracker_shift_position:
- * @self: a `AdwSwipeTracker`
+ * @self: a swipe tracker
  * @delta: the position delta
  *
  * Moves the current progress value by @delta.
diff --git a/src/adw-swipeable.c b/src/adw-swipeable.c
index 3137d7d5..be169f92 100644
--- a/src/adw-swipeable.c
+++ b/src/adw-swipeable.c
@@ -29,7 +29,7 @@ adw_swipeable_default_init (AdwSwipeableInterface *iface)
 
 /**
  * adw_swipeable_get_distance:
- * @self: a `AdwSwipeable`
+ * @self: a swipeable
  *
  * Gets the swipe distance of @self.
  *
@@ -54,7 +54,7 @@ adw_swipeable_get_distance (AdwSwipeable *self)
 
 /**
  * adw_swipeable_get_snap_points: (virtual get_snap_points)
- * @self: a `AdwSwipeable`
+ * @self: a swipeable
  * @n_snap_points: (out): location to return the number of the snap points
  *
  * Gets the snap points of @self.
@@ -82,7 +82,7 @@ adw_swipeable_get_snap_points (AdwSwipeable *self,
 
 /**
  * adw_swipeable_get_progress:
- * @self: a `AdwSwipeable`
+ * @self: a swipeable
  *
  * Gets the current progress of @self.
  *
@@ -105,7 +105,7 @@ adw_swipeable_get_progress (AdwSwipeable *self)
 
 /**
  * adw_swipeable_get_cancel_progress:
- * @self: a `AdwSwipeable`
+ * @self: a swipeable
  *
  * Gets the progress @self will snap back to after the gesture is canceled.
  *
@@ -128,7 +128,7 @@ adw_swipeable_get_cancel_progress (AdwSwipeable *self)
 
 /**
  * adw_swipeable_get_swipe_area:
- * @self: a `AdwSwipeable`
+ * @self: a swipeable
  * @navigation_direction: the direction of the swipe
  * @is_drag: whether the swipe is caused by a dragging gesture
  * @rect: (out): a pointer to a rectangle to store the swipe area
diff --git a/src/adw-tab-bar.c b/src/adw-tab-bar.c
index 703670af..3c05f38d 100644
--- a/src/adw-tab-bar.c
+++ b/src/adw-tab-bar.c
@@ -574,7 +574,7 @@ adw_tab_bar_class_init (AdwTabBarClass *klass)
 
   /**
    * AdwTabBar::extra-drag-drop:
-   * @self: a `AdwTabBar`
+   * @self: a tab bar
    * @page: the page matching the tab the content was dropped onto
    * @value: the `GValue` being dropped
    *
@@ -705,7 +705,7 @@ adw_tab_bar_new (void)
 
 /**
  * adw_tab_bar_get_view: (attributes org.gtk.Method.get_property=view)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets the tab view @self controls.
  *
@@ -723,7 +723,7 @@ adw_tab_bar_get_view (AdwTabBar *self)
 
 /**
  * adw_tab_bar_set_view: (attributes org.gtk.Method.set_property=view)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  * @view: (nullable): a tab view
  *
  * Sets the tab view @self controls.
@@ -801,7 +801,7 @@ adw_tab_bar_set_view (AdwTabBar  *self,
 
 /**
  * adw_tab_bar_get_start_action_widget: (attributes org.gtk.Method.get_property=start-action-widget)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets the widget shown before the tabs.
  *
@@ -819,7 +819,7 @@ adw_tab_bar_get_start_action_widget (AdwTabBar *self)
 
 /**
  * adw_tab_bar_set_start_action_widget: (attributes org.gtk.Method.set_property=start-action-widget)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  * @widget: (transfer none) (nullable): the widget to show before the tabs
  *
  * Sets the widget to show before the tabs.
@@ -848,7 +848,7 @@ adw_tab_bar_set_start_action_widget (AdwTabBar *self,
 
 /**
  * adw_tab_bar_get_end_action_widget: (attributes org.gtk.Method.get_property=end-action-widget)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets the widget shown after the tabs.
  *
@@ -866,7 +866,7 @@ adw_tab_bar_get_end_action_widget (AdwTabBar *self)
 
 /**
  * adw_tab_bar_set_end_action_widget: (attributes org.gtk.Method.set_property=end-action-widget)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  * @widget: (transfer none) (nullable): the widget to show after the tabs
  *
  * Sets the widget to show after the tabs.
@@ -895,7 +895,7 @@ adw_tab_bar_set_end_action_widget (AdwTabBar *self,
 
 /**
  * adw_tab_bar_get_autohide: (attributes org.gtk.Method.get_property=autohide)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets whether the tabs automatically hide.
  *
@@ -913,7 +913,7 @@ adw_tab_bar_get_autohide (AdwTabBar *self)
 
 /**
  * adw_tab_bar_set_autohide: (attributes org.gtk.Method.set_property=autohide)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  * @autohide: whether the tabs automatically hide
  *
  * Sets whether the tabs automatically hide.
@@ -940,7 +940,7 @@ adw_tab_bar_set_autohide (AdwTabBar *self,
 
 /**
  * adw_tab_bar_get_tabs_revealed: (attributes org.gtk.Method.get_property=tabs-revealed)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets whether the tabs are currently revealed.
  *
@@ -958,7 +958,7 @@ adw_tab_bar_get_tabs_revealed (AdwTabBar *self)
 
 /**
  * adw_tab_bar_get_expand_tabs: (attributes org.gtk.Method.get_property=expand-tabs)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets whether tabs expand to full width.
  *
@@ -976,7 +976,7 @@ adw_tab_bar_get_expand_tabs (AdwTabBar *self)
 
 /**
  * adw_tab_bar_set_expand_tabs: (attributes org.gtk.Method.set_property=expand-tabs)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  * @expand_tabs: whether to expand tabs
  *
  * Sets whether tabs expand to full width.
@@ -1001,7 +1001,7 @@ adw_tab_bar_set_expand_tabs (AdwTabBar *self,
 
 /**
  * adw_tab_bar_get_inverted: (attributes org.gtk.Method.get_property=inverted)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets whether tabs use inverted layout.
  *
@@ -1019,7 +1019,7 @@ adw_tab_bar_get_inverted (AdwTabBar *self)
 
 /**
  * adw_tab_bar_set_inverted: (attributes org.gtk.Method.set_property=inverted)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  * @inverted: whether tabs use inverted layout
  *
  * Sets whether tabs tabs use inverted layout.
@@ -1044,7 +1044,7 @@ adw_tab_bar_set_inverted (AdwTabBar *self,
 
 /**
  * adw_tab_bar_setup_extra_drop_target:
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  * @actions: the supported actions
  * @types: (nullable) (transfer none) (array length=n_types):
  *   all supported `GType`s that can be dropped
@@ -1079,7 +1079,7 @@ adw_tab_bar_setup_extra_drop_target (AdwTabBar     *self,
 
 /**
  * adw_tab_bar_get_is_overflowing: (attributes org.gtk.Method.get_property=is-overflowing)
- * @self: a `AdwTabBar`
+ * @self: a tab bar
  *
  * Gets whether @self is overflowing.
  *
diff --git a/src/adw-tab-view.c b/src/adw-tab-view.c
index b81beeba..26b64436 100644
--- a/src/adw-tab-view.c
+++ b/src/adw-tab-view.c
@@ -1536,7 +1536,7 @@ adw_tab_view_class_init (AdwTabViewClass *klass)
 
   /**
    * AdwTabView::page-attached:
-   * @self: a `AdwTabView`
+   * @self: a tab view
    * @page: a page of @self
    * @position: the position of the page, starting from 0
    *
@@ -1559,7 +1559,7 @@ adw_tab_view_class_init (AdwTabViewClass *klass)
 
   /**
    * AdwTabView::page-detached:
-   * @self: a `AdwTabView`
+   * @self: a tab view
    * @page: a page of @self
    * @position: the position of the removed page, starting from 0
    *
@@ -1587,7 +1587,7 @@ adw_tab_view_class_init (AdwTabViewClass *klass)
 
   /**
    * AdwTabView::page-reordered:
-   * @self: a `AdwTabView`
+   * @self: a tab view
    * @page: a page of @self
    * @position: the position @page was moved to, starting at 0
    *
@@ -1607,7 +1607,7 @@ adw_tab_view_class_init (AdwTabViewClass *klass)
 
   /**
    * AdwTabView::close-page:
-   * @self: a `AdwTabView`
+   * @self: a tab view
    * @page: a page of @self
    *
    * Emitted after [method@TabView.close_page] has been called for @page.
@@ -1652,7 +1652,7 @@ adw_tab_view_class_init (AdwTabViewClass *klass)
 
   /**
    * AdwTabView::setup-menu:
-   * @self: a `AdwTabView`
+   * @self: a tab view
    * @page: (nullable): a page of @self
    *
    * Emitted when a context menu is opened or closed for @page.
@@ -1676,7 +1676,7 @@ adw_tab_view_class_init (AdwTabViewClass *klass)
 
   /**
    * AdwTabView::create-window:
-   * @self: a `AdwTabView`
+   * @self: a tab view
    *
    * Emitted when a tab should be transferred into a new window.
    *
@@ -1701,7 +1701,7 @@ adw_tab_view_class_init (AdwTabViewClass *klass)
 
   /**
    * AdwTabView::indicator-activated:
-   * @self: a `AdwTabView`
+   * @self: a tab view
    * @page: a page of @self
    *
    * Emitted after the indicator icon on @page has been activated.
@@ -1782,7 +1782,7 @@ adw_tab_view_buildable_init (GtkBuildableIface *iface)
 
 /**
  * adw_tab_page_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets the child of @self.
  *
@@ -1800,7 +1800,7 @@ adw_tab_page_get_child (AdwTabPage *self)
 
 /**
  * adw_tab_page_get_parent: (attributes org.gtk.Method.get_property=parent)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets the parent page of @self.
  *
@@ -1818,7 +1818,7 @@ adw_tab_page_get_parent (AdwTabPage *self)
 
 /**
  * adw_tab_page_get_selected: (attributes org.gtk.Method.get_property=selected)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets whether @self is selected.
  *
@@ -1836,7 +1836,7 @@ adw_tab_page_get_selected (AdwTabPage *self)
 
 /**
  * adw_tab_page_get_pinned: (attributes org.gtk.Method.get_property=pinned)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets whether @self is pinned.
  *
@@ -1854,7 +1854,7 @@ adw_tab_page_get_pinned (AdwTabPage *self)
 
 /**
  * adw_tab_page_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets the title of @self.
  *
@@ -1872,7 +1872,7 @@ adw_tab_page_get_title (AdwTabPage *self)
 
 /**
  * adw_tab_page_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  * @title: the title of @self
  *
  * Sets the title of @self.
@@ -1896,7 +1896,7 @@ adw_tab_page_set_title (AdwTabPage *self,
 
 /**
  * adw_tab_page_get_tooltip: (attributes org.gtk.Method.get_property=tooltip)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets the tooltip of @self.
  *
@@ -1914,7 +1914,7 @@ adw_tab_page_get_tooltip (AdwTabPage *self)
 
 /**
  * adw_tab_page_set_tooltip: (attributes org.gtk.Method.set_property=tooltip)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  * @tooltip: the tooltip of @self
  *
  * Sets the tooltip of @self.
@@ -1938,7 +1938,7 @@ adw_tab_page_set_tooltip (AdwTabPage *self,
 
 /**
  * adw_tab_page_get_icon: (attributes org.gtk.Method.get_property=icon)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets the icon of @self.
  *
@@ -1956,7 +1956,7 @@ adw_tab_page_get_icon (AdwTabPage *self)
 
 /**
  * adw_tab_page_set_icon: (attributes org.gtk.Method.set_property=icon)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  * @icon: (nullable): the icon of @self
  *
  * Sets the icon of @self.
@@ -1980,7 +1980,7 @@ adw_tab_page_set_icon (AdwTabPage *self,
 
 /**
  * adw_tab_page_get_loading: (attributes org.gtk.Method.get_property=loading)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets whether @self is loading.
  *
@@ -1998,7 +1998,7 @@ adw_tab_page_get_loading (AdwTabPage *self)
 
 /**
  * adw_tab_page_set_loading: (attributes org.gtk.Method.set_property=loading)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  * @loading: whether @self is loading
  *
  * Sets wether @self is loading.
@@ -2023,7 +2023,7 @@ adw_tab_page_set_loading (AdwTabPage *self,
 
 /**
  * adw_tab_page_get_indicator_icon: (attributes org.gtk.Method.get_property=indicator-icon)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets the indicator icon of @self.
  *
@@ -2041,7 +2041,7 @@ adw_tab_page_get_indicator_icon (AdwTabPage *self)
 
 /**
  * adw_tab_page_set_indicator_icon: (attributes org.gtk.Method.set_property=indicator-icon)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  * @indicator_icon: (nullable): the indicator icon of @self
  *
  * Sets the indicator icon of @self.
@@ -2065,7 +2065,7 @@ adw_tab_page_set_indicator_icon (AdwTabPage *self,
 
 /**
  * adw_tab_page_get_indicator_activatable: (attributes org.gtk.Method.get_property=indicator-activatable)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  *
  * Gets whether the indicator of @self is activatable.
@@ -2084,7 +2084,7 @@ adw_tab_page_get_indicator_activatable (AdwTabPage *self)
 
 /**
  * adw_tab_page_set_indicator_activatable: (attributes org.gtk.Method.set_property=indicator-activatable)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  * @activatable: whether the indicator is activatable
  *
  * Sets whether the indicator of @self is activatable.
@@ -2109,7 +2109,7 @@ adw_tab_page_set_indicator_activatable (AdwTabPage *self,
 
 /**
  * adw_tab_page_get_needs_attention: (attributes org.gtk.Method.get_property=needs-attention)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  *
  * Gets whether @self needs attention.
  *
@@ -2127,7 +2127,7 @@ adw_tab_page_get_needs_attention (AdwTabPage *self)
 
 /**
  * adw_tab_page_set_needs_attention: (attributes org.gtk.Method.set_property=needs-attention)
- * @self: a `AdwTabPage`
+ * @self: a tab page
  * @needs_attention: whether @self needs attention
  *
  * Sets whether @self needs attention.
@@ -2167,7 +2167,7 @@ adw_tab_view_new (void)
 
 /**
  * adw_tab_view_get_n_pages: (attributes org.gtk.Method.get_property=n-pages)
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Gets the number of pages in @self.
  *
@@ -2185,7 +2185,7 @@ adw_tab_view_get_n_pages (AdwTabView *self)
 
 /**
  * adw_tab_view_get_n_pinned_pages: (attributes org.gtk.Method.get_property=n-pinned-pages)
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Gets the number of pinned pages in @self.
  *
@@ -2203,7 +2203,7 @@ adw_tab_view_get_n_pinned_pages (AdwTabView *self)
 
 /**
  * adw_tab_view_get_is_transferring_page: (attributes org.gtk.Method.get_property=is-transferring-page)
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Whether a page is being transferred.
  *
@@ -2221,7 +2221,7 @@ adw_tab_view_get_is_transferring_page (AdwTabView *self)
 
 /**
  * adw_tab_view_get_selected_page: (attributes org.gtk.Method.get_property=selected-page)
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Gets the currently selected page in @self.
  *
@@ -2239,7 +2239,7 @@ adw_tab_view_get_selected_page (AdwTabView *self)
 
 /**
  * adw_tab_view_set_selected_page: (attributes org.gtk.Method.set_property=selected-page)
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @selected_page: a page in @self
  *
  * Sets the currently selected page in @self.
@@ -2264,7 +2264,7 @@ adw_tab_view_set_selected_page (AdwTabView *self,
 
 /**
  * adw_tab_view_select_previous_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Selects the page before the currently selected page.
  *
@@ -2299,7 +2299,7 @@ adw_tab_view_select_previous_page (AdwTabView *self)
 
 /**
  * adw_tab_view_select_next_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Selects the page after the currently selected page.
  *
@@ -2392,7 +2392,7 @@ adw_tab_view_select_last_page (AdwTabView *self)
 
 /**
  * adw_tab_view_get_default_icon: (attributes org.gtk.Method.get_property=default-icon)
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Gets the default icon of @self.
  *
@@ -2410,7 +2410,7 @@ adw_tab_view_get_default_icon (AdwTabView *self)
 
 /**
  * adw_tab_view_set_default_icon: (attributes org.gtk.Method.set_property=default-icon)
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @default_icon: the default icon
  *
  * Sets the default page icon for @self.
@@ -2434,7 +2434,7 @@ adw_tab_view_set_default_icon (AdwTabView *self,
 
 /**
  * adw_tab_view_get_menu_model: (attributes org.gtk.Method.get_property=menu-model)
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Gets the tab context menu model for @self.
  *
@@ -2452,7 +2452,7 @@ adw_tab_view_get_menu_model (AdwTabView *self)
 
 /**
  * adw_tab_view_set_menu_model: (attributes org.gtk.Method.set_property=menu-model)
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @menu_model: (nullable): a menu model
  *
  * Sets the tab context menu model for @self.
@@ -2476,7 +2476,7 @@ adw_tab_view_set_menu_model (AdwTabView *self,
 
 /**
  * adw_tab_view_set_page_pinned:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  * @pinned: whether @page should be pinned
  *
@@ -2552,7 +2552,7 @@ adw_tab_view_set_page_pinned (AdwTabView *self,
 
 /**
  * adw_tab_view_get_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a child in @self
  *
  * Gets the [class@TabPage] object representing @child.
@@ -2583,7 +2583,7 @@ adw_tab_view_get_page (AdwTabView *self,
 
 /**
  * adw_tab_view_get_nth_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @position: the index of the page in @self, starting from 0
  *
  * Gets the [class@TabPage] representing the child at @position.
@@ -2611,7 +2611,7 @@ adw_tab_view_get_nth_page (AdwTabView *self,
 
 /**
  * adw_tab_view_get_page_position:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Finds the position of @page in @self, starting from 0.
@@ -2642,7 +2642,7 @@ adw_tab_view_get_page_position (AdwTabView *self,
 
 /**
  * adw_tab_view_add_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a widget to add
  * @parent: (nullable): a parent page for @child
  *
@@ -2696,7 +2696,7 @@ adw_tab_view_add_page (AdwTabView *self,
 
 /**
  * adw_tab_view_insert:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a widget to add
  * @position: the position to add @child at, starting from 0
  *
@@ -2724,7 +2724,7 @@ adw_tab_view_insert (AdwTabView *self,
 
 /**
  * adw_tab_view_prepend:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a widget to add
  *
  * Inserts @child as the first non-pinned page.
@@ -2745,7 +2745,7 @@ adw_tab_view_prepend (AdwTabView *self,
 
 /**
  * adw_tab_view_append:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a widget to add
  *
  * Inserts @child as the last non-pinned page.
@@ -2766,7 +2766,7 @@ adw_tab_view_append (AdwTabView *self,
 
 /**
  * adw_tab_view_insert_pinned:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a widget to add
  * @position: the position to add @child at, starting from 0
  *
@@ -2794,7 +2794,7 @@ adw_tab_view_insert_pinned (AdwTabView *self,
 
 /**
  * adw_tab_view_prepend_pinned:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a widget to add
  *
  * Inserts @child as the first pinned page.
@@ -2815,7 +2815,7 @@ adw_tab_view_prepend_pinned (AdwTabView *self,
 
 /**
  * adw_tab_view_append_pinned:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @child: a widget to add
  *
  * Inserts @child as the last pinned page.
@@ -2836,7 +2836,7 @@ adw_tab_view_append_pinned (AdwTabView *self,
 
 /**
  * adw_tab_view_close_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Requests to close @page.
@@ -2883,7 +2883,7 @@ adw_tab_view_close_page (AdwTabView *self,
 
 /**
  * adw_tab_view_close_page_finish:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  * @confirm: whether to confirm or deny closing @page
  *
@@ -2916,7 +2916,7 @@ adw_tab_view_close_page_finish (AdwTabView *self,
 
 /**
  * adw_tab_view_close_other_pages:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Requests to close all pages other than @page.
@@ -2945,7 +2945,7 @@ adw_tab_view_close_other_pages (AdwTabView *self,
 
 /**
  * adw_tab_view_close_pages_before:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Requests to close all pages before @page.
@@ -2973,7 +2973,7 @@ adw_tab_view_close_pages_before (AdwTabView *self,
 
 /**
  * adw_tab_view_close_pages_after:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Requests to close all pages after @page.
@@ -3001,7 +3001,7 @@ adw_tab_view_close_pages_after (AdwTabView *self,
 
 /**
  * adw_tab_view_reorder_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  * @position: the position to insert the page at, starting at 0
  *
@@ -3059,7 +3059,7 @@ adw_tab_view_reorder_page (AdwTabView *self,
 
 /**
  * adw_tab_view_reorder_backward:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Reorders @page to before its previous page if possible.
@@ -3092,7 +3092,7 @@ adw_tab_view_reorder_backward (AdwTabView *self,
 
 /**
  * adw_tab_view_reorder_forward:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Reorders @page to after its next page if possible.
@@ -3125,7 +3125,7 @@ adw_tab_view_reorder_forward (AdwTabView *self,
 
 /**
  * adw_tab_view_reorder_first:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Reorders @page to the first possible position.
@@ -3153,7 +3153,7 @@ adw_tab_view_reorder_first (AdwTabView *self,
 
 /**
  * adw_tab_view_reorder_last:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  *
  * Reorders @page to the last possible position.
@@ -3219,7 +3219,7 @@ adw_tab_view_attach_page (AdwTabView *self,
 
 /**
  * adw_tab_view_transfer_page:
- * @self: a `AdwTabView`
+ * @self: a tab view
  * @page: a page of @self
  * @other_view: the tab view to transfer the page to
  * @position: the position to insert the page at, starting at 0
@@ -3259,7 +3259,7 @@ adw_tab_view_transfer_page (AdwTabView *self,
 
 /**
  * adw_tab_view_get_pages: (attributes org.gtk.Method.get_property=pages)
- * @self: a `AdwTabView`
+ * @self: a tab view
  *
  * Returns a [iface@Gio.ListModel] that contains the pages of @self.
  *
diff --git a/src/adw-timed-animation.c b/src/adw-timed-animation.c
index 43d3816f..f476be98 100644
--- a/src/adw-timed-animation.c
+++ b/src/adw-timed-animation.c
@@ -390,7 +390,7 @@ adw_timed_animation_new (GtkWidget          *widget,
 
 /**
  * adw_timed_animation_get_value_from: (attributes org.gtk.Method.get_property=value-from)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  *
  * Gets the value @self will animate from.
  *
@@ -408,7 +408,7 @@ adw_timed_animation_get_value_from (AdwTimedAnimation *self)
 
 /**
  * adw_timed_animation_set_value_from: (attributes org.gtk.Method.set_property=value-from)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  * @value: the value to animate from
  *
  * Sets the value @self will animate from.
@@ -431,7 +431,7 @@ adw_timed_animation_set_value_from (AdwTimedAnimation *self,
 
 /**
  * adw_timed_animation_get_value_to: (attributes org.gtk.Method.get_property=value-to)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  *
  * Gets the value @self will animate to.
  *
@@ -449,7 +449,7 @@ adw_timed_animation_get_value_to (AdwTimedAnimation *self)
 
 /**
  * adw_timed_animation_set_value_to: (attributes org.gtk.Method.set_property=value-to)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  * @value: the value to animate to
  *
  * Sets the value @self will animate to.
@@ -472,7 +472,7 @@ adw_timed_animation_set_value_to (AdwTimedAnimation *self,
 
 /**
  * adw_timed_animation_get_duration: (attributes org.gtk.Method.get_property=duration)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  *
  * Gets the duration of @self in milliseconds.
  *
@@ -490,7 +490,7 @@ adw_timed_animation_get_duration (AdwTimedAnimation *self)
 
 /**
  * adw_timed_animation_set_duration: (attributes org.gtk.Method.set_property=duration)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  * @duration: the duration to use
  *
  * Sets the duration of @self in milliseconds.
@@ -515,7 +515,7 @@ adw_timed_animation_set_duration (AdwTimedAnimation *self,
 
 /**
  * adw_timed_animation_get_easing: (attributes org.gtk.Method.get_property=easing)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  *
  * Gets the easing function @self uses.
  *
@@ -534,7 +534,7 @@ adw_timed_animation_get_easing (AdwTimedAnimation *self)
 
 /**
  * adw_timed_animation_set_easing: (attributes org.gtk.Method.set_property=easing)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  * @easing: the easing function to use
  *
  * Sets the easing function @self will use.
@@ -560,7 +560,7 @@ adw_timed_animation_set_easing (AdwTimedAnimation *self,
 
 /**
  * adw_timed_animation_get_repeat_count: (attributes org.gtk.Method.get_property=repeat-count)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  *
  * Gets the number of times @self will play.
  *
@@ -578,7 +578,7 @@ adw_timed_animation_get_repeat_count (AdwTimedAnimation *self)
 
 /**
  * adw_timed_animation_set_repeat_count: (attributes org.gtk.Method.set_property=repeat-count)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  * @repeat_count: the number of times @self will play
  *
  * Sets the number of times @self will play.
@@ -603,7 +603,7 @@ adw_timed_animation_set_repeat_count (AdwTimedAnimation *self,
 
 /**
  * adw_timed_animation_get_reverse: (attributes org.gtk.Method.get_property=reverse)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  *
  * Gets whether @self plays backwards.
  *
@@ -621,7 +621,7 @@ adw_timed_animation_get_reverse (AdwTimedAnimation *self)
 
 /**
  * adw_timed_animation_set_reverse: (attributes org.gtk.Method.set_property=reverse)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  * @reverse: whether @self plays backwards
  *
  * Sets whether @self plays backwards.
@@ -644,7 +644,7 @@ adw_timed_animation_set_reverse (AdwTimedAnimation *self,
 
 /**
  * adw_timed_animation_get_alternate: (attributes org.gtk.Method.get_property=alternate)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  *
  * Gets whether @self changes direction on every iteration.
  *
@@ -662,7 +662,7 @@ adw_timed_animation_get_alternate (AdwTimedAnimation *self)
 
 /**
  * adw_timed_animation_set_alternate: (attributes org.gtk.Method.set_property=alternate)
- * @self: a `AdwAnimation`
+ * @self: a timed animation
  * @alternate: whether @self alternates
  *
  * Sets whether @self changes direction on every iteration.
diff --git a/src/adw-toast-overlay.c b/src/adw-toast-overlay.c
index d3b5e6d3..544caaa3 100644
--- a/src/adw-toast-overlay.c
+++ b/src/adw-toast-overlay.c
@@ -510,7 +510,7 @@ adw_toast_overlay_new (void)
 
 /**
  * adw_toast_overlay_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwToastOverlay`
+ * @self: a toast overlay
  *
  * Gets the child widget of @self.
  *
@@ -528,7 +528,7 @@ adw_toast_overlay_get_child (AdwToastOverlay *self)
 
 /**
  * adw_toast_overlay_set_child: (attributes org.gtk.Method.set_property=child)
- * @self: a `AdwToastOverlay`
+ * @self: a toast overlay
  * @child: (nullable): the child widget
  *
  * Sets the child widget of @self.
@@ -558,7 +558,7 @@ adw_toast_overlay_set_child (AdwToastOverlay *self,
 
 /**
  * adw_toast_overlay_add_toast:
- * @self: a `AdwToastOverlay`
+ * @self: a toast overlay
  * @toast: (transfer full): a toast
  *
  * Displays @toast.
diff --git a/src/adw-toast.c b/src/adw-toast.c
index b996507a..60e7bf5e 100644
--- a/src/adw-toast.c
+++ b/src/adw-toast.c
@@ -438,7 +438,7 @@ adw_toast_new (const char *title)
 
 /**
  * adw_toast_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwToast`
+ * @self: a toast
  *
  * Gets the title that will be displayed on the toast.
  *
@@ -456,7 +456,7 @@ adw_toast_get_title (AdwToast *self)
 
 /**
  * adw_toast_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwToast`
+ * @self: a toast
  * @title: a title
  *
  * Sets the title that will be displayed on the toast.
@@ -481,7 +481,7 @@ adw_toast_set_title (AdwToast   *self,
 
 /**
  * adw_toast_get_button_label: (attributes org.gtk.Method.get_property=button-label)
- * @self: a `AdwToast`
+ * @self: a toast
  *
  * Gets the label to show on the button.
  *
@@ -499,7 +499,7 @@ adw_toast_get_button_label (AdwToast *self)
 
 /**
  * adw_toast_set_button_label: (attributes org.gtk.Method.set_property=button-label)
- * @self: a `AdwToast`
+ * @self: a toast
  * @button_label: (nullable): a button label
  *
  * Sets the label to show on the button.
@@ -525,7 +525,7 @@ adw_toast_set_button_label (AdwToast   *self,
 
 /**
  * adw_toast_get_action_name: (attributes org.gtk.Method.get_property=action-name)
- * @self: a `AdwToast`
+ * @self: a toast
  *
  * Gets the name of the associated action.
  *
@@ -543,7 +543,7 @@ adw_toast_get_action_name (AdwToast *self)
 
 /**
  * adw_toast_set_action_name: (attributes org.gtk.Method.set_property=action-name)
- * @self: a `AdwToast`
+ * @self: a toast
  * @action_name: (nullable): the action name
  *
  * Sets the name of the associated action.
@@ -567,7 +567,7 @@ adw_toast_set_action_name (AdwToast   *self,
 
 /**
  * adw_toast_get_action_target_value: (attributes org.gtk.Method.get_property=action-target)
- * @self: a `AdwToast`
+ * @self: a toast
  *
  * Gets the parameter for action invocations.
  *
@@ -585,7 +585,7 @@ adw_toast_get_action_target_value (AdwToast *self)
 
 /**
  * adw_toast_set_action_target_value: (attributes org.gtk.Method.set_property=action-target)
- * @self: a `AdwToast`
+ * @self: a toast
  * @action_target: (nullable): the action target
  *
  * Sets the parameter for action invocations.
@@ -613,7 +613,7 @@ adw_toast_set_action_target_value (AdwToast *self,
 
 /**
  * adw_toast_set_action_target: (skip)
- * @self: a `AdwToast`
+ * @self: a toast
  * @format_string: (nullable): a [struct@GLib.Variant] format string
  * @...: arguments appropriate for @target_format
  *
@@ -645,7 +645,7 @@ adw_toast_set_action_target (AdwToast   *self,
 
 /**
  * adw_toast_set_detailed_action_name:
- * @self: a `AdwToast`
+ * @self: a toast
  * @detailed_action_name: (nullable): the detailed action name
  *
  * Sets the action name and its parameter.
@@ -686,7 +686,7 @@ adw_toast_set_detailed_action_name (AdwToast   *self,
 
 /**
  * adw_toast_get_priority: (attributes org.gtk.Method.get_property=priority)
- * @self: a `AdwToast`
+ * @self: a toast
  *
  * Gets priority for @self.
  *
@@ -704,7 +704,7 @@ adw_toast_get_priority (AdwToast *self)
 
 /**
  * adw_toast_set_priority: (attributes org.gtk.Method.set_property=priority)
- * @self: a `AdwToast`
+ * @self: a toast
  * @priority: the priority
  *
  * Sets priority for @self.
@@ -737,7 +737,7 @@ adw_toast_set_priority (AdwToast         *self,
 
 /**
  * adw_toast_get_timeout: (attributes org.gtk.Method.get_property=timeout)
- * @self: a `AdwToast`
+ * @self: a toast
  *
  * Gets timeout for @self.
  *
@@ -755,7 +755,7 @@ adw_toast_get_timeout (AdwToast *self)
 
 /**
  * adw_toast_set_timeout: (attributes org.gtk.Method.set_property=timeout)
- * @self: a `AdwToast`
+ * @self: a toast
  * @timeout: the timeout
  *
  * Sets timeout for @self.
@@ -784,7 +784,7 @@ adw_toast_set_timeout (AdwToast *self,
 
 /**
  * adw_toast_dismiss:
- * @self: a `AdwToast`
+ * @self: a toast
  *
  * Dismisses @self.
  *
diff --git a/src/adw-view-stack.c b/src/adw-view-stack.c
index 1d41ae9b..92a61166 100644
--- a/src/adw-view-stack.c
+++ b/src/adw-view-stack.c
@@ -1029,7 +1029,7 @@ adw_view_stack_buildable_init (GtkBuildableIface *iface)
 
 /**
  * adw_view_stack_page_get_child: (attributes org.gtk.Method.get_property=child)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets the stack child to which @self belongs.
  *
@@ -1047,7 +1047,7 @@ adw_view_stack_page_get_child (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_get_visible: (attributes org.gtk.Method.get_property=visible)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets whether @self is visible in its `AdwViewStack`.
  *
@@ -1068,7 +1068,7 @@ adw_view_stack_page_get_visible (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_set_visible: (attributes org.gtk.Method.set_property=visible)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  * @visible: whether @self is visible
  *
  * Sets whether @page is visible in its `AdwViewStack`.
@@ -1096,7 +1096,7 @@ adw_view_stack_page_set_visible (AdwViewStackPage *self,
 
 /**
  * adw_view_stack_page_get_needs_attention: (attributes org.gtk.Method.get_property=needs-attention)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets whether the page is marked as “needs attention”.
  *
@@ -1114,7 +1114,7 @@ adw_view_stack_page_get_needs_attention (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_set_needs_attention: (attributes org.gtk.Method.set_property=needs-attention)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  * @needs_attention: the new value to set
  *
  * Sets whether the page is marked as “needs attention”.
@@ -1139,7 +1139,7 @@ adw_view_stack_page_set_needs_attention (AdwViewStackPage *self,
 
 /**
  * adw_view_stack_page_get_badge_number: (attributes org.gtk.Method.get_property=badge-number)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets the badge number for this page.
  *
@@ -1157,7 +1157,7 @@ adw_view_stack_page_get_badge_number (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_set_badge_number: (attributes org.gtk.Method.set_property=badge-number)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  * @badge_number: the new value to set
  *
  * Sets the badge number for this page.
@@ -1180,7 +1180,7 @@ adw_view_stack_page_set_badge_number (AdwViewStackPage *self,
 
 /**
  * adw_view_stack_page_get_use_underline: (attributes org.gtk.Method.get_property=use-underline)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets whether underlines in the page title indicate mnemonics.
  *
@@ -1196,7 +1196,7 @@ adw_view_stack_page_get_use_underline (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_set_use_underline: (attributes org.gtk.Method.set_property=use-underline)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  * @use_underline: the new value to set
  *
  * Sets whether underlines in the page title indicate mnemonics.
@@ -1219,7 +1219,7 @@ adw_view_stack_page_set_use_underline (AdwViewStackPage *self,
 
 /**
  * adw_view_stack_page_get_name: (attributes org.gtk.Method.get_property=name)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets the name of the page.
  *
@@ -1237,7 +1237,7 @@ adw_view_stack_page_get_name (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_set_name: (attributes org.gtk.Method.set_property=name)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  * @name: (nullable): the page name
  *
  * Sets the name of the page.
@@ -1287,7 +1287,7 @@ adw_view_stack_page_set_name (AdwViewStackPage *self,
 
 /**
  * adw_view_stack_page_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets the page title.
  *
@@ -1305,7 +1305,7 @@ adw_view_stack_page_get_title (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  * @title: (nullable): the page title
  *
  * Sets the page title.
@@ -1329,7 +1329,7 @@ adw_view_stack_page_set_title (AdwViewStackPage *self,
 
 /**
  * adw_view_stack_page_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  *
  * Gets the icon name of the page.
  *
@@ -1347,7 +1347,7 @@ adw_view_stack_page_get_icon_name (AdwViewStackPage *self)
 
 /**
  * adw_view_stack_page_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwViewStackPage`
+ * @self: a view stack page
  * @icon_name: (nullable): the icon name
  *
  * Sets the icon name of the page.
@@ -1386,7 +1386,7 @@ adw_view_stack_new (void)
 
 /**
  * adw_view_stack_add:
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @child: the widget to add
  *
  * Adds a child to @self.
@@ -1407,7 +1407,7 @@ adw_view_stack_add (AdwViewStack   *self,
 
 /**
  * adw_view_stack_add_named:
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @child: the widget to add
  * @name: (nullable): the name for @child
  *
@@ -1432,7 +1432,7 @@ adw_view_stack_add_named (AdwViewStack   *self,
 
 /**
  * adw_view_stack_add_titled:
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @child: the widget to add
  * @name: (nullable): the name for @child
  * @title: a human-readable title for @child
@@ -1460,7 +1460,7 @@ adw_view_stack_add_titled (AdwViewStack   *self,
 
 /**
  * adw_view_stack_remove:
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @child: the child to remove
  *
  * Removes a child widget from @self.
@@ -1493,7 +1493,7 @@ adw_view_stack_remove (AdwViewStack  *self,
 
 /**
  * adw_view_stack_get_page:
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @child: a child of @self
  *
  * Gets the [class@ViewStackPage] object for @child.
@@ -1514,7 +1514,7 @@ adw_view_stack_get_page (AdwViewStack  *self,
 
 /**
  * adw_view_stack_get_child_by_name:
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @name: the name of the child to find
  *
  * Finds the child with @name in @self.
@@ -1539,7 +1539,7 @@ adw_view_stack_get_child_by_name (AdwViewStack *self,
 
 /**
  * adw_view_stack_get_visible_child: (attributes org.gtk.Method.get_property=visible-child)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  *
  * Gets the currently visible child of @self, .
  *
@@ -1557,7 +1557,7 @@ adw_view_stack_get_visible_child (AdwViewStack *self)
 
 /**
  * adw_view_stack_set_visible_child: (attributes org.gtk.Method.set_property=visible-child)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @child: a child of @self
  *
  * Makes @child the visible child of @self.
@@ -1587,7 +1587,7 @@ adw_view_stack_set_visible_child (AdwViewStack *self,
 
 /**
  * adw_view_stack_get_visible_child_name: (attributes org.gtk.Method.get_property=visible-child-name)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  *
  * Returns the name of the currently visible child of @self.
  *
@@ -1605,7 +1605,7 @@ adw_view_stack_get_visible_child_name (AdwViewStack *self)
 
 /**
  * adw_view_stack_set_visible_child_name: (attributes org.gtk.Method.set_property=visible-child-name)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @name: the name of the child
  *
  * Makes the child with @name visible.
@@ -1637,7 +1637,7 @@ adw_view_stack_set_visible_child_name (AdwViewStack *self,
 
 /**
  * adw_view_stack_set_hhomogeneous: (attributes org.gtk.Method.set_property=hhomogeneous)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @hhomogeneous: whether to make @self horizontally homogeneous
  *
  * Sets @self to be horizontally homogeneous or not.
@@ -1665,7 +1665,7 @@ adw_view_stack_set_hhomogeneous (AdwViewStack *self,
 
 /**
  * adw_view_stack_get_hhomogeneous: (attributes org.gtk.Method.get_property=hhomogeneous)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  *
  * Gets whether @self is horizontally homogeneous.
  *
@@ -1683,7 +1683,7 @@ adw_view_stack_get_hhomogeneous (AdwViewStack *self)
 
 /**
  * adw_view_stack_set_vhomogeneous: (attributes org.gtk.Method.set_property=vhomogeneous)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  * @vhomogeneous: whether to make @self vertically homogeneous
  *
  * Sets @self to be vertically homogeneous or not.
@@ -1711,7 +1711,7 @@ adw_view_stack_set_vhomogeneous (AdwViewStack *self,
 
 /**
  * adw_view_stack_get_vhomogeneous: (attributes org.gtk.Method.get_property=vhomogeneous)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  *
  * Gets whether @self is vertically homogeneous.
  *
@@ -1729,7 +1729,7 @@ adw_view_stack_get_vhomogeneous (AdwViewStack *self)
 
 /**
  * adw_view_stack_get_pages: (attributes org.gtk.Method.get_property=pages)
- * @self: a `AdwViewStack`
+ * @self: a view stack
  *
  * Returns a [iface@Gio.ListModel] that contains the pages of the stack.
  *
diff --git a/src/adw-view-switcher-bar.c b/src/adw-view-switcher-bar.c
index c3f62248..15e43d14 100644
--- a/src/adw-view-switcher-bar.c
+++ b/src/adw-view-switcher-bar.c
@@ -244,7 +244,7 @@ adw_view_switcher_bar_new (void)
 
 /**
  * adw_view_switcher_bar_get_stack: (attributes org.gtk.Method.get_property=stack)
- * @self: a `AdwViewSwitcherBar`
+ * @self: a view switcher bar
  *
  * Gets the stack controlled by @self.
  *
@@ -262,7 +262,7 @@ adw_view_switcher_bar_get_stack (AdwViewSwitcherBar *self)
 
 /**
  * adw_view_switcher_bar_set_stack: (attributes org.gtk.Method.set_property=stack)
- * @self: a `AdwViewSwitcherBar`
+ * @self: a view switcher bar
  * @stack: (nullable): a stack
  *
  * Sets the stack controlled by @self.
@@ -303,7 +303,7 @@ adw_view_switcher_bar_set_stack (AdwViewSwitcherBar *self,
 
 /**
  * adw_view_switcher_bar_get_reveal: (attributes org.gtk.Method.get_property=reveal)
- * @self: a `AdwViewSwitcherBar`
+ * @self: a view switcher bar
  *
  * Gets whether @self should be revealed or hidden.
  *
@@ -321,7 +321,7 @@ adw_view_switcher_bar_get_reveal (AdwViewSwitcherBar *self)
 
 /**
  * adw_view_switcher_bar_set_reveal: (attributes org.gtk.Method.set_property=reveal)
- * @self: a `AdwViewSwitcherBar`
+ * @self: a view switcher bar
  * @reveal: whether to reveal @self
  *
  * Sets whether @self should be revealed or hidden.
diff --git a/src/adw-view-switcher-button.c b/src/adw-view-switcher-button.c
index 3d518a6b..211f27ee 100644
--- a/src/adw-view-switcher-button.c
+++ b/src/adw-view-switcher-button.c
@@ -380,7 +380,7 @@ adw_view_switcher_button_new (void)
 
 /**
  * adw_view_switcher_button_get_icon_name: (attributes org.gtk.Method.get_property=icon-name)
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  *
  * Gets the icon name representing the view.
  *
@@ -398,7 +398,7 @@ adw_view_switcher_button_get_icon_name (AdwViewSwitcherButton *self)
 
 /**
  * adw_view_switcher_button_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  * @icon_name: (nullable): an icon name
  *
  * Sets the icon name representing the view.
@@ -426,7 +426,7 @@ adw_view_switcher_button_set_icon_name (AdwViewSwitcherButton *self,
 
 /**
  * adw_view_switcher_button_get_needs_attention: (attributes org.gtk.Method.get_property=needs-attention)
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  *
  * Gets whether the view represented by @self requires the user attention.
  *
@@ -444,7 +444,7 @@ adw_view_switcher_button_get_needs_attention (AdwViewSwitcherButton *self)
 
 /**
  * adw_view_switcher_button_set_needs_attention: (attributes org.gtk.Method.set_property=needs-attention)
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  * @needs_attention: whether the view needs attention
  *
  * Sets whether the view represented by @self requires the user attention.
@@ -469,7 +469,7 @@ adw_view_switcher_button_set_needs_attention (AdwViewSwitcherButton *self,
 
 /**
  * adw_view_switcher_button_get_badge_number:
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  *
  * Gets the badge number.
  *
@@ -487,7 +487,7 @@ adw_view_switcher_button_get_badge_number (AdwViewSwitcherButton *self)
 
 /**
  * adw_view_switcher_button_set_badge_number:
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  * @badge_number: the new value
  *
  * Sets the badge number.
@@ -510,7 +510,7 @@ adw_view_switcher_button_set_badge_number (AdwViewSwitcherButton *self,
 
 /**
  * adw_view_switcher_button_get_label:
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  *
  * Gets the label representing the view.
  *
@@ -528,7 +528,7 @@ adw_view_switcher_button_get_label (AdwViewSwitcherButton *self)
 
 /**
  * adw_view_switcher_button_set_label:
- * @self: a `AdwViewSwitcherButton`
+ * @self: a view switcher button
  * @label: (nullable): a label
  *
  * Sets the label representing the view.
diff --git a/src/adw-view-switcher-title.c b/src/adw-view-switcher-title.c
index 88df0517..a2178c98 100644
--- a/src/adw-view-switcher-title.c
+++ b/src/adw-view-switcher-title.c
@@ -401,7 +401,7 @@ adw_view_switcher_title_new (void)
 
 /**
  * adw_view_switcher_title_get_stack: (attributes org.gtk.Method.get_property=stack)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  *
  * Gets the stack controlled by @self.
  *
@@ -419,7 +419,7 @@ adw_view_switcher_title_get_stack (AdwViewSwitcherTitle *self)
 
 /**
  * adw_view_switcher_title_set_stack: (attributes org.gtk.Method.set_property=stack)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  * @stack: (nullable): a stack
  *
  * Sets the stack controlled by @self.
@@ -461,7 +461,7 @@ adw_view_switcher_title_set_stack (AdwViewSwitcherTitle *self,
 
 /**
  * adw_view_switcher_title_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  *
  * Gets the title of @self.
  *
@@ -479,7 +479,7 @@ adw_view_switcher_title_get_title (AdwViewSwitcherTitle *self)
 
 /**
  * adw_view_switcher_title_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  * @title: a title
  *
  * Sets the title of @self.
@@ -502,7 +502,7 @@ adw_view_switcher_title_set_title (AdwViewSwitcherTitle *self,
 
 /**
  * adw_view_switcher_title_get_subtitle: (attributes org.gtk.Method.get_property=subtitle)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  *
  * Gets the subtitle of @self.
  *
@@ -520,7 +520,7 @@ adw_view_switcher_title_get_subtitle (AdwViewSwitcherTitle *self)
 
 /**
  * adw_view_switcher_title_set_subtitle: (attributes org.gtk.Method.set_property=subtitle)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  * @subtitle: a subtitle
  *
  * Sets the subtitle of @self.
@@ -543,7 +543,7 @@ adw_view_switcher_title_set_subtitle (AdwViewSwitcherTitle *self,
 
 /**
  * adw_view_switcher_title_get_view_switcher_enabled: (attributes 
org.gtk.Method.get_property=view-switcher-enabled)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  *
  * Gets whether @self's view switcher is enabled.
  *
@@ -561,7 +561,7 @@ adw_view_switcher_title_get_view_switcher_enabled (AdwViewSwitcherTitle *self)
 
 /**
  * adw_view_switcher_title_set_view_switcher_enabled: (attributes 
org.gtk.Method.set_property=view-switcher-enabled)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  * @enabled: whether the view switcher is enabled
  *
  * Sets whether @self's view switcher is enabled.
@@ -587,7 +587,7 @@ adw_view_switcher_title_set_view_switcher_enabled (AdwViewSwitcherTitle *self,
 
 /**
  * adw_view_switcher_title_get_title_visible: (attributes org.gtk.Method.get_property=title-visible)
- * @self: a `AdwViewSwitcherTitle`
+ * @self: a view switcher title
  *
  * Gets whether the title of @self is currently visible.
  *
diff --git a/src/adw-view-switcher.c b/src/adw-view-switcher.c
index 14812d80..27cbbab1 100644
--- a/src/adw-view-switcher.c
+++ b/src/adw-view-switcher.c
@@ -414,7 +414,7 @@ adw_view_switcher_new (void)
 
 /**
  * adw_view_switcher_get_policy: (attributes org.gtk.Method.get_property=policy)
- * @self: a `AdwViewSwitcher`
+ * @self: a view switcher
  *
  * Gets the policy of @self.
  *
@@ -432,7 +432,7 @@ adw_view_switcher_get_policy (AdwViewSwitcher *self)
 
 /**
  * adw_view_switcher_set_policy: (attributes org.gtk.Method.set_property=policy)
- * @self: a `AdwViewSwitcher`
+ * @self: a view switcher
  * @policy: the new policy
  *
  * Sets the policy of @self.
@@ -473,7 +473,7 @@ adw_view_switcher_set_policy (AdwViewSwitcher       *self,
 
 /**
  * adw_view_switcher_get_stack: (attributes org.gtk.Method.get_property=stack)
- * @self: a `AdwViewSwitcher`
+ * @self: a view switcher
  *
  * Gets the stack controlled by @self.
  *
@@ -491,7 +491,7 @@ adw_view_switcher_get_stack (AdwViewSwitcher *self)
 
 /**
  * adw_view_switcher_set_stack: (attributes org.gtk.Method.set_property=stack)
- * @self: a `AdwViewSwitcher`
+ * @self: a view switcher
  * @stack: (nullable): a stack
  *
  * Sets the stack controlled by @self.
diff --git a/src/adw-window-title.c b/src/adw-window-title.c
index b236ccc2..8eefc507 100644
--- a/src/adw-window-title.c
+++ b/src/adw-window-title.c
@@ -186,7 +186,7 @@ adw_window_title_new (const char *title,
 
 /**
  * adw_window_title_get_title: (attributes org.gtk.Method.get_property=title)
- * @self: a `AdwWindowTitle`
+ * @self: a window title
  *
  * Gets the title of @self.
  *
@@ -204,7 +204,7 @@ adw_window_title_get_title (AdwWindowTitle *self)
 
 /**
  * adw_window_title_set_title: (attributes org.gtk.Method.set_property=title)
- * @self: a `AdwWindowTitle`
+ * @self: a window title
  * @title: a title
  *
  * Sets the title of @self.
@@ -229,7 +229,7 @@ adw_window_title_set_title (AdwWindowTitle *self,
 
 /**
  * adw_window_title_get_subtitle: (attributes org.gtk.Method.get_property=subtitle)
- * @self: a `AdwWindowTitle`
+ * @self: a window title
  *
  * Gets the subtitle of @self.
  *
@@ -247,7 +247,7 @@ adw_window_title_get_subtitle (AdwWindowTitle *self)
 
 /**
  * adw_window_title_set_subtitle: (attributes org.gtk.Method.set_property=subtitle)
- * @self: a `AdwWindowTitle`
+ * @self: a window title
  * @subtitle: a subtitle
  *
  * Sets the subtitle of @self.
diff --git a/src/adw-window.c b/src/adw-window.c
index 5bb08d30..ec49b751 100644
--- a/src/adw-window.c
+++ b/src/adw-window.c
@@ -200,7 +200,7 @@ adw_window_new (void)
 
 /**
  * adw_window_set_content: (attributes org.gtk.Method.set_property=content)
- * @self: a `AdwWindow`
+ * @self: a window
  * @content: (nullable): the content widget
  *
  * Sets the content widget of @self.
@@ -223,7 +223,7 @@ adw_window_set_content (AdwWindow *self,
 
 /**
  * adw_window_get_content: (attributes org.gtk.Method.get_property=content)
- * @self: a `AdwWindow`
+ * @self: a window
  *
  * Gets the content widget of @self.
  *


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]