[gtksourceview] docs: fix various gi-docgen warnings

[Christian Hergert <chergert src gnome org>]

commit aea805e028be7c48fa85afd8566f063d288fca6c
Author: Christian Hergert <chergert redhat com>
Date:   Wed Dec 1 16:06:14 2021 -0800

    docs: fix various gi-docgen warnings

 docs/lang-reference.md                        |  2 +-
 docs/porting-guide-4-to-5.md                  |  4 ++--
 gtksourceview/gtksourcecompletioncontext.c    |  6 ++---
 gtksourceview/gtksourcefile.c                 |  4 ++--
 gtksourceview/gtksourcefileloader.c           | 14 ++++++------
 gtksourceview/gtksourcefilesaver.c            | 10 ++++-----
 gtksourceview/gtksourcegutter.c               |  2 +-
 gtksourceview/gtksourcegutterlines.c          |  8 +++----
 gtksourceview/gtksourcegutterrendererpixbuf.c |  2 +-
 gtksourceview/gtksourcehovercontext.c         |  2 +-
 gtksourceview/gtksourceindenter.c             |  8 +++----
 gtksourceview/gtksourcemap.c                  |  4 ++--
 gtksourceview/gtksourcemarkattributes.c       | 24 ++++++++++----------
 gtksourceview/gtksourcesearchcontext.c        | 32 +++++++++++++--------------
 gtksourceview/gtksourcespacedrawer.c          | 20 ++++++++---------
 gtksourceview/gtksourcevimimcontext.c         | 12 +++++-----
 16 files changed, 77 insertions(+), 77 deletions(-)
---
diff --git a/docs/lang-reference.md b/docs/lang-reference.md
index 25b6fe6b..45487266 100644
--- a/docs/lang-reference.md
+++ b/docs/lang-reference.md
@@ -254,7 +254,7 @@ Contained elements:
 
 ## Tag `<define-regex>`
 
-The syntax highlighting engine of GtkSourceView uses [class@GLib.Regex],
+The syntax highlighting engine of GtkSourceView uses [struct@GLib.Regex],
 which uses the PCRE library. See the [Regular expression 
syntax](https://developer.gnome.org/glib/stable/glib-regex-syntax.html)
 page in the GLib reference manual.
 
diff --git a/docs/porting-guide-4-to-5.md b/docs/porting-guide-4-to-5.md
index 1cb842c1..cddbb0b6 100644
--- a/docs/porting-guide-4-to-5.md
+++ b/docs/porting-guide-4-to-5.md
@@ -45,7 +45,7 @@ has allowed for much reduction in overhead when generating results and
 presenting them to the user. Additionally, it has improved Wayland support
 for placing completion results.
 
-[class@CompletionProposal] no longer requires any implementation except
+[iface@CompletionProposal] no longer requires any implementation except
 to implement the interface symbolically. That can be done using
 `G_IMPLEMENT_INTERFACE(GTK_SOURCE_TYPE_COMPLETION_PROPOSAL,NULL)`.
 This allowed all of the implementation details to be placed in
@@ -56,7 +56,7 @@ in multiple places as a generic container for information about completion
 proposals.
 
 [iface@CompletionProvider]s are now expected to asynchronously
-provide a [iface@Gio.ListModel] of [class@CompletionProposal]
+provide a [iface@Gio.ListModel] of [iface@CompletionProposal]
 instead of a `GList`. Refiltering of results can be provided using
 the refilter method and should be updated while the user types further. If a
 new model must be generated, use [method@CompletionContext.set_proposals_for_provider].
diff --git a/gtksourceview/gtksourcecompletioncontext.c b/gtksourceview/gtksourcecompletioncontext.c
index 86adb9a1..88dd9333 100644
--- a/gtksourceview/gtksourcecompletioncontext.c
+++ b/gtksourceview/gtksourcecompletioncontext.c
@@ -46,7 +46,7 @@
  * results which might be useful to the user.
  *
  * [iface@CompletionProvider] are expected to provide [iface@Gio.ListModel] with
- * [class@CompletionProposal] which may be joined together in a list of
+ * [iface@CompletionProposal] which may be joined together in a list of
  * results for the user. They are also responsible for how the contents are
  * displayed using [class@CompletionCell] which allows for some level of
  * customization.
@@ -596,8 +596,8 @@ gtk_source_completion_context_items_changed_cb (GtkSourceCompletionContext *self
  * @results: (nullable): a #GListModel or %NULL
  *
  * This function allows providers to update their results for a context
- * outside of a call to [method@CompletionProvider.populate_async]. 
- * 
+ * outside of a call to [method@CompletionProvider.populate_async].
+ *
  * This can be used to immediately return results for a provider while it does
  * additional asynchronous work. Doing so will allow the completions to
  * update while the operation is in progress.
diff --git a/gtksourceview/gtksourcefile.c b/gtksourceview/gtksourcefile.c
index e3dd6101..f865e99d 100644
--- a/gtksourceview/gtksourcefile.c
+++ b/gtksourceview/gtksourcefile.c
@@ -25,7 +25,7 @@
 
 /**
  * GtkSourceFile:
- * 
+ *
  * On-disk representation of a [class@Buffer].
  *
  * A `GtkSourceFile` object is the on-disk representation of a [class@Buffer].
@@ -402,7 +402,7 @@ gtk_source_file_get_compression_type (GtkSourceFile *file)
  *   longer needed, or %NULL.
  *
  * Sets a [callback@MountOperationFactory] function that will be called when a
- * [class@Gio.MountOperation] must be created. 
+ * [class@Gio.MountOperation] must be created.
  *
  * This is useful for creating a [class@Gtk.MountOperation] with the parent [class@Gtk.Window].
  *
diff --git a/gtksourceview/gtksourcefileloader.c b/gtksourceview/gtksourcefileloader.c
index 97fc4607..a2b41e2b 100644
--- a/gtksourceview/gtksourcefileloader.c
+++ b/gtksourceview/gtksourcefileloader.c
@@ -34,10 +34,10 @@
 
 /**
  * GtkSourceFileLoader:
- * 
+ *
  * Load a file into a GtkSourceBuffer.
  *
- * A `GtkSourceFileLoader` object permits to load the contents of a [class Gio File] or a
+ * A `GtkSourceFileLoader` object permits to load the contents of a [iface Gio File] or a
  * [class@Gio.InputStream] into a [class@Buffer].
  *
  * A file loader should be used only for one load operation, including errors
@@ -48,7 +48,7 @@
  * [class@Buffer].
  *
  * After a file loading, the buffer is reset to the contents provided by the
- * [class Gio File] or [class@Gio.InputStream], so the buffer is set as “unmodified”, that is,
+ * [iface Gio File] or [class@Gio.InputStream], so the buffer is set as “unmodified”, that is,
  * [method@Gtk.TextBuffer.set_modified] is called with %FALSE. If the contents isn't
  * saved somewhere (for example if you load from stdin), then you should
  * probably call [method@Gtk.TextBuffer.set_modified] with %TRUE after calling
@@ -901,9 +901,9 @@ gtk_source_file_loader_error_quark (void)
  * @file: the #GtkSourceFile.
  *
  * Creates a new `GtkSourceFileLoader` object. The contents is read from the
- * [class@File]'s location. 
+ * [class@File]'s location.
  *
- * If not already done, call [method@File.set_location] before calling this constructor. 
+ * If not already done, call [method@File.set_location] before calling this constructor.
  * The previous location is anyway not needed, because as soon as the file loading begins,
  * the @buffer is emptied.
  *
@@ -954,7 +954,7 @@ gtk_source_file_loader_new_from_stream (GtkSourceBuffer *buffer,
  * @candidate_encodings: (element-type GtkSourceEncoding): a list of
  *   #GtkSourceEncoding<!-- -->s.
  *
- * Sets the candidate encodings for the file loading. 
+ * Sets the candidate encodings for the file loading.
  *
  * The encodings are tried in the same order as the list.
  *
@@ -1056,7 +1056,7 @@ gtk_source_file_loader_get_input_stream (GtkSourceFileLoader *loader)
  *   satisfied.
  * @user_data: user data to pass to @callback.
  *
- * Loads asynchronously the file or input stream contents into the [class@Buffer]. 
+ * Loads asynchronously the file or input stream contents into the [class@Buffer].
  *
  * See the [iface@Gio.AsyncResult] documentation to know how to use this
  * function.
diff --git a/gtksourceview/gtksourcefilesaver.c b/gtksourceview/gtksourcefilesaver.c
index f78e6bb4..b672ad6d 100644
--- a/gtksourceview/gtksourcefilesaver.c
+++ b/gtksourceview/gtksourcefilesaver.c
@@ -38,7 +38,7 @@
  * Save a [class@Buffer] into a file.
  *
  * A `GtkSourceFileSaver` object permits to save a [class@Buffer] into a
- * [class Gio File].
+ * [iface Gio File].
  *
  * A file saver should be used only for one save operation, including errors
  * handling. If an error occurs, you can reconfigure the saver and relaunch the
@@ -1101,8 +1101,8 @@ gtk_source_file_saver_new (GtkSourceBuffer *buffer,
  * @file: the #GtkSourceFile.
  * @target_location: the #GFile where to save the buffer to.
  *
- * Creates a new #GtkSourceFileSaver object with a target location. 
- * 
+ * Creates a new #GtkSourceFileSaver object with a target location.
+ *
  * When the file saving is finished successfully, @target_location is set to the @file's
  * [property@File:location] property. If an error occurs, the previous valid
  * location is still available in [class@File].
@@ -1337,8 +1337,8 @@ gtk_source_file_saver_get_flags (GtkSourceFileSaver *saver)
  *   satisfied.
  * @user_data: user data to pass to @callback.
  *
- * Saves asynchronously the buffer into the file. 
- * 
+ * Saves asynchronously the buffer into the file.
+ *
  * See the [iface@Gio.AsyncResult] documentation to know how to use this function.
  */
 
diff --git a/gtksourceview/gtksourcegutter.c b/gtksourceview/gtksourcegutter.c
index 48a38a3c..f124309a 100644
--- a/gtksourceview/gtksourcegutter.c
+++ b/gtksourceview/gtksourcegutter.c
@@ -45,7 +45,7 @@
  *
  * The gutter works very much the same way as cells rendered in a [class@Gtk.TreeView].
  * The concept is similar, with the exception that the gutter does not have an
- * underlying [class@Gtk.TreeModel]. The builtin line number renderer is at position
+ * underlying [iface@Gtk.TreeModel]. The builtin line number renderer is at position
  * %GTK_SOURCE_VIEW_GUTTER_POSITION_LINES (-30) and the marks renderer is at
  * %GTK_SOURCE_VIEW_GUTTER_POSITION_MARKS (-20). The gutter sorts the renderers
  * in ascending order, from left to right. So the marks are displayed on the
diff --git a/gtksourceview/gtksourcegutterlines.c b/gtksourceview/gtksourcegutterlines.c
index d4e2328b..327b8b89 100644
--- a/gtksourceview/gtksourcegutterlines.c
+++ b/gtksourceview/gtksourcegutterlines.c
@@ -25,7 +25,7 @@
 #include "quarkset-inline.h"
 
 /**
- * GtkSourceGutterLines: 
+ * GtkSourceGutterLines:
  *
  * Collected information about visible lines.
  *
@@ -303,9 +303,9 @@ gtk_source_gutter_lines_add_qclass (GtkSourceGutterLines *lines,
  *
  * Adds the class @name to @line.
  *
- * @name will be converted to a [class@GLib.Quark] as part of this process. A
+ * @name will be converted to a [alias@GLib.Quark] as part of this process. A
  * faster version of this function is available via
- * [method@GutterLines.add_qclass] for situations where the [class@GLib.Quark] is
+ * [method@GutterLines.add_qclass] for situations where the [alias@GLib.Quark] is
  * known ahead of time.
  */
 void
@@ -356,7 +356,7 @@ gtk_source_gutter_lines_remove_class (GtkSourceGutterLines *lines,
  * @qname: a #GQuark to remove from @line
  *
  * Reverses a call to [method@GutterLines.add_qclass] by removing
- * the [class@GLib.Quark] matching @qname.
+ * the [alias@GLib.Quark] matching @qname.
  */
 void
 gtk_source_gutter_lines_remove_qclass (GtkSourceGutterLines *lines,
diff --git a/gtksourceview/gtksourcegutterrendererpixbuf.c b/gtksourceview/gtksourcegutterrendererpixbuf.c
index 8fab4665..dadb2d34 100644
--- a/gtksourceview/gtksourcegutterrendererpixbuf.c
+++ b/gtksourceview/gtksourcegutterrendererpixbuf.c
@@ -412,7 +412,7 @@ gtk_source_gutter_renderer_pixbuf_set_paintable (GtkSourceGutterRendererPixbuf *
  * gtk_source_gutter_renderer_pixbuf_get_paintable:
  * @renderer: a #GtkSourceGutterRendererPixbuf
  *
- * Gets a [class@Gdk.Paintable] that was set with
+ * Gets a [iface@Gdk.Paintable] that was set with
  * [method@GutterRendererPixbuf.set_paintable]
  *
  * Returns: (transfer none) (nullable): a #GdkPaintable or %NULL
diff --git a/gtksourceview/gtksourcehovercontext.c b/gtksourceview/gtksourcehovercontext.c
index 73fc237e..4bb744ea 100644
--- a/gtksourceview/gtksourcehovercontext.c
+++ b/gtksourceview/gtksourcehovercontext.c
@@ -36,7 +36,7 @@
  * contents for a [class@HoverDisplay].
  *
  * It can be used to retrieve the [class@View], [class@Buffer], and
- * [class@Gtk.TextIter] for the regions of text which are being displayed.
+ * [struct@Gtk.TextIter] for the regions of text which are being displayed.
  *
  * Use [method@HoverContext.get_bounds] to get the word that was
  * requested. [method@HoverContext.get_iter] will get you the location
diff --git a/gtksourceview/gtksourceindenter.c b/gtksourceview/gtksourceindenter.c
index bc5440f3..5968e3ff 100644
--- a/gtksourceview/gtksourceindenter.c
+++ b/gtksourceview/gtksourceindenter.c
@@ -26,7 +26,7 @@
 
 /**
  * GtkSourceIndenter:
- * 
+ *
  * Auto-indentation interface.
  *
  * By default, [class@View] can auto-indent as you type when
@@ -46,7 +46,7 @@
  *
  * [vfunc@Indenter.indent] is called after text has been
  * inserted into [class@Buffer] when
- * [vfunc@Indenter.is_trigger] returned %TRUE. The [class@Gtk.TextIter]
+ * [vfunc@Indenter.is_trigger] returned %TRUE. The [struct@Gtk.TextIter]
  * is placed directly after the inserted character or characters.
  *
  * It may be beneficial to move the insertion mark using
@@ -202,8 +202,8 @@ gtk_source_indenter_is_trigger (GtkSourceIndenter *self,
  * @iter: (inout): the location of the indentation request
  *
  * This function should be implemented to alter the indentation of text
- * within the view. 
- * 
+ * within the view.
+ *
  * @view is provided so that the indenter may retrieve settings such as indentation and tab widths.
  *
  * @iter is the location where the indentation was requested. This typically
diff --git a/gtksourceview/gtksourcemap.c b/gtksourceview/gtksourcemap.c
index 4505e675..61c96dcd 100644
--- a/gtksourceview/gtksourcemap.c
+++ b/gtksourceview/gtksourcemap.c
@@ -40,7 +40,7 @@
 
 /**
  * GtkSourceMap:
- * 
+ *
  * Widget that displays a map for a specific [class@View].
  *
  * `GtkSourceMap` is a widget that maps the content of a [class@View] into
@@ -60,7 +60,7 @@
  * desired font size for the map. A 1pt font generally seems to be an
  * appropriate font size. "Monospace 1" is the default. See
  * [method@Pango.FontDescription.set_size] for how to alter the size of an existing
- * [class@Pango.FontDescription].
+ * [struct@Pango.FontDescription].
  *
  * When FontConfig is available, `GtkSourceMap` will try to use a bundled
  * "block" font to make the map more legible.
diff --git a/gtksourceview/gtksourcemarkattributes.c b/gtksourceview/gtksourcemarkattributes.c
index a0230d62..7bc90f7d 100644
--- a/gtksourceview/gtksourcemarkattributes.c
+++ b/gtksourceview/gtksourcemarkattributes.c
@@ -465,8 +465,8 @@ gtk_source_mark_attributes_set_gicon (GtkSourceMarkAttributes *attributes,
  * gtk_source_mark_attributes_get_gicon:
  * @attributes: a #GtkSourceMarkAttributes.
  *
- * Gets a [class Gio Icon] to be used as a base for rendered icon. 
- * 
+ * Gets a [iface Gio Icon] to be used as a base for rendered icon.
+ *
  * Note that the icon can be %NULL if it wasn't set earlier.
  *
  * Returns: (transfer none): An icon. The icon belongs to @attributes and should
@@ -500,7 +500,7 @@ gtk_source_mark_attributes_set_pixbuf (GtkSourceMarkAttributes *attributes,
  * gtk_source_mark_attributes_get_pixbuf:
  * @attributes: a #GtkSourceMarkAttributes.
  *
- * Gets a [class@GdkPixbuf.Pixbuf] to be used as a base for rendered icon. 
+ * Gets a [class@GdkPixbuf.Pixbuf] to be used as a base for rendered icon.
  *
  * Note that the pixbuf can be %NULL if it wasn't set earlier.
  *
@@ -521,14 +521,14 @@ gtk_source_mark_attributes_get_pixbuf (GtkSourceMarkAttributes *attributes)
  * @widget: widget of which style settings may be used.
  * @size: size of the rendered icon.
  *
- * Renders an icon of given size. 
- * 
- * The base of the icon is set by the last call to one of: 
- * 
+ * Renders an icon of given size.
+ *
+ * The base of the icon is set by the last call to one of:
+ *
  * - [method@MarkAttributes.set_pixbuf]
  * - [method@MarkAttributes.set_gicon]
  * - [method@MarkAttributes.set_icon_name]
- * 
+ *
  * @size cannot be lower than 1.
  *
  * Returns: (transfer none): A #GdkPaintable. The paintable belongs to @attributes
@@ -559,8 +559,8 @@ gtk_source_mark_attributes_render_icon (GtkSourceMarkAttributes *attributes,
  * @attributes: a #GtkSourceMarkAttributes.
  * @mark: a #GtkSourceMark.
  *
- * Queries for a tooltip by emitting a [signal@MarkAttributes::query-tooltip-text] signal. 
- * 
+ * Queries for a tooltip by emitting a [signal@MarkAttributes::query-tooltip-text] signal.
+ *
  * The tooltip is a plain text.
  *
  * Returns: (transfer full): A tooltip. The returned string should be freed by
@@ -586,8 +586,8 @@ gtk_source_mark_attributes_get_tooltip_text (GtkSourceMarkAttributes *attributes
  * @attributes: a #GtkSourceMarkAttributes.
  * @mark: a #GtkSourceMark.
  *
- * Queries for a tooltip by emitting a [signal@MarkAttributes::query-tooltip-markup] signal. 
- * 
+ * Queries for a tooltip by emitting a [signal@MarkAttributes::query-tooltip-markup] signal.
+ *
  * The tooltip may contain a markup.
  *
  * Returns: (transfer full): A tooltip. The returned string should be freed by
diff --git a/gtksourceview/gtksourcesearchcontext.c b/gtksourceview/gtksourcesearchcontext.c
index 1914747f..a30b01ae 100644
--- a/gtksourceview/gtksourcesearchcontext.c
+++ b/gtksourceview/gtksourcesearchcontext.c
@@ -37,7 +37,7 @@
 
 /**
  * GtkSourceSearchContext:
- * 
+ *
  * Search context.
  *
  * A `GtkSourceSearchContext` is used for the search and replace in a
@@ -2885,8 +2885,8 @@ gtk_source_search_context_init (GtkSourceSearchContext *search)
  * @settings: (nullable): a #GtkSourceSearchSettings, or %NULL.
  *
  * Creates a new search context, associated with @buffer, and customized with
- * @settings. 
- * 
+ * @settings.
+ *
  * If @settings is %NULL, a new [class@SearchSettings] object will
  * be created, that you can retrieve with [method@SearchContext.get_settings].
  *
@@ -2990,8 +2990,8 @@ gtk_source_search_context_get_match_style (GtkSourceSearchContext *search)
  * @search: a #GtkSourceSearchContext.
  * @match_style: (nullable): a #GtkSourceStyle, or %NULL.
  *
- * Set the style to apply on search matches. 
- * 
+ * Set the style to apply on search matches.
+ *
  * If @match_style is %NULL, default theme's scheme 'match-style' will be used.
  * To enable or disable the search highlighting, use [method@SearchContext.set_highlight].
  */
@@ -3028,9 +3028,9 @@ gtk_source_search_context_set_match_style (GtkSourceSearchContext *search,
  *
  * Regular expression patterns must follow certain rules. If
  * [property@SearchSettings:search-text] breaks a rule, the error can be
- * retrieved with this function. 
- * 
- * The error domain is [error@GLib.RegexError].
+ * retrieved with this function.
+ *
+ * The error domain is [enum@GLib.RegexError].
  *
  * Free the return value with [method GLib Error free].
  *
@@ -3054,9 +3054,9 @@ gtk_source_search_context_get_regex_error (GtkSourceSearchContext *search)
  * gtk_source_search_context_get_occurrences_count:
  * @search: a #GtkSourceSearchContext.
  *
- * Gets the total number of search occurrences. 
- * 
- * If the buffer is not already fully scanned, the total number of occurrences is 
+ * Gets the total number of search occurrences.
+ *
+ * If the buffer is not already fully scanned, the total number of occurrences is
  * unknown, and -1 is returned.
  *
  * Returns: the total number of search occurrences, or -1 if unknown.
@@ -3081,7 +3081,7 @@ gtk_source_search_context_get_occurrences_count (GtkSourceSearchContext *search)
  * @match_end: the end of the occurrence.
  *
  * Gets the position of a search occurrence.
- * 
+ *
  * If the buffer is not already fully scanned, the position may be unknown,
  * and -1 is returned. If 0 is returned, it means that this part of the buffer
  * has already been scanned, and that @match_start and @match_end don't delimit an occurrence.
@@ -3187,9 +3187,9 @@ gtk_source_search_context_get_occurrence_position (GtkSourceSearchContext *searc
  * @has_wrapped_around: (out) (optional): return location to know whether the
  *   search has wrapped around, or %NULL.
  *
- * Synchronous forward search. 
+ * Synchronous forward search.
  *
- * It is recommended to use the asynchronous functions instead, to not block the user interface. 
+ * It is recommended to use the asynchronous functions instead, to not block the user interface.
  * However, if you are sure that the @buffer is small, this function is more convenient to use.
  *
  * If the [property@SearchSettings:wrap-around] property is %FALSE, this function
@@ -3701,8 +3701,8 @@ gtk_source_search_context_replace (GtkSourceSearchContext  *search,
  * @replace_length: the length of @replace in bytes, or -1.
  * @error: location to a #GError, or %NULL to ignore errors.
  *
- * Replaces all search matches by another text. 
- * 
+ * Replaces all search matches by another text.
+ *
  * It is a synchronous function, so it can block the user interface.
  *
  * For a regular expression replacement, you can check if @replace is valid by
diff --git a/gtksourceview/gtksourcespacedrawer.c b/gtksourceview/gtksourcespacedrawer.c
index 5b598c3a..6ada9511 100644
--- a/gtksourceview/gtksourcespacedrawer.c
+++ b/gtksourceview/gtksourcespacedrawer.c
@@ -37,7 +37,7 @@
 
 /**
  * GtkSourceSpaceDrawer:
- * 
+ *
  * Represent white space characters with symbols.
  *
  * #GtkSourceSpaceDrawer provides a way to visualize white spaces, by drawing
@@ -369,10 +369,10 @@ gtk_source_space_drawer_class_init (GtkSourceSpaceDrawerClass *klass)
        /**
         * GtkSourceSpaceDrawer:matrix:
         *
-        * The property is a [class@GLib.Variant] property to specify where and
+        * The property is a [struct@GLib.Variant] property to specify where and
         * what kind of white spaces to draw.
         *
-        * The [class@GLib.Variant] is of type `"au"`, an array of unsigned integers. Each
+        * The [struct@GLib.Variant] is of type `"au"`, an array of unsigned integers. Each
         * integer is a combination of [flags@SpaceTypeFlags]. There is one
         * integer for each [flags@SpaceLocationFlags], in the same order as
         * they are defined in the enum (%GTK_SOURCE_SPACE_LOCATION_NONE and
@@ -406,7 +406,7 @@ gtk_source_space_drawer_init (GtkSourceSpaceDrawer *drawer)
  * gtk_source_space_drawer_new:
  *
  * Creates a new #GtkSourceSpaceDrawer object.
- * 
+ *
  * Useful for storing space drawing settings independently of a [class@View].
  *
  * Returns: a new #GtkSourceSpaceDrawer.
@@ -423,8 +423,8 @@ gtk_source_space_drawer_new (void)
  * @locations: one or several #GtkSourceSpaceLocationFlags.
  *
  * If only one location is specified, this function returns what kind of
- * white spaces are drawn at that location. 
- * 
+ * white spaces are drawn at that location.
+ *
  * The value is retrieved from the [property@SpaceDrawer:matrix] property.
  *
  * If several locations are specified, this function returns the logical AND for
@@ -489,7 +489,7 @@ gtk_source_space_drawer_set_types_for_locations (GtkSourceSpaceDrawer        *dr
  * gtk_source_space_drawer_get_matrix:
  * @drawer: a #GtkSourceSpaceDrawer.
  *
- * Gets the value of the [property@SpaceDrawer:matrix] property, as a [class@GLib.Variant].
+ * Gets the value of the [property@SpaceDrawer:matrix] property, as a [struct@GLib.Variant].
  *
  * An empty array can be returned in case the matrix is a zero matrix.
  *
@@ -534,8 +534,8 @@ gtk_source_space_drawer_get_matrix (GtkSourceSpaceDrawer *drawer)
  * @drawer: a #GtkSourceSpaceDrawer.
  * @matrix: (transfer floating) (nullable): the new matrix value, or %NULL.
  *
- * Sets a new value to the [property@SpaceDrawer:matrix] property, as a [class@GLib.Variant]. 
- * 
+ * Sets a new value to the [property@SpaceDrawer:matrix] property, as a [struct@GLib.Variant].
+ *
  * If @matrix is %NULL, then an empty array is set.
  *
  * If @matrix is floating, it is consumed.
@@ -678,7 +678,7 @@ matrix_set_mapping (const GValue       *value,
  * [property@SpaceDrawer:matrix] property, that is, `"au"`.
  *
  * The [method Gio Settings bind] function cannot be used, because the default GIO
- * mapping functions don't support [class@GLib.Variant] properties (maybe it will be
+ * mapping functions don't support [struct@GLib.Variant] properties (maybe it will be
  * supported by a future GIO version, in which case this function can be
  * deprecated).
  */
diff --git a/gtksourceview/gtksourcevimimcontext.c b/gtksourceview/gtksourcevimimcontext.c
index f35b3b2c..b9754ac2 100644
--- a/gtksourceview/gtksourcevimimcontext.c
+++ b/gtksourceview/gtksourcevimimcontext.c
@@ -33,7 +33,7 @@
  *
  * Vim emulation.
  *
- * The `GtkSourceVimIMContext` is a [iface@Gtk.IMContext] implementation that can
+ * The `GtkSourceVimIMContext` is a [class@Gtk.IMContext] implementation that can
  * be used to provide Vim-like editing controls within a [class@View].
  *
  * The `GtkSourceViMIMContext` will process incoming [class@Gdk.KeyEvent] as the
@@ -56,7 +56,7 @@
  * [property@VimIMContext:command-text] to the user as they represent the
  * command-bar and current command preview found in Vim.
  *
- * `GtkSourceVimIMContext` attempts to work with additional [iface@Gtk.IMContext]
+ * `GtkSourceVimIMContext` attempts to work with additional [class@Gtk.IMContext]
  * implementations such as IBus by querying the [class@Gtk.TextView] before processing
  * the command in states which support it (notably Insert and Replace modes).
  *
@@ -461,8 +461,8 @@ gtk_source_vim_im_context_class_init (GtkSourceVimIMContextClass *klass)
         * @view: the #GtkSourceView
         * @path: (nullable): the path if provided, otherwise %NULL
         *
-        * Requests the application save the file. 
-        * 
+        * Requests the application save the file.
+        *
         * If a filename was provided, it will be available to the signal handler as @path.
         * This may be executed in relation to the user running the `:write` or `:w` commands.
         *
@@ -486,8 +486,8 @@ gtk_source_vim_im_context_class_init (GtkSourceVimIMContextClass *klass)
         * @view: the #GtkSourceView
         * @path: (nullable): the path if provided, otherwise %NULL
         *
-        * Requests the application open the file found at @path. 
-        * 
+        * Requests the application open the file found at @path.
+        *
         * If @path is %NULL, then the current file should be reloaded from storage.
         *
         * This may be executed in relation to the user running the