[libadwaita] docs: Fix misc errors

[Alexander Mikhaylenko <alexm src gnome org>]

commit 7d3cd0220d7a8011037adf7015de45c23ac24c95
Author: Maximiliano Sandoval R <msandova gnome org>
Date:   Thu Feb 3 14:09:17 2022 +0100

    docs: Fix misc errors

 src/adw-clamp-layout.c       | 6 ++++--
 src/adw-header-bar.c         | 6 +++---
 src/adw-leaflet.c            | 2 ++
 src/adw-preferences-window.c | 2 --
 src/adw-toast.c              | 2 +-
 5 files changed, 10 insertions(+), 8 deletions(-)
---
diff --git a/src/adw-clamp-layout.c b/src/adw-clamp-layout.c
index 5ffa64b2..16e87251 100644
--- a/src/adw-clamp-layout.c
+++ b/src/adw-clamp-layout.c
@@ -345,8 +345,10 @@ adw_clamp_layout_class_init (AdwClampLayoutClass *klass)
   /**
    * AdwClampLayout:maximum-size: (attributes org.gtk.Property.get=adw_clamp_layout_get_maximum_size 
org.gtk.Property.set=adw_clamp_layout_set_maximum_size)
    *
-   * The maximum size to allocate to the children. It is the width if the
-   * layout is horizontal, or the height if it is vertical.
+   * The maximum size to allocate to the children.
+   *
+   * It is the width if the layout is horizontal, or the height if it is
+   * vertical.
    *
    * Since: 1.0
    */
diff --git a/src/adw-header-bar.c b/src/adw-header-bar.c
index b53cdf34..b50514df 100644
--- a/src/adw-header-bar.c
+++ b/src/adw-header-bar.c
@@ -459,12 +459,12 @@ adw_header_bar_class_init (AdwHeaderBarClass *class)
    *
    * The decoration layout for buttons.
    *
-   * Ithis property is not set, the
+   * If this property is not set, the
    * [property@Gtk.Settings:gtk-decoration-layout] setting is used.
    *
    * The format of the string is button names, separated by commas. A colon
    * separates the buttons that should appear at the start from those at the
-   * ebd. Recognized button names are minimize, maximize, close and icon (the
+   * end. Recognized button names are minimize, maximize, close and icon (the
    * window icon).
    *
    * For example, “icon:minimize,maximize,close” specifies an icon at the start,
@@ -812,7 +812,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 header bar
- * @layout: (nullable): a decoration layout, or `NULL` to unset the layout
+ * @layout: (nullable): a decoration layout
  *
  * Sets the decoration layout for @self.
  *
diff --git a/src/adw-leaflet.c b/src/adw-leaflet.c
index eea8886a..989557f1 100644
--- a/src/adw-leaflet.c
+++ b/src/adw-leaflet.c
@@ -3044,6 +3044,8 @@ adw_leaflet_get_folded (AdwLeaflet *self)
  *
  * Gets whether @self is homogeneous.
  *
+ * Returns: whether @self is homogeneous
+ *
  * Since: 1.0
  */
 gboolean
diff --git a/src/adw-preferences-window.c b/src/adw-preferences-window.c
index d9308d0f..0a8bba78 100644
--- a/src/adw-preferences-window.c
+++ b/src/adw-preferences-window.c
@@ -861,8 +861,6 @@ adw_preferences_window_present_subpage (AdwPreferencesWindow *self,
  *
  * If there is no presented subpage, this does nothing.
  *
- * See [method@PreferencesWindow.close_subpage].
- *
  * Since: 1.0
  */
 void
diff --git a/src/adw-toast.c b/src/adw-toast.c
index 60e7bf5e..e05d940b 100644
--- a/src/adw-toast.c
+++ b/src/adw-toast.c
@@ -614,7 +614,7 @@ adw_toast_set_action_target_value (AdwToast *self,
 /**
  * adw_toast_set_action_target: (skip)
  * @self: a toast
- * @format_string: (nullable): a [struct@GLib.Variant] format string
+ * @format_string: (nullable): a variant format string
  * @...: arguments appropriate for @target_format
  *
  * Sets the parameter for action invocations.