[gnome-builder] doc: prefer lowercase a in parameter description
- From: Christian Hergert <chergert src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-builder] doc: prefer lowercase a in parameter description
- Date: Tue, 7 Nov 2017 06:54:23 +0000 (UTC)
commit e1dc3bafc2c71f98bf8345cafc3f8b43c071c85a
Author: Christian Hergert <chergert redhat com>
Date: Mon Nov 6 22:53:36 2017 -0800
doc: prefer lowercase a in parameter description
Most things seem to use lowercase, and we want to be consistent.
src/gstyle/gstyle-color-convert.c | 16 +++---
src/gstyle/gstyle-color-item.c | 14 ++--
src/gstyle/gstyle-color-panel.c | 26 ++++----
src/gstyle/gstyle-color-plane.c | 32 +++++-----
src/gstyle/gstyle-color-scale.c | 22 +++---
src/gstyle/gstyle-color-widget.c | 12 ++--
src/gstyle/gstyle-color.c | 44 +++++++-------
src/gstyle/gstyle-eyedropper.c | 4 +-
src/gstyle/gstyle-palette-widget.c | 66 ++++++++++----------
src/gstyle/gstyle-palette.c | 18 +++---
src/libide/application/ide-application-tool.c | 2 +-
src/libide/application/ide-application.c | 16 +++---
src/libide/buffers/ide-buffer-manager.c | 10 ++--
src/libide/buffers/ide-buffer.c | 22 +++---
src/libide/buffers/ide-unsaved-file.c | 4 +-
src/libide/buffers/ide-unsaved-files.c | 2 +-
src/libide/buildsystem/ide-build-manager.c | 16 +++---
src/libide/buildsystem/ide-build-pipeline.c | 6 +-
src/libide/buildsystem/ide-build-stage.h | 6 +-
.../buildsystem/ide-build-system-discovery.c | 4 +-
src/libide/buildsystem/ide-build-system.c | 6 +-
src/libide/buildsystem/ide-build-target.c | 2 +-
src/libide/buildsystem/ide-compile-commands.c | 12 ++--
src/libide/buildsystem/ide-configuration.c | 4 +-
src/libide/debugger/ide-debugger-breakpoints.c | 4 +-
src/libide/debugger/ide-debugger-library.c | 2 +-
src/libide/debugger/ide-debugger.c | 56 ++++++++--------
src/libide/devices/ide-device-provider.c | 2 +-
src/libide/diagnostics/ide-diagnostic.c | 2 +-
src/libide/diagnostics/ide-diagnostics-manager.c | 2 +-
src/libide/diagnostics/ide-source-location.c | 6 +-
src/libide/doap/ide-doap.c | 4 +-
src/libide/editor/ide-editor-perspective.c | 2 +-
src/libide/editor/ide-editor-sidebar.c | 2 +-
src/libide/editor/ide-editor-view.c | 2 +-
src/libide/files/ide-file.c | 6 +-
src/libide/genesis/ide-genesis-addin.c | 2 +-
src/libide/highlighting/ide-highlight-engine.c | 2 +-
src/libide/ide-context.c | 8 +-
src/libide/ide-object.c | 12 ++--
src/libide/langserv/ide-langserv-client.c | 2 +-
src/libide/layout/ide-layout-stack-header.c | 2 +-
src/libide/layout/ide-layout-view.c | 8 +-
src/libide/logging/ide-log.c | 6 +-
src/libide/plugins/ide-extension-adapter.c | 6 +-
src/libide/plugins/ide-extension-set-adapter.c | 4 +-
src/libide/plugins/ide-extension-util.c | 2 +-
src/libide/projects/ide-project-file.c | 2 +-
src/libide/projects/ide-project-files.c | 2 +-
src/libide/projects/ide-project-info.c | 6 +-
src/libide/projects/ide-project-item.c | 2 +-
src/libide/projects/ide-project.c | 2 +-
src/libide/projects/ide-recent-projects.c | 4 +-
src/libide/rename/ide-rename-provider.c | 4 +-
src/libide/runtimes/ide-runtime-manager.c | 2 +-
src/libide/runtimes/ide-runtime.c | 4 +-
src/libide/search/ide-search-engine.c | 2 +-
src/libide/search/ide-search-provider.c | 2 +-
src/libide/sourceview/ide-indenter.c | 6 +-
src/libide/sourceview/ide-source-view.c | 2 +-
src/libide/sourceview/ide-text-iter.c | 22 +++---
src/libide/subprocess/ide-subprocess.c | 14 ++--
src/libide/symbols/ide-code-indexer.c | 6 +-
src/libide/symbols/ide-symbol-resolver.c | 10 ++--
src/libide/template/ide-project-template.c | 4 +-
src/libide/template/ide-template-base.c | 2 +-
src/libide/template/ide-template-provider.c | 2 +-
src/libide/testing/ide-test-manager.c | 6 +-
src/libide/threading/ide-thread-pool.c | 2 +-
src/libide/transfers/ide-transfer-manager.c | 2 +-
src/libide/util/ide-glib.c | 4 +-
src/libide/util/ide-gtk.c | 2 +-
src/libide/util/ide-uri.c | 4 +-
src/libide/vcs/ide-vcs.c | 4 +-
src/libide/workbench/ide-perspective.c | 4 +-
src/libide/workbench/ide-workbench-open.c | 4 +-
src/libide/workers/ide-worker.c | 4 +-
.../autotools/ide-autotools-project-miner.c | 2 +-
src/plugins/autotools/ide-makecache.c | 2 +-
src/plugins/clang/ide-clang-symbol-tree.c | 2 +-
src/plugins/clang/ide-clang-translation-unit.c | 2 +-
.../color-picker/gb-color-picker-editor-addin.c | 2 +-
src/plugins/command-bar/gb-command-bar.c | 4 +-
src/plugins/command-bar/gb-command-provider.c | 6 +-
.../flatpak/gbp-flatpak-application-addin.c | 2 +-
src/plugins/gdb/gbp-gdb-debugger.c | 4 +-
src/plugins/git/ide-git-vcs.c | 2 +-
.../gnome-code-assistance/gca-diagnostics.c | 42 ++++++------
src/plugins/gnome-code-assistance/gca-service.c | 62 +++++++++---------
.../gnome-code-assistance/ide-gca-service.c | 2 +-
src/plugins/history/gbp-history-item.c | 2 +-
src/plugins/project-tree/gb-new-file-popover.c | 6 +-
src/plugins/spellcheck/gbp-spell-buffer-addin.c | 4 +-
.../spellcheck/gbp-spell-editor-view-addin.c | 4 +-
src/plugins/todo/gbp-todo-model.c | 6 +-
src/plugins/todo/gbp-todo-panel.c | 2 +-
src/plugins/xml-pack/ide-xml-analysis.c | 2 +-
src/plugins/xml-pack/ide-xml-service.c | 2 +-
98 files changed, 404 insertions(+), 404 deletions(-)
---
diff --git a/src/gstyle/gstyle-color-convert.c b/src/gstyle/gstyle-color-convert.c
index 7dac7b6..339e53b 100644
--- a/src/gstyle/gstyle-color-convert.c
+++ b/src/gstyle/gstyle-color-convert.c
@@ -341,7 +341,7 @@ gstyle_color_convert_xyz_to_cielab (GstyleXYZ *xyz,
/**
* gstyle_color_convert_rgb_to_hsl:
- * @rgba: A #GdkRGBA struct.
+ * @rgba: a #GdkRGBA struct.
* @hue: (out): The hue component of a hsl color in range [0.0-360.0[
* @saturation: (out): The saturation component of a hsl color in range [0.0-100.0]
* @lightness: (out): The lightness component of a hsl color in range [0.0-100.0]
@@ -432,7 +432,7 @@ hue2rgb (gdouble m1,
* @hue: The hue component of a hsl color in range [0.0-360.0[
* @saturation: The saturation component of a hsl color in range [0.0-100.0]
* @lightness: The lightness component of a hsl color in range [0.0-100.0]
- * @rgba: A #GdkRGBA.
+ * @rgba: a #GdkRGBA.
*
* Convert RGB components to HSL ones.
* The alpha component is not used because it doesn't change in the conversion.
@@ -465,7 +465,7 @@ gstyle_color_convert_hsl_to_rgb (gdouble hue,
* @hue: The hue component of a hsv color in range [0.0-1.0[
* @saturation: The saturation component of a hsv color in range [0.0-1.0]
* @value: The value component of a hsv color in range [0.0-1.0]
- * @rgba: A #GdkRGBA.
+ * @rgba: a #GdkRGBA.
*
* Convert HSV components to RGB ones.
* The alpha component is not used because it doesn't change in the conversion.
@@ -544,7 +544,7 @@ gstyle_color_convert_hsv_to_rgb (gdouble hue,
/**
* gstyle_color_convert_rgb_to_xyz:
* @rgba: An #GdkRGBA.
- * @xyz: A #GstyleXYZ.
+ * @xyz: a #GstyleXYZ.
*
* Convert RGB components to XYZ ones.
* The alpha component is not used because it doesn't change in the conversion.
@@ -624,7 +624,7 @@ gstyle_color_convert_rgb_to_hsv (GdkRGBA *rgba,
/**
* gstyle_color_convert_rgb_to_cielab:
* @rgba: An #GdkRGBA.
- * @lab: (out): A #GstyleCieLab struct.
+ * @lab: (out): a #GstyleCieLab struct.
*
* Convert RGB components to CIELAB ones.
* The alpha component is not used because it doesn't change in the conversion.
@@ -644,7 +644,7 @@ gstyle_color_convert_rgb_to_cielab (GdkRGBA *rgba,
/**
* gstyle_color_convert_cielab_to_rgb:
- * @lab: A #GstyleCieLab struct.
+ * @lab: a #GstyleCieLab struct.
* @rgba: (out): An #GdkRGBA.
*
* Convert CIELAB components to RGB ones.
@@ -723,8 +723,8 @@ gstyle_color_convert_xyz_to_hsv (GstyleXYZ *xyz,
/**
* gstyle_color_delta_e:
- * @lab1: A #GstyleCielab.
- * @lab2: A #GstyleCielab.
+ * @lab1: a #GstyleCielab.
+ * @lab2: a #GstyleCielab.
*
* Compute the color difference between lab1 and lab2,
* based on the deltaE CIEDE2000 formula.
diff --git a/src/gstyle/gstyle-color-item.c b/src/gstyle/gstyle-color-item.c
index d9b2bd7..a207a51 100644
--- a/src/gstyle/gstyle-color-item.c
+++ b/src/gstyle/gstyle-color-item.c
@@ -24,11 +24,11 @@ G_DEFINE_BOXED_TYPE (GstyleColorItem, gstyle_color_item, gstyle_color_item_ref,
/**
* gstyle_color_item_get_color:
- * @self: A #GstyleColorItem
+ * @self: a #GstyleColorItem
*
* Get the #GstyleColor inside the #GstyleColorItem.
*
- * Returns: (transfer none): A #GstyleColor.
+ * Returns: (transfer none): a #GstyleColor.
*
*/
const GstyleColor *
@@ -41,8 +41,8 @@ gstyle_color_item_get_color (GstyleColorItem *self)
/**
* gstyle_color_item_set_color:
- * @self: A #GstyleColorItem
- * @color: (nullable): A #GstyleColor or %NULL
+ * @self: a #GstyleColorItem
+ * @color: (nullable): a #GstyleColor or %NULL
*
* Set the #GstyleColor inside the #GstyleColorItem.
*
@@ -60,7 +60,7 @@ gstyle_color_item_set_color (GstyleColorItem *self,
/**
* gstyle_color_item_get_start:
- * @self: A #GstyleColorItem
+ * @self: a #GstyleColorItem
*
* Get the start position of the #GstyleColorItem.
*
@@ -77,7 +77,7 @@ gstyle_color_item_get_start (GstyleColorItem *self)
/**
* gstyle_color_item_get_len:
- * @self: A #GstyleColorItem
+ * @self: a #GstyleColorItem
*
* Get the size of the #GstyleColorItem.
*
@@ -142,7 +142,7 @@ gstyle_color_item_free (GstyleColorItem *self)
/**
* gstyle_color_item_new:
- * @color: (nullable): A #GstyleColor or NULL
+ * @color: (nullable): a #GstyleColor or NULL
* @start: start offset of the item
* @len: length of the item
*
diff --git a/src/gstyle/gstyle-color-panel.c b/src/gstyle/gstyle-color-panel.c
index 9cd8ea3..4e62a88 100644
--- a/src/gstyle/gstyle-color-panel.c
+++ b/src/gstyle/gstyle-color-panel.c
@@ -86,7 +86,7 @@ static guint signals [LAST_SIGNAL];
/**
* gstyle_color_panel_get_filter:
- * @self: A #GstyleColorPanel.
+ * @self: a #GstyleColorPanel.
*
* Get the current color filter.
*
@@ -172,8 +172,8 @@ adj_alpha_value_changed_cb (GstyleColorPanel *self,
/**
* gstyle_color_panel_set_filter:
- * @self: A #GstyleColorPanel
- * @filter: A #GstyleColorFilter
+ * @self: a #GstyleColorPanel
+ * @filter: a #GstyleColorFilter
*
* Set the color filter to use.
*
@@ -246,8 +246,8 @@ gstyle_color_panel_set_filter (GstyleColorPanel *self,
/**
* gstyle_color_panel_get_rgba:
- * @self: A #GstyleColorPanel.
- * @rgba: (out): A #GdkRGBA adress.
+ * @self: a #GstyleColorPanel.
+ * @rgba: (out): a #GdkRGBA adress.
*
* Fill @rgba with the current color plane rgba.
*
@@ -264,8 +264,8 @@ gstyle_color_panel_get_rgba (GstyleColorPanel *self,
/**
* gstyle_color_panel_get_xyz:
- * @self: A #GstyleColorPanel.
- * @xyz: (out): A #GstyleXYZ adress.
+ * @self: a #GstyleColorPanel.
+ * @xyz: (out): a #GstyleXYZ adress.
*
* Fill @xyz with the current color plane xyz.
*
@@ -282,8 +282,8 @@ gstyle_color_panel_get_xyz (GstyleColorPanel *self,
/**
* gstyle_color_panel_set_rgba:
- * @self: A #GstyleColorPanel.
- * @rgba: A #GdkRGBA.
+ * @self: a #GstyleColorPanel.
+ * @rgba: a #GdkRGBA.
*
* Set the color plane and sliders to rgba.
*
@@ -300,8 +300,8 @@ gstyle_color_panel_set_rgba (GstyleColorPanel *self,
/**
* gstyle_color_panel_set_xyz:
- * @self: A #GstyleColorPanel.
- * @xyz: A #GstyleXYZ.
+ * @self: a #GstyleColorPanel.
+ * @xyz: a #GstyleXYZ.
*
* Set the color plane and sliders to the xyz value.
*
@@ -318,7 +318,7 @@ gstyle_color_panel_set_xyz (GstyleColorPanel *self,
/**
* gstyle_color_panel_get_palette_widget:
- * @self: A #GstyleColorPanel.
+ * @self: a #GstyleColorPanel.
*
* Returns: (nullable) (transfer none): The #GstylePaletteWidget used by the panel.
*
@@ -1181,7 +1181,7 @@ setup_ui (GstyleColorPanel *self)
/**
* gstyle_color_panel_show_palette:
- * @self: A #GstyleColorPanel.
+ * @self: a #GstyleColorPanel.
* @palette: A GstylePalette.
*
* Show the @palette and update its name in the bar.
diff --git a/src/gstyle/gstyle-color-plane.c b/src/gstyle/gstyle-color-plane.c
index d5d50de..d8a3b23 100644
--- a/src/gstyle/gstyle-color-plane.c
+++ b/src/gstyle/gstyle-color-plane.c
@@ -349,8 +349,8 @@ setup_component (GstyleColorPlane *self,
/**
* gstyle_color_plane_set_preferred_unit:
- * @self: A #GstyleColorPlane
- * @preferred_unit: A #GstyleColorUnit enum value
+ * @self: a #GstyleColorPlane
+ * @preferred_unit: a #GstyleColorUnit enum value
*
* Set percent or value as the preferred unit for rgb adjustment range.
* [0, 100] for percent unit or [0, 255] for value.
@@ -383,7 +383,7 @@ gstyle_color_plane_set_preferred_unit (GstyleColorPlane *self,
/**
* gstyle_color_plane_get_filter_func: (skip):
- * @self: A #GstyleColorPlane
+ * @self: a #GstyleColorPlane
*
* Get a pointer to the current filter function or %NULL
* if no filter is actually set.
@@ -403,7 +403,7 @@ gstyle_color_plane_get_filter_func (GstyleColorPlane *self)
/**
* gstyle_color_plane_set_filter_func:
- * @self: A #GstyleColorPlane
+ * @self: a #GstyleColorPlane
* @filter_cb: (scope notified) (nullable): A GstyleColorFilterFunc filter function or
* %NULL to unset the current filter. In this case, user_data is ignored
* @user_data: (closure) (nullable): user data to pass when calling the filter function
@@ -1102,8 +1102,8 @@ gstyle_color_plane_key_press (GtkWidget *widget,
/**
* gstyle_color_plane_get_xyz:
- * @self: A #GstyleColorPlane
- * @xyz: (out): A #GstyleXYZ adress
+ * @self: a #GstyleColorPlane
+ * @xyz: (out): a #GstyleXYZ adress
*
* Fill @xyz with value at cursor position.
* The alpha component is always equal to 1.
@@ -1123,8 +1123,8 @@ gstyle_color_plane_get_xyz (GstyleColorPlane *self,
/**
* gstyle_color_plane_get_rgba:
- * @self: A #GstyleColorPlane
- * @rgba: (out): A #GdkRGBA adress
+ * @self: a #GstyleColorPlane
+ * @rgba: (out): a #GdkRGBA adress
*
* Fill @rgba with value at cursor position.
* The alpha component is always equal to 1.
@@ -1144,8 +1144,8 @@ gstyle_color_plane_get_rgba (GstyleColorPlane *self,
/**
* gstyle_color_plane_get_filtered_rgba:
- * @self: A #GstyleColorPlane
- * @rgba: (out): A #GdkRGBA adress
+ * @self: a #GstyleColorPlane
+ * @rgba: (out): a #GdkRGBA adress
*
* Fill @rgba with filtered value at cursor position.
*
@@ -1165,8 +1165,8 @@ gstyle_color_plane_get_filtered_rgba (GstyleColorPlane *self,
/**
* gstyle_color_plane_get_component_adjustment:
- * @self: A #GstyleColorPlane
- * @comp: A #GstyleColorComponent enum value
+ * @self: a #GstyleColorPlane
+ * @comp: a #GstyleColorComponent enum value
*
* Return the color component adjustment designated by
* the #GstyleColorComponent value.
@@ -1188,8 +1188,8 @@ gstyle_color_plane_get_component_adjustment (GstyleColorPlane *self,
/**
* gstyle_color_plane_set_rgba:
- * @self: A #GstyleColorPlane
- * @rgba: A #GdkRGBA
+ * @self: a #GstyleColorPlane
+ * @rgba: a #GdkRGBA
*
* Set cursor position from @rgba value.
*
@@ -1220,8 +1220,8 @@ gstyle_color_plane_set_rgba (GstyleColorPlane *self,
/**
* gstyle_color_plane_set_xyz:
- * @self: A #GstyleColorPlane.
- * @xyz: A #GstyleXYZ struct.
+ * @self: a #GstyleColorPlane.
+ * @xyz: a #GstyleXYZ struct.
*
* Set cursor position from @rgba value.
*
diff --git a/src/gstyle/gstyle-color-scale.c b/src/gstyle/gstyle-color-scale.c
index 2757aac..1f1f31d 100644
--- a/src/gstyle/gstyle-color-scale.c
+++ b/src/gstyle/gstyle-color-scale.c
@@ -101,7 +101,7 @@ filter_data (GstyleColorScale *self)
/**
* gstyle_color_scale_get_filter_func: (skip):
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
*
* Get a pointer to the current filter function or %NULL
* if no filter is actually set.
@@ -121,7 +121,7 @@ gstyle_color_scale_get_filter_func (GstyleColorScale *self)
* keeping the original datas */
/**
* gstyle_color_scale_set_filter_func:
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
* @filter_cb: (scope notified) (nullable): A GstyleColorFilterFunc filter function or
* %NULL to unset the current filter. In this case, user_data is ignored.
* @user_data: (closure) (nullable): user data to pass when calling the filter function
@@ -160,7 +160,7 @@ gstyle_color_scale_set_filter_func (GstyleColorScale *self,
/**
* gstyle_color_scale_clear_color_stops:
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
*
* CLear all the color stops from the color scale.
*
@@ -195,7 +195,7 @@ compare_color_stop_by_offset (ColorStop *a,
/**
* gstyle_color_scale_remove_color_stop:
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
* @id: id of a color stop as returned by gstyle_color_scale_add_* functions
*
* Remove an existing color stop for the color scale.
@@ -219,9 +219,9 @@ gstyle_color_scale_remove_color_stop (GstyleColorScale *self,
/**
* gstyle_color_scale_add_rgba_color_stop:
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
* @offset: position in the range [0, 1] of the color stop
- * @rgba: A #GdkRGBA
+ * @rgba: a #GdkRGBA
*
* Set a color stop for the color scale.
* If there's no color stop at offset 0, a black opaque color stop is automatically added.
@@ -279,7 +279,7 @@ gstyle_color_scale_add_rgba_color_stop (GstyleColorScale *self,
/**
* gstyle_color_scale_set_custom_data:
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
* @data: data location
*
* Set the data used to draw the color ramp if your have
@@ -320,7 +320,7 @@ gstyle_color_scale_set_custom_data (GstyleColorScale *self,
/**
* gstyle_color_scale_add_color_stop:
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
* @offset: position in the range [0, 1] of the color stop
* @red: red component of the color stop
* @green: red component of the color stop
@@ -352,7 +352,7 @@ gstyle_color_scale_add_color_stop (GstyleColorScale *self,
/**
* gstyle_color_scale_get_kind:
- * @self: A #GstyleColorScale
+ * @self: a #GstyleColorScale
*
* Get the kind of gradient displayed in the scale.
*
@@ -369,8 +369,8 @@ gstyle_color_scale_get_kind (GstyleColorScale *self)
/**
* gstyle_color_scale_set_kind:
- * @self: A #GstyleColorScale
- * @kind: A #GstyleColorKind
+ * @self: a #GstyleColorScale
+ * @kind: a #GstyleColorKind
*
* Set the kind of gradient displayed in the scale.
* If you set the kind to GSTYLE_COLOR_SCALE_KIND_CUSTOM_STOPS,
diff --git a/src/gstyle/gstyle-color-widget.c b/src/gstyle/gstyle-color-widget.c
index b513207..fcce3e8 100644
--- a/src/gstyle/gstyle-color-widget.c
+++ b/src/gstyle/gstyle-color-widget.c
@@ -899,7 +899,7 @@ gstyle_color_widget_disconnect_color (GstyleColorWidget *self)
/**
* gstyle_color_widget_copy:
- * @self: A #GstyleColorWidget
+ * @self: a #GstyleColorWidget
*
* Copy the given ##GstyleColorWidget.
* Notice that the underlaying #GstyleColor is shared
@@ -934,7 +934,7 @@ gstyle_color_widget_copy (GstyleColorWidget *self)
/**
* gstyle_color_widget_get_filter_func: (skip):
- * @self: A #GstyleColorPlane
+ * @self: a #GstyleColorPlane
*
* Get a pointer to the current filter function or %NULL
* if no filter is actually set.
@@ -952,7 +952,7 @@ gstyle_color_widget_get_filter_func (GstyleColorWidget *self)
/**
* gstyle_color_widget_set_filter_func:
- * @self: A #GstyleColorPlane
+ * @self: a #GstyleColorPlane
* @filter_func: (scope notified) (nullable): A GstyleColorFilterFunc filter function or
* %NULL to unset the current filter. In this case, user_data is ignored
* @user_data: (closure) (nullable): user data to pass when calling the filter function
@@ -1002,8 +1002,8 @@ gstyle_color_widget_set_filter_func (GstyleColorWidget *self,
/**
* gstyle_color_widget_set_color:
- * @self: A #GstyleColorWidget
- * @color: (nullable): A #GstyleColor or %NULL
+ * @self: a #GstyleColorWidget
+ * @color: (nullable): a #GstyleColor or %NULL
*
* Set the #GstyleColor for the #GstyleColorWidget.
*
@@ -1218,7 +1218,7 @@ gstyle_color_widget_new (void)
/**
* gstyle_color_widget_new_with_color:
- * @color: A #GstyleColor
+ * @color: a #GstyleColor
*
* Returns: A new #GstyleColorWidget.with @color affected.
*
diff --git a/src/gstyle/gstyle-color.c b/src/gstyle/gstyle-color.c
index 527bc8e..304049e 100644
--- a/src/gstyle/gstyle-color.c
+++ b/src/gstyle/gstyle-color.c
@@ -87,7 +87,7 @@ static gchar TRUNCATE_BUF[6];
/**
* gstyle_color_to_hsla:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
* @hue: (out): The hue component of a hsla color in range [0.0-360.0[
* @saturation: (out): The saturation component of a hsla color in range [0.0-100.0]
* @lightness: (out): The lightness component of a hsla color in range [0.0-100.0]
@@ -131,7 +131,7 @@ truncate_trailing_zeros (gdouble number)
/**
* gstyle_color_to_string:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
* @kind: The kind of representation as a #GstyleColorKind
*
* Get the string representation of a #GstyleColor.
@@ -263,11 +263,11 @@ gstyle_color_to_string (GstyleColor *self,
/**
* gstyle_color_get_rgba:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
*
* Get a #GdkRGBA object from a #GstyleColor.
*
- * Returns: A #GdkRGBA.
+ * Returns: a #GdkRGBA.
*
*/
GdkRGBA *
@@ -280,7 +280,7 @@ gstyle_color_get_rgba (GstyleColor *self)
/**
* gstyle_color_fill_rgba:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
* @rgba: (out): the #GdkRGBA to fill in
*
* Fill a #GdkRGBA object from a #GstyleColor.
@@ -745,7 +745,7 @@ _parse_predefined_color (const gchar *color_string,
* gstyle_color_fuzzy_parse_color_string:
* @color_string: color name to search for
*
- * Returns: (transfer full) (element-type GstyleColor): A #GPtrArray of #GstyleColor for a fuzzy search.
+ * Returns: (transfer full) (element-type GstyleColor): a #GPtrArray of #GstyleColor for a fuzzy search.
*/
GPtrArray *
gstyle_color_fuzzy_parse_color_string (const gchar *color_string)
@@ -869,11 +869,11 @@ gstyle_color_fill (GstyleColor *src_color,
/**
* gstyle_color_copy:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
*
* A full copy of a #GstyleColor.
*
- * Returns: (transfer full): A #GstyleColor.
+ * Returns: (transfer full): a #GstyleColor.
*
*/
GstyleColor *
@@ -907,7 +907,7 @@ gstyle_color_copy (GstyleColor *self)
*
* A #GstyleColor object from #GstyleColorKind and rgba components.
*
- * Returns: A #GstyleColor.
+ * Returns: a #GstyleColor.
*
*/
GstyleColor *
@@ -936,11 +936,11 @@ gstyle_color_new (const gchar *name,
* gstyle_color_new_from_rgba:
* @name: (nullable): The name of the color. Can be %NULL
* @kind: The kind of representation as a #GstyleColorKind
- * @rgba: A #GdkRGBA
+ * @rgba: a #GdkRGBA
*
* A #GstyleColor object from a #GstyleColorKind and a #GdkRGBA object.
*
- * Returns: A #GstyleColor.
+ * Returns: a #GstyleColor.
*
*/
GstyleColor *
@@ -966,7 +966,7 @@ gstyle_color_new_from_rgba (const gchar *name,
*
* A #GstyleColor from #GstyleColorKind and rgba components.
*
- * Returns: A #GstyleColor.
+ * Returns: a #GstyleColor.
*
*/
GstyleColor *
@@ -996,7 +996,7 @@ gstyle_color_new_from_hsla (const gchar *name,
*
* A #GstyleColor object from a color string.
*
- * Returns: A #GstyleColor or %NULL if the string can't be parsed.
+ * Returns: a #GstyleColor or %NULL if the string can't be parsed.
*
*/
GstyleColor *
@@ -1030,7 +1030,7 @@ gstyle_color_new_from_string (const gchar *name,
/**
* gstyle_color_get_name:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
*
* Get the name of a #GstyleColor.
*
@@ -1047,7 +1047,7 @@ gstyle_color_get_name (GstyleColor *self)
/**
* gstyle_color_set_name:
- * @self: A #GstyleColor.
+ * @self: a #GstyleColor.
* @name: (nullable): A string
*
* Set the name of a #GstyleColor.
@@ -1073,11 +1073,11 @@ gstyle_color_set_name (GstyleColor *self,
/**
* gstyle_color_get_kind:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
*
* Get the #GstyleColorKind of a #GstyleColor.
*
- * Returns: A #GstyleColorKind.
+ * Returns: a #GstyleColorKind.
*
*/
GstyleColorKind
@@ -1090,8 +1090,8 @@ gstyle_color_get_kind (GstyleColor *self)
/**
* gstyle_color_set_kind:
- * @self: A #GstyleColor
- * @kind: A #GstyleColorKind
+ * @self: a #GstyleColor
+ * @kind: a #GstyleColorKind
*
* Set the #GstyleColorKind of a #GstyleColor.
*
@@ -1111,8 +1111,8 @@ gstyle_color_set_kind (GstyleColor *self,
/**
* gstyle_color_set_rgba:
- * @self: A #GstyleColor
- * @rgba: A #GdkRGBA
+ * @self: a #GstyleColor
+ * @rgba: a #GdkRGBA
*
* Set #GstyleColor color from a #GdkRGBA.
*
@@ -1133,7 +1133,7 @@ gstyle_color_set_rgba (GstyleColor *self,
/**
* gstyle_color_set_alpha:
- * @self: A #GstyleColor
+ * @self: a #GstyleColor
* @alpha: the new alpha value in [0,1] range
*
* Set the alpha value the the #GstyleColor.
diff --git a/src/gstyle/gstyle-eyedropper.c b/src/gstyle/gstyle-eyedropper.c
index ebb3165..53162eb 100644
--- a/src/gstyle/gstyle-eyedropper.c
+++ b/src/gstyle/gstyle-eyedropper.c
@@ -774,7 +774,7 @@ gstyle_eyedropper_class_init (GstyleEyedropperClass *klass)
/**
* GstyleEyedropper::color-picked:
- * @self: A #GstyleEyedropper.
+ * @self: a #GstyleEyedropper.
* @rgba: a #GdkRGBA color.
*
* This signal is emitted when you click to pick a color.
@@ -790,7 +790,7 @@ gstyle_eyedropper_class_init (GstyleEyedropperClass *klass)
/**
* GstyleEyedropper::grab-released:
- * @self: A #GstyleEyedropper.
+ * @self: a #GstyleEyedropper.
*
* This signal is emitted when you release the grab by hitting 'Esc'.
*/
diff --git a/src/gstyle/gstyle-palette-widget.c b/src/gstyle/gstyle-palette-widget.c
index e78ea64..74c3da8 100644
--- a/src/gstyle/gstyle-palette-widget.c
+++ b/src/gstyle/gstyle-palette-widget.c
@@ -508,7 +508,7 @@ fuzzy_search_lookup (GstylePaletteWidget *self,
* gstyle_palette_widget_fuzzy_parse_color_string:
* @color_string: color name to search for
*
- * Returns: (transfer full) (element-type GstyleColor): A #GPtrArray of #GstyleColor for a fuzzy search.
+ * Returns: (transfer full) (element-type GstyleColor): a #GPtrArray of #GstyleColor for a fuzzy search.
*/
GPtrArray *
gstyle_palette_widget_fuzzy_parse_color_string (GstylePaletteWidget *self,
@@ -577,8 +577,8 @@ gstyle_palette_widget_fuzzy_parse_color_string (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_set_placeholder:
- * @self: A #GstylePaletteWidget.
- * @placeholder: A #GtkWidget or %NULL.
+ * @self: a #GstylePaletteWidget.
+ * @placeholder: a #GtkWidget or %NULL.
*
* Set a placeholder to show when no palettes are loaded.
*
@@ -611,11 +611,11 @@ gstyle_palette_widget_set_placeholder (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_placeholder:
- * @self: A #GstylePaletteWidget.
+ * @self: a #GstylePaletteWidget.
*
* Get the current placeholder GtkWidget.
*
- * Returns: (transfer none): A #GtkObject.
+ * Returns: (transfer none): a #GtkObject.
*
*/
GtkWidget *
@@ -790,7 +790,7 @@ gstyle_palette_widget_set_selected_palette_by_id (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_selected_palette:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Return the selected #GstylePalette.
*
@@ -807,8 +807,8 @@ gstyle_palette_widget_get_selected_palette (GstylePaletteWidget *self)
/**
* gstyle_palette_widget_show_palette:
- * @self: A #GstylePaletteWidget
- * @palette: A #GstylePalette
+ * @self: a #GstylePaletteWidget
+ * @palette: a #GstylePalette
*
* Show @palette in the widget.
*
@@ -860,7 +860,7 @@ gstyle_palette_widget_color_row_activated (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_n_palettes:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Get the number of #GstylePalette in the palettes list.
*
@@ -877,12 +877,12 @@ gstyle_palette_widget_get_n_palettes (GstylePaletteWidget *self)
/**
* gstyle_palette_widget_get_palette_at_index:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
* @index: A position in the palette list, from 0 to (n - 1) palettes
*
* Get the #GstylePalette ref at position @index in the palettes list.
*
- * Returns: (transfer none): A #GstylePalette or %NULL if index is out of bounds.
+ * Returns: (transfer none): a #GstylePalette or %NULL if index is out of bounds.
*
*/
GstylePalette *
@@ -899,7 +899,7 @@ gstyle_palette_widget_get_palette_at_index (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_store:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Return a #GListStore containing the palettes.
*
@@ -916,7 +916,7 @@ gstyle_palette_widget_get_store (GstylePaletteWidget *self)
/**
* gstyle_palette_widget_get_list:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Return a #GList of the palettes.
*
@@ -945,8 +945,8 @@ gstyle_palette_widget_get_list (GstylePaletteWidget *self)
/**
* gstyle_palette_widget_add:
- * @self: A #GstylePaletteWidget
- * @palette: A #GstylePalette
+ * @self: a #GstylePaletteWidget
+ * @palette: a #GstylePalette
*
* Add @palette to the widget list.
*
@@ -993,7 +993,7 @@ gstyle_palette_widget_add (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_remove_all:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Remove all palettes in the widget list.
*
@@ -1022,8 +1022,8 @@ gstyle_palette_widget_remove_all (GstylePaletteWidget *self)
/**
* gstyle_palette_widget_remove:
- * @self: A #GstylePaletteWidget
- * @palette: A #GstylePalette
+ * @self: a #GstylePaletteWidget
+ * @palette: a #GstylePalette
*
* Remove @palette in the widget list.
*
@@ -1078,12 +1078,12 @@ gstyle_palette_widget_remove (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_palette_by_id:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
* @id: A palette id string
*
* Return the corresponding #GstylePalette if in the #GstylePaletteWidget list.
*
- * Returns: (transfer none): A #GstylePalette if in the list, %NULL otherwise.
+ * Returns: (transfer none): a #GstylePalette if in the list, %NULL otherwise.
*
*/
GstylePalette *
@@ -1111,7 +1111,7 @@ gstyle_palette_widget_get_palette_by_id (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_remove_by_id:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
* @id: A palette id string
*
* Remove palette with @id from the widget list.
@@ -1140,8 +1140,8 @@ gstyle_palette_widget_remove_by_id (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_set_view_mode:
- * @self: A #GstylePaletteWidget
- * @mode: A #GstylePaletteWidgetViewMode
+ * @self: a #GstylePaletteWidget
+ * @mode: a #GstylePaletteWidgetViewMode
*
* Sets the view mode of the palette widget.
*
@@ -1172,7 +1172,7 @@ gstyle_palette_widget_set_view_mode (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_view_mode:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Get the view mode of the palette widget.
*
@@ -1189,7 +1189,7 @@ gstyle_palette_widget_get_view_mode (GstylePaletteWidget *self)
/**
* gstyle_palette_widget_set_dnd_lock:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
* @flags: One or more #GstylePaletteWidgetDndLockFlags
*
* Sets the dnd lock flags of the palette widget.
@@ -1210,7 +1210,7 @@ gstyle_palette_widget_set_dnd_lock (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_dnd_lock:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Get the dnd lock flags of the palette widget.
*
@@ -1227,8 +1227,8 @@ gstyle_palette_widget_get_dnd_lock (GstylePaletteWidget *self)
/**
* gstyle_palette_widget_set_sort_mode:
- * @self: A #GstylePaletteWidget
- * @mode: A #GstylePaletteWidgetViewMode
+ * @self: a #GstylePaletteWidget
+ * @mode: a #GstylePaletteWidgetViewMode
*
* Sets the sort mode of the palette widget.
*
@@ -1248,7 +1248,7 @@ gstyle_palette_widget_set_sort_mode (GstylePaletteWidget *self,
/**
* gstyle_palette_widget_get_sort_mode:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
*
* Get the sort mode of the palette widget.
*
@@ -1268,7 +1268,7 @@ gstyle_palette_widget_get_sort_mode (GstylePaletteWidget *self)
*
* Create a new #GstylePaletteWidget.
*
- * Returns: A #GstylePaletteWidget.
+ * Returns: a #GstylePaletteWidget.
*
*/
GstylePaletteWidget *
@@ -1535,7 +1535,7 @@ gstyle_palette_widget_class_init (GstylePaletteWidgetClass *klass)
/**
* GstylePaletteWidget::activated:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
* @palette: a #GstylePalette
* @position: a position in the #palette
*
@@ -1553,7 +1553,7 @@ gstyle_palette_widget_class_init (GstylePaletteWidgetClass *klass)
/**
* GstylePaletteWidget::palette-added:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
* @palette: a #GstylePalette
*
* This signal is emitted when a palette is added to the palette widget.
@@ -1569,7 +1569,7 @@ gstyle_palette_widget_class_init (GstylePaletteWidgetClass *klass)
/**
* GstylePaletteWidget::palette-removed:
- * @self: A #GstylePaletteWidget
+ * @self: a #GstylePaletteWidget
* @palette: a #GstylePalette
*
* This signal is emitted when a palette is removed to the palette widget.
diff --git a/src/gstyle/gstyle-palette.c b/src/gstyle/gstyle-palette.c
index fa0006f..9c0cfb1 100644
--- a/src/gstyle/gstyle-palette.c
+++ b/src/gstyle/gstyle-palette.c
@@ -248,7 +248,7 @@ remove_color_to_names_sets (GstylePalette *self,
/**
* gstyle_palette_add_at_index:
* @self: a #GstylePalette
- * @color: A #GstyleColor
+ * @color: a #GstyleColor
* @position: Position to insert the new color, from 0 to gstyle_palette_get_len() -1,
* or -1 to append it
* @error: (nullable): a #GError location or %NULL
@@ -297,7 +297,7 @@ gstyle_palette_add_at_index (GstylePalette *self,
/**
* gstyle_palette_add:
* @self: a #GstylePalette
- * @color: A #GstyleColor
+ * @color: a #GstyleColor
* @error: (nullable): a #GError location or %NULL
*
* Add a #GstyleColor to the palette.
@@ -355,7 +355,7 @@ gstyle_palette_remove_at_index (GstylePalette *self,
/**
* gstyle_palette_remove:
* @self: a #GstylePalette
- * @color: A #GstyleColor
+ * @color: a #GstyleColor
*
* Try to remove a #GstyleColor from the palette.
*
@@ -390,7 +390,7 @@ gstyle_palette_remove (GstylePalette *self,
/**
* gstyle_palette_lookup:
* @self: a #GstylePalette
- * @name: A #GstyleColor name
+ * @name: a #GstyleColor name
*
* Search for one or several #GstyleColor named @name in the palette.
*
@@ -413,7 +413,7 @@ gstyle_palette_lookup (GstylePalette *self,
/**
* gstyle_palette_get_index:
* @self: a #GstylePalette
- * @color: A #GstyleColor
+ * @color: a #GstyleColor
*
* Search for a #GstyleColor in the palette and
* return its index or -1 if not found.
@@ -737,12 +737,12 @@ finish:
/**
* gstyle_palette_new_from_file:
* @file: a #GFile
- * @cancellable: A #GCancellable
+ * @cancellable: a #GCancellable
* @error: (nullable): a #GError location or %NULL
*
* Load a palette from an .xml or .gpl file.
*
- * Returns: A #GstylePalette.
+ * Returns: a #GstylePalette.
*/
GstylePalette *
gstyle_palette_new_from_file (GFile *file,
@@ -780,14 +780,14 @@ gstyle_palette_new_from_file (GFile *file,
* @buffer: a #GtkTextBUffer
* @begin: (nullable): a begin #GtkTextIter
* @end: (nullable): a end #GtkTextIter
- * @cancellable: A #GCancellable
+ * @cancellable: a #GCancellable
* @error: (nullable): a #GError location or %NULL
*
* Create a new #GstylePalette from a text buffer.
* if @begin is %NULL, the buffer start iter is used.
* if @end is %NULL, the buffer end is used.
*
- * Returns: A #GstylePalette or %NULL if an error occur.
+ * Returns: a #GstylePalette or %NULL if an error occur.
*/
GstylePalette *
gstyle_palette_new_from_buffer (GtkTextBuffer *buffer,
diff --git a/src/libide/application/ide-application-tool.c b/src/libide/application/ide-application-tool.c
index 409383f..9fde5f7 100644
--- a/src/libide/application/ide-application-tool.c
+++ b/src/libide/application/ide-application-tool.c
@@ -53,7 +53,7 @@ ide_application_tool_default_init (IdeApplicationToolInterface *iface)
* ide_application_tool_run_async:
* @self: An #IdeApplicationTool
* @arguments: (array zero-terminated=1) (element-type utf8): argv for the command
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: A callback to execute upon completion
* @user_data: User data for @callback
*
diff --git a/src/libide/application/ide-application.c b/src/libide/application/ide-application.c
index fbf8730..fe23260 100644
--- a/src/libide/application/ide-application.c
+++ b/src/libide/application/ide-application.c
@@ -629,8 +629,8 @@ ide_application_get_worker_cb (GObject *object,
* ide_application_get_worker_async:
* @self: an #IdeApplication
* @plugin_name: The name of the plugin.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback or %NULL.
* @user_data: user data for @callback.
*
* Asynchronously requests a #GDBusProxy to a service provided in a worker
@@ -674,12 +674,12 @@ ide_application_get_worker_async (IdeApplication *self,
/**
* ide_application_get_worker_finish:
* @self: an #IdeApplication.
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError, or %NULL.
*
* Completes an asynchronous request to get a proxy to a worker process.
*
- * Returns: (transfer full): A #GDBusProxy or %NULL.
+ * Returns: (transfer full): a #GDBusProxy or %NULL.
*/
GDBusProxy *
ide_application_get_worker_finish (IdeApplication *self,
@@ -786,7 +786,7 @@ ide_application_get_keybindings_mode (IdeApplication *self)
*
* Gets the startup time of the application.
*
- * Returns: (transfer none): A #GDateTime.
+ * Returns: (transfer none): a #GDateTime.
*/
GDateTime *
ide_application_get_started_at (IdeApplication *self)
@@ -797,7 +797,7 @@ ide_application_get_started_at (IdeApplication *self)
/**
* ide_application_open_project:
* @self: a #IdeApplication
- * @file: A #GFile
+ * @file: a #GFile
*
* Attempts to load the project found at @file.
*
@@ -868,7 +868,7 @@ ide_application_open_project (IdeApplication *self,
* This is only really useful to determine if you are in the main UI thread.
* This is used by IDE_IS_MAIN_THREAD for assertion checks.
*
- * Returns: (transfer none): A #GThread
+ * Returns: (transfer none): a #GThread
*/
GThread *
ide_application_get_main_thread (void)
@@ -879,7 +879,7 @@ ide_application_get_main_thread (void)
/**
* ide_application_add_reaper:
* @self: a #IdeApplication
- * @reaper: A #DzlDirectoryReaper
+ * @reaper: a #DzlDirectoryReaper
*
* Adds a directory reaper which will be executed as part of the cleanup
* process when exiting Builder.
diff --git a/src/libide/buffers/ide-buffer-manager.c b/src/libide/buffers/ide-buffer-manager.c
index 39c55cb..5b8d434 100644
--- a/src/libide/buffers/ide-buffer-manager.c
+++ b/src/libide/buffers/ide-buffer-manager.c
@@ -1734,7 +1734,7 @@ unregister_auto_save (IdeBufferManager *self,
*
* Buffers are generally not added to the buffer list until they have been loaded.
*
- * Returns: (transfer container) (element-type IdeBuffer*): A #GPtrArray of buffers.
+ * Returns: (transfer container) (element-type IdeBuffer*): a #GPtrArray of buffers.
*/
GPtrArray *
ide_buffer_manager_get_buffers (IdeBufferManager *self)
@@ -1764,7 +1764,7 @@ ide_buffer_manager_get_buffers (IdeBufferManager *self)
* Gets the #GtkSourceCompletionWords completion provider that will complete
* words using the loaded documents.
*
- * Returns: (transfer none): A #GtkSourceCompletionWords
+ * Returns: (transfer none): a #GtkSourceCompletionWords
*/
GtkSourceCompletionWords *
ide_buffer_manager_get_word_completion (IdeBufferManager *self)
@@ -1777,7 +1777,7 @@ ide_buffer_manager_get_word_completion (IdeBufferManager *self)
/**
* ide_buffer_manager_find_buffer:
* @self: (in): An #IdeBufferManager.
- * @file: (in): A #GFile.
+ * @file: (in): a #GFile.
*
* Gets the buffer for a given file. If it has not yet been loaded, %NULL is
* returned.
@@ -1833,7 +1833,7 @@ ide_buffer_manager_has_file (IdeBufferManager *self,
*
* If zero, no size limits will be enforced.
*
- * Returns: A #gsize in bytes or zero.
+ * Returns: a #gsize in bytes or zero.
*/
gsize
ide_buffer_manager_get_max_file_size (IdeBufferManager *self)
@@ -2206,7 +2206,7 @@ ide_buffer_manager_apply_edits_buffer_loaded (GObject *object,
* ide_buffer_manager_apply_edits_async:
* @self: An #IdeBufferManager
* @edits: (transfer container) (element-type Ide.ProjectEdit): An #GPtrArray of #IdeProjectEdit
- * @cancellable: (allow-none): A #GCancellable or %NULL
+ * @cancellable: (allow-none): a #GCancellable or %NULL
* @callback: the callback to complete the request
* @user_data: user data for @callback
*
diff --git a/src/libide/buffers/ide-buffer.c b/src/libide/buffers/ide-buffer.c
index 2f8e049..9073154 100644
--- a/src/libide/buffers/ide-buffer.c
+++ b/src/libide/buffers/ide-buffer.c
@@ -1661,7 +1661,7 @@ ide_buffer_class_init (IdeBufferClass *klass)
/**
* IdeBuffer::cursor-moved:
* @self: An #IdeBuffer.
- * @location: A #GtkTextIter.
+ * @location: a #GtkTextIter.
*
* This signal is emitted when the insertion location has moved. You might
* want to attach to this signal to update the location of the insert mark in
@@ -2121,7 +2121,7 @@ ide_buffer_can_do_newline_hack (IdeBuffer *self,
* Additionally, this allows the buffer to update the state in #IdeUnsavedFiles if the content
* is out of sync.
*
- * Returns: (transfer full): A #GBytes containing the buffer content.
+ * Returns: (transfer full): a #GBytes containing the buffer content.
*/
GBytes *
ide_buffer_get_content (IdeBuffer *self)
@@ -2657,9 +2657,9 @@ ide_buffer_get_symbol_at_location_cb (GObject *object,
* ide_buffer_get_symbol_at_location_async:
* @self: an #IdeBuffer.
* @location: a #GtkTextIter indicating a position to search for a symbol.
- * @cancellable: A #GCancellable.
- * @callback: A #GAsyncReadyCallback.
- * @user_data: A #gpointer to hold user data.
+ * @cancellable: a #GCancellable.
+ * @callback: a #GAsyncReadyCallback.
+ * @user_data: a #gpointer to hold user data.
*
* Asynchronously get a possible symbol at @location.
*
@@ -2729,8 +2729,8 @@ ide_buffer_get_symbol_at_location_async (IdeBuffer *self,
/**
* ide_buffer_get_symbol_at_location_finish:
* @self: an #IdeBuffer.
- * @result: A #GAsyncResult.
- * @error: (out): A #GError.
+ * @result: a #GAsyncResult.
+ * @error: (out): a #GError.
*
* Completes an asynchronous request to locate a symbol at a location.
*
@@ -2751,7 +2751,7 @@ ide_buffer_get_symbol_at_location_finish (IdeBuffer *self,
* ide_buffer_get_symbols_finish:
* @self: an #IdeBuffer.
*
- * Returns: (transfer container) (element-type IdeSymbol*): A #GPtrArray if successful;
+ * Returns: (transfer container) (element-type IdeSymbol*): a #GPtrArray if successful;
* otherwise %NULL.
*/
GPtrArray *
@@ -2842,8 +2842,8 @@ ide_buffer_release (IdeBuffer *self)
/**
* ide_buffer_get_selection_bounds:
* @self: an #IdeBuffer.
- * @insert: (out): A #GtkTextIter to get the insert position.
- * @selection: (out): A #GtkTextIter to get the selection position.
+ * @insert: (out): a #GtkTextIter to get the insert position.
+ * @selection: (out): a #GtkTextIter to get the selection position.
*
* This function acts like gtk_text_buffer_get_selection_bounds() except that it always
* places the location of the insert mark at @insert and the location of the selection
@@ -2916,7 +2916,7 @@ ide_buffer_get_symbol_resolvers (IdeBuffer *self)
/**
* ide_buffer_get_word_at_iter:
* @self: an #IdeBuffer.
- * @iter: A #GtkTextIter.
+ * @iter: a #GtkTextIter.
*
* Gets the word found under the position denoted by @iter.
*
diff --git a/src/libide/buffers/ide-unsaved-file.c b/src/libide/buffers/ide-unsaved-file.c
index ba80f9e..7f4ed32 100644
--- a/src/libide/buffers/ide-unsaved-file.c
+++ b/src/libide/buffers/ide-unsaved-file.c
@@ -132,7 +132,7 @@ ide_unsaved_file_unref (IdeUnsavedFile *self)
*
* Gets the contents of the unsaved file.
*
- * Returns: (transfer none): A #GBytes containing the unsaved file content.
+ * Returns: (transfer none): a #GBytes containing the unsaved file content.
*/
GBytes *
ide_unsaved_file_get_content (IdeUnsavedFile *self)
@@ -147,7 +147,7 @@ ide_unsaved_file_get_content (IdeUnsavedFile *self)
*
* Retrieves the underlying file represented by @self.
*
- * Returns: (transfer none): A #GFile.
+ * Returns: (transfer none): a #GFile.
*/
GFile *
ide_unsaved_file_get_file (IdeUnsavedFile *self)
diff --git a/src/libide/buffers/ide-unsaved-files.c b/src/libide/buffers/ide-unsaved-files.c
index 485448d..a91eaca 100644
--- a/src/libide/buffers/ide-unsaved-files.c
+++ b/src/libide/buffers/ide-unsaved-files.c
@@ -643,7 +643,7 @@ ide_unsaved_files_update (IdeUnsavedFiles *self,
* If you would like to hold onto an unsaved file instance, call
* ide_unsaved_file_ref() to increment its reference count.
*
- * Returns: (transfer container) (element-type IdeUnsavedFile*): A #GPtrArray
+ * Returns: (transfer container) (element-type IdeUnsavedFile*): a #GPtrArray
* containing #IdeUnsavedFile elements.
*/
GPtrArray *
diff --git a/src/libide/buildsystem/ide-build-manager.c b/src/libide/buildsystem/ide-build-manager.c
index bc59012..78c42ef 100644
--- a/src/libide/buildsystem/ide-build-manager.c
+++ b/src/libide/buildsystem/ide-build-manager.c
@@ -989,7 +989,7 @@ ide_build_manager_get_message (IdeBuildManager *self)
*
* See #IdeBuildManager:last-build-time for more information.
*
- * Returns: (nullable) (transfer none): A #GDateTime or %NULL.
+ * Returns: (nullable) (transfer none): a #GDateTime or %NULL.
*
* Since: 3.22
*/
@@ -1007,7 +1007,7 @@ ide_build_manager_get_last_build_time (IdeBuildManager *self)
* Gets the amount of elapsed time of the current build as a
* #GTimeSpan.
*
- * Returns: A #GTimeSpan containing the elapsed time of the build.
+ * Returns: a #GTimeSpan containing the elapsed time of the build.
*
* Since: 3.22
*/
@@ -1146,7 +1146,7 @@ ide_build_manager_save_all_cb (GObject *object,
* ide_build_manager_execute_async:
* @self: An #IdeBuildManager
* @phase: An #IdeBuildPhase or 0
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: A callback to execute upon completion
* @user_data: user data for @callback
*
@@ -1248,7 +1248,7 @@ ide_build_manager_execute_async (IdeBuildManager *self,
/**
* ide_build_manager_execute_finish:
* @self: An #IdeBuildManager
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: A location for a #GError or %NULL
*
* Completes a request to ide_build_manager_execute_async().
@@ -1303,7 +1303,7 @@ ide_build_manager_clean_cb (GObject *object,
* ide_build_manager_clean_async:
* @self: a #IdeBuildManager
* @phase: the build phase to clean
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: (nullable): a callback to execute upon completion, or %NULL
* @user_data: closure data for @callback
*
@@ -1365,7 +1365,7 @@ ide_build_manager_clean_async (IdeBuildManager *self,
/**
* ide_build_manager_clean_finish:
* @self: a #IdeBuildManager
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError, or %NULL
*
* Completes an asynchronous request to ide_build_manager_clean_async().
@@ -1418,7 +1418,7 @@ ide_build_manager_rebuild_cb (GObject *object,
* ide_build_manager_rebuild_async:
* @self: a #IdeBuildManager
* @phase: the build phase to rebuild to
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: (nullable): a callback to execute upon completion, or %NULL
* @user_data: closure data for @callback
*
@@ -1474,7 +1474,7 @@ ide_build_manager_rebuild_async (IdeBuildManager *self,
/**
* ide_build_manager_rebuild_finish:
* @self: a #IdeBuildManager
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError, or %NULL
*
* Completes an asynchronous request to ide_build_manager_rebuild_async().
diff --git a/src/libide/buildsystem/ide-build-pipeline.c b/src/libide/buildsystem/ide-build-pipeline.c
index 854d39b..06f7cdb 100644
--- a/src/libide/buildsystem/ide-build-pipeline.c
+++ b/src/libide/buildsystem/ide-build-pipeline.c
@@ -1460,7 +1460,7 @@ ide_build_pipeline_task_notify_completed (IdeBuildPipeline *self,
* ide_build_pipeline_build_async:
* @self: A @IdeBuildPipeline
* @phase: the requested build phase
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: a callback to execute upon completion
* @user_data: data for @callback
*
@@ -1543,7 +1543,7 @@ short_circuit:
/**
* ide_build_pipeline_build_finish:
* @self: An #IdeBuildPipeline
- * @result: A #GAsyncResult provided to callback
+ * @result: a #GAsyncResult provided to callback
* @error: A location for a #GError, or %NULL
*
* This function completes the asynchronous request to build
@@ -1575,7 +1575,7 @@ ide_build_pipeline_build_finish (IdeBuildPipeline *self,
/**
* ide_build_pipeline_execute_async:
* @self: A @IdeBuildPipeline
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: a callback to execute upon completion
* @user_data: data for @callback
*
diff --git a/src/libide/buildsystem/ide-build-stage.h b/src/libide/buildsystem/ide-build-stage.h
index aeafd66..7053b4b 100644
--- a/src/libide/buildsystem/ide-build-stage.h
+++ b/src/libide/buildsystem/ide-build-stage.h
@@ -78,7 +78,7 @@ struct _IdeBuildStageClass
* IdeBuildStage::clean_async:
* @self: an #IdeBuildStage
* @pipeline: An #IdeBuildPipeline
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: An async callback
* @user_data: user data for @callback
*
@@ -93,7 +93,7 @@ struct _IdeBuildStageClass
/**
* IdeBuildStage::clean_finish:
* @self: an #IdeBuildStage
- * @result: A #GErrorResult
+ * @result: a #GErrorResult
* @error: A location for a #GError or %NULL.
*
* Completes an async operation to ide_build_stage_clean_async().
@@ -108,7 +108,7 @@ struct _IdeBuildStageClass
* IdeBuildStage::query:
* @self: An #IdeBuildStage
* @pipeline: An #IdeBuildPipeline
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
*
* The #IdeBuildStage::query signal is emitted to request that the
* build stage update its completed stage from any external resources.
diff --git a/src/libide/buildsystem/ide-build-system-discovery.c
b/src/libide/buildsystem/ide-build-system-discovery.c
index 441f8a9..48b1803 100644
--- a/src/libide/buildsystem/ide-build-system-discovery.c
+++ b/src/libide/buildsystem/ide-build-system-discovery.c
@@ -30,8 +30,8 @@ ide_build_system_discovery_default_init (IdeBuildSystemDiscoveryInterface *iface
/**
* ide_build_system_discovery_discover:
* @self: An #IdeBuildSystemDiscovery
- * @project_file: A #GFile containing the project file (a directory)
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @project_file: a #GFile containing the project file (a directory)
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @priority: (out): A location for the priority
* @error: a location for a #GError or %NULL
*
diff --git a/src/libide/buildsystem/ide-build-system.c b/src/libide/buildsystem/ide-build-system.c
index ab6ce96..75d09f7 100644
--- a/src/libide/buildsystem/ide-build-system.c
+++ b/src/libide/buildsystem/ide-build-system.c
@@ -269,9 +269,9 @@ sort_priority (gconstpointer a,
/**
* ide_build_system_new_async:
* @context: #IdeBuildSystem
- * @project_file: A #GFile containing the directory or project file.
+ * @project_file: a #GFile containing the directory or project file.
* @build_system_hint: A hint for the build system to use
- * @cancellable: (allow-none): A #GCancellable
+ * @cancellable: (allow-none): a #GCancellable
* @callback: A callback to execute upon completion
* @user_data: User data for @callback.
*
@@ -474,7 +474,7 @@ ide_build_system_get_build_flags_finish (IdeBuildSystem *self,
* ide_build_system_get_build_flags_for_files_async:
* @self: An #IdeBuildSystem instance.
* @files: (element-type Ide.File): array of files whose build flags has to be retrieved.
- * @cancellable: (allow-none): A #GCancellable to cancel getting build flags.
+ * @cancellable: (allow-none): a #GCancellable to cancel getting build flags.
* @callback: function to be called after getting build flags.
* @user_data: data to pass to @callback.
*
diff --git a/src/libide/buildsystem/ide-build-target.c b/src/libide/buildsystem/ide-build-target.c
index 565cd11..144c3ce 100644
--- a/src/libide/buildsystem/ide-build-target.c
+++ b/src/libide/buildsystem/ide-build-target.c
@@ -30,7 +30,7 @@ ide_build_target_default_init (IdeBuildTargetInterface *iface)
/**
* ide_build_target_get_install_directory:
*
- * Returns: (nullable) (transfer full): A #GFile or %NULL.
+ * Returns: (nullable) (transfer full): a #GFile or %NULL.
*/
GFile *
ide_build_target_get_install_directory (IdeBuildTarget *self)
diff --git a/src/libide/buildsystem/ide-compile-commands.c b/src/libide/buildsystem/ide-compile-commands.c
index 6411a09..78ecbe0 100644
--- a/src/libide/buildsystem/ide-compile-commands.c
+++ b/src/libide/buildsystem/ide-compile-commands.c
@@ -279,8 +279,8 @@ ide_compile_commands_load_worker (GTask *task,
/**
* ide_compile_commands_load:
* @self: An #IdeCompileCommands
- * @file: A #GFile
- * @cancellable: (nullable): A #GCancellable, or %NULL
+ * @file: a #GFile
+ * @cancellable: (nullable): a #GCancellable, or %NULL
* @error: A location for a #GError, or %NULL
*
* Synchronously loads the contents of the requested @file and parses
@@ -328,8 +328,8 @@ ide_compile_commands_load (IdeCompileCommands *self,
/**
* ide_compile_commands_load_async:
* @self: An #IdeCompileCommands
- * @file: A #GFile
- * @cancellable: (nullable): A #GCancellable, or %NULL
+ * @file: a #GFile
+ * @cancellable: (nullable): a #GCancellable, or %NULL
* @callback: the callback for the async operation
* @user_data: user data for @callback
*
@@ -374,7 +374,7 @@ ide_compile_commands_load_async (IdeCompileCommands *self,
/**
* ide_compile_commands_load_finish:
* @self: An #IdeCompileCommands
- * @result: A #GAsyncResult provided to the callback
+ * @result: a #GAsyncResult provided to the callback
* @error: A location for a #GError, or %NULL
*
* Completes an asynchronous request to ide_compile_commands_load_async().
@@ -584,7 +584,7 @@ ide_compile_commands_filter_vala (IdeCompileCommands *self,
/**
* ide_compile_commands_lookup:
* @self: An #IdeCompileCommands
- * @file: A #GFile representing the file to lookup
+ * @file: a #GFile representing the file to lookup
* @directory: (out) (optional) (transfer full): A location for a #GFile, or %NULL
* @error: A location for a #GError, or %NULL
*
diff --git a/src/libide/buildsystem/ide-configuration.c b/src/libide/buildsystem/ide-configuration.c
index f870f42..4723e1d 100644
--- a/src/libide/buildsystem/ide-configuration.c
+++ b/src/libide/buildsystem/ide-configuration.c
@@ -1521,7 +1521,7 @@ ide_configuration_set_internal_int64 (IdeConfiguration *self,
*
* Gets the value associated with @key if it is a #GObject.
*
- * Returns: (nullable) (transfer none) (type GObject.Object): A #GObject or %NULL.
+ * Returns: (nullable) (transfer none) (type GObject.Object): a #GObject or %NULL.
*/
gpointer
ide_configuration_get_internal_object (IdeConfiguration *self,
@@ -1545,7 +1545,7 @@ ide_configuration_get_internal_object (IdeConfiguration *self,
* ide_configuration_set_internal_object:
* @self: an #IdeConfiguration
* @key: the key to set
- * @instance: (type GObject.Object) (nullable): A #GObject or %NULL
+ * @instance: (type GObject.Object) (nullable): a #GObject or %NULL
*
* Sets the value for @key to @instance.
*/
diff --git a/src/libide/debugger/ide-debugger-breakpoints.c b/src/libide/debugger/ide-debugger-breakpoints.c
index 9fcce40..6f2f256 100644
--- a/src/libide/debugger/ide-debugger-breakpoints.c
+++ b/src/libide/debugger/ide-debugger-breakpoints.c
@@ -365,7 +365,7 @@ _ide_debugger_breakpoints_remove (IdeDebuggerBreakpoints *self,
* Gets the "file" property, which is the file that breakpoints within
* this container belong to.
*
- * Returns: (transfer none): A #GFile
+ * Returns: (transfer none): a #GFile
*/
GFile *
ide_debugger_breakpoints_get_file (IdeDebuggerBreakpoints *self)
@@ -378,7 +378,7 @@ ide_debugger_breakpoints_get_file (IdeDebuggerBreakpoints *self)
/**
* ide_debugger_breakpoints_foreach:
* @self: a #IdeDebuggerBreakpoints
- * @func: (scope call) (closure user_data): A #GFunc to call
+ * @func: (scope call) (closure user_data): a #GFunc to call
* @user_data: user data for @func
*
* Call @func for every #IdeDebuggerBreakpoint in @self.
diff --git a/src/libide/debugger/ide-debugger-library.c b/src/libide/debugger/ide-debugger-library.c
index 160288d..579eec2 100644
--- a/src/libide/debugger/ide-debugger-library.c
+++ b/src/libide/debugger/ide-debugger-library.c
@@ -226,7 +226,7 @@ ide_debugger_library_set_target_name (IdeDebuggerLibrary *self,
*
* Gets the list of address ranges for the library.
*
- * Returns: (transfer none) (element-type Ide.DebuggerAddressRange): A #GPtrArray
+ * Returns: (transfer none) (element-type Ide.DebuggerAddressRange): a #GPtrArray
* containing the list of address ranges.
*/
GPtrArray *
diff --git a/src/libide/debugger/ide-debugger.c b/src/libide/debugger/ide-debugger.c
index 15520c5..05d9b9a 100644
--- a/src/libide/debugger/ide-debugger.c
+++ b/src/libide/debugger/ide-debugger.c
@@ -881,7 +881,7 @@ ide_debugger_get_can_move (IdeDebugger *self,
* ide_debugger_move_async:
* @self: a #IdeDebugger
* @movement: An #IdeDebuggerMovement
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: (scope async) (closure user_data): A callback to call upon
* completion of the operation.
* @user_data: user data for @callback
@@ -908,7 +908,7 @@ ide_debugger_move_async (IdeDebugger *self,
/**
* ide_debugger_move_finish:
* @self: a #IdeDebugger
- * @result: A #GAsyncResult provided to the callback
+ * @result: a #GAsyncResult provided to the callback
* @error: A location for a #GError, or %NULL
*
* Notifies that the movement request has been submitted to the debugger.
@@ -1259,7 +1259,7 @@ ide_debugger_emit_library_unloaded (IdeDebugger *self,
/**
* ide_debugger_list_breakpoints_async:
* @self: An #IdeDebugger
- * @cancellable: (nullable): A #GCancellable, or %NULL
+ * @cancellable: (nullable): a #GCancellable, or %NULL
* @callback: a callback to call upon completion
* @user_data: user data for @callback
*
@@ -1285,12 +1285,12 @@ ide_debugger_list_breakpoints_async (IdeDebugger *self,
/**
* ide_debugger_list_breakpoints_finish:
* @self: An #IdeDebugger
- * @result: A #GAsyncResult provided to the async callback
+ * @result: a #GAsyncResult provided to the async callback
* @error: a location for a #GError or %NULL
*
* Gets the list of breakpoints from the debugger.
*
- * Returns: (transfer container) (element-type Ide.DebuggerBreakpoint): A #GPtrArray
+ * Returns: (transfer container) (element-type Ide.DebuggerBreakpoint): a #GPtrArray
* of breakpoints that are registered with the debugger.
*
* Since: 3.26
@@ -1310,7 +1310,7 @@ ide_debugger_list_breakpoints_finish (IdeDebugger *self,
* ide_debugger_insert_breakpoint_async:
* @self: An #IdeDebugger
* @breakpoint: An #IdeDebuggerBreakpoint
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: an async callback to complete the operation
* @user_data: user data for @callback
*
@@ -1343,8 +1343,8 @@ ide_debugger_insert_breakpoint_async (IdeDebugger *self,
/**
* ide_debugger_insert_breakpoint_finish:
* @self: An #IdeDebugger
- * @result: A #GAsyncResult or %NULL
- * @error: A #GError, or %NULL
+ * @result: a #GAsyncResult or %NULL
+ * @error: a #GError, or %NULL
*
* Completes a request to asynchronously insert a breakpoint.
*
@@ -1370,7 +1370,7 @@ ide_debugger_insert_breakpoint_finish (IdeDebugger *self,
* ide_debugger_remove_breakpoint_async:
* @self: An #IdeDebugger
* @breakpoint: An #IdeDebuggerBreakpoint
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: an async callback to complete the operation
* @user_data: user data for @callback
*
@@ -1403,8 +1403,8 @@ ide_debugger_remove_breakpoint_async (IdeDebugger *self,
/**
* ide_debugger_remove_breakpoint_finish:
* @self: An #IdeDebugger
- * @result: A #GAsyncResult or %NULL
- * @error: A #GError, or %NULL
+ * @result: a #GAsyncResult or %NULL
+ * @error: a #GError, or %NULL
*
* Completes a request to asynchronously remove a breakpoint.
*
@@ -1430,7 +1430,7 @@ ide_debugger_remove_breakpoint_finish (IdeDebugger *self,
* @self: An #IdeDebugger
* @change: An #IdeDebuggerBreakpointChange
* @breakpoint: An #IdeDebuggerBreakpoint
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: an async callback to complete the operation
* @user_data: user data for @callback
*
@@ -1506,7 +1506,7 @@ ide_debugger_modify_breakpoint_finish (IdeDebugger *self,
* This is primarily out of convenience to be used by UI which wants to
* display information on breakpoints.
*
- * Returns: (transfer none) (not nullable): A #GListModel of #IdeDebuggerBreakpoint
+ * Returns: (transfer none) (not nullable): a #GListModel of #IdeDebuggerBreakpoint
*/
GListModel *
ide_debugger_get_breakpoints (IdeDebugger *self)
@@ -1527,7 +1527,7 @@ ide_debugger_get_breakpoints (IdeDebugger *self)
* The resulting #GListModel accuracy is based on the #IdeDebugger
* implementation emitting varous thread-group modification signals correctly.
*
- * Returns: (transfer none) (not nullable): A #GListModel of #IdeDebuggerThreadGroup
+ * Returns: (transfer none) (not nullable): a #GListModel of #IdeDebuggerThreadGroup
*/
GListModel *
ide_debugger_get_thread_groups (IdeDebugger *self)
@@ -1548,7 +1548,7 @@ ide_debugger_get_thread_groups (IdeDebugger *self)
* The resulting #GListModel accuracy is based on the #IdeDebugger
* implementation emitting varous thread modification signals correctly.
*
- * Returns: (transfer none) (not nullable): A #GListModel of #IdeDebuggerThread
+ * Returns: (transfer none) (not nullable): a #GListModel of #IdeDebuggerThread
*/
GListModel *
ide_debugger_get_threads (IdeDebugger *self)
@@ -1617,7 +1617,7 @@ ide_debugger_get_selected_thread (IdeDebugger *self)
* ide_debugger_interrupt_async:
* @self: a #IdeDebugger
* @thread_group: (nullable): An #IdeDebuggerThreadGroup
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: (closure user_data): a callback to execute upon completion
* @user_data: closure data for @callback
*
@@ -1738,7 +1738,7 @@ ide_debugger_locate_binary_at_address (IdeDebugger *self,
* @self: an #IdeDebugger
* @thread: an #IdeDebuggerThread
* @frame: an #IdeDebuggerFrame
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: A callback to call once the operation has finished
* @user_data: user data for @callback
*
@@ -1771,12 +1771,12 @@ ide_debugger_list_locals_async (IdeDebugger *self,
/**
* ide_debugger_list_locals_finish:
* @self: a #IdeDebugger
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError or %NULL
*
* Completes an asynchronous request to ide_debugger_list_locals_async().
*
- * Returns: (transfer container) (element-type Ide.DebuggerVariable): A #GPtrArray of
+ * Returns: (transfer container) (element-type Ide.DebuggerVariable): a #GPtrArray of
* #IdeDebuggerVariable if successful; otherwise %NULL and error is set.
*
* Since: 3.26
@@ -1797,7 +1797,7 @@ ide_debugger_list_locals_finish (IdeDebugger *self,
* @self: an #IdeDebugger
* @thread: an #IdeDebuggerThread
* @frame: an #IdeDebuggerFrame
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: A callback to call once the operation has finished
* @user_data: user data for @callback
*
@@ -1830,12 +1830,12 @@ ide_debugger_list_params_async (IdeDebugger *self,
/**
* ide_debugger_list_params_finish:
* @self: a #IdeDebugger
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError or %NULL
*
* Completes an asynchronous request to ide_debugger_list_params_async().
*
- * Returns: (transfer container) (element-type Ide.DebuggerVariable): A #GPtrArray of
+ * Returns: (transfer container) (element-type Ide.DebuggerVariable): a #GPtrArray of
* #IdeDebuggerVariable if successful; otherwise %NULL and error is set.
*
* Since: 3.26
@@ -1854,7 +1854,7 @@ ide_debugger_list_params_finish (IdeDebugger *self,
/**
* ide_debugger_list_registers_async:
* @self: an #IdeDebugger
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: A callback to call once the operation has finished
* @user_data: user data for @callback
*
@@ -1877,12 +1877,12 @@ ide_debugger_list_registers_async (IdeDebugger *self,
/**
* ide_debugger_list_registers_finish:
* @self: a #IdeDebugger
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError or %NULL
*
* Completes an asynchronous request to ide_debugger_list_registers_async().
*
- * Returns: (transfer container) (element-type Ide.DebuggerRegister): A #GPtrArray of
+ * Returns: (transfer container) (element-type Ide.DebuggerRegister): a #GPtrArray of
* #IdeDebuggerRegister if successful; otherwise %NULL and error is set.
*
* Since: 3.26
@@ -1902,7 +1902,7 @@ ide_debugger_list_registers_finish (IdeDebugger *self,
* ide_debugger_disassemble_async:
* @self: an #IdeDebugger
* @range: an #IdeDebuggerAddressRange to disassemble
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: A callback to call once the operation has finished
* @user_data: user data for @callback
*
@@ -1927,12 +1927,12 @@ ide_debugger_disassemble_async (IdeDebugger *self,
/**
* ide_debugger_disassemble_finish:
* @self: a #IdeDebugger
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError or %NULL
*
* Completes an asynchronous request to ide_debugger_disassemble_async().
*
- * Returns: (transfer container) (element-type Ide.DebuggerInstruction): A #GPtrArray
+ * Returns: (transfer container) (element-type Ide.DebuggerInstruction): a #GPtrArray
* of #IdeDebuggerInstruction if successful; otherwise %NULL and error is set.
*
* Since: 3.26
diff --git a/src/libide/devices/ide-device-provider.c b/src/libide/devices/ide-device-provider.c
index 350f51c..e7fe020 100644
--- a/src/libide/devices/ide-device-provider.c
+++ b/src/libide/devices/ide-device-provider.c
@@ -94,7 +94,7 @@ ide_device_provider_get_settled (IdeDeviceProvider *provider)
*
* Retrieves a list of devices currently managed by @provider.
*
- * Returns: (transfer container) (element-type IdeDevice*): A #GPtrArray of
+ * Returns: (transfer container) (element-type IdeDevice*): a #GPtrArray of
* #IdeDevice instances.
*/
GPtrArray *
diff --git a/src/libide/diagnostics/ide-diagnostic.c b/src/libide/diagnostics/ide-diagnostic.c
index 71afe5d..809e289 100644
--- a/src/libide/diagnostics/ide-diagnostic.c
+++ b/src/libide/diagnostics/ide-diagnostic.c
@@ -375,7 +375,7 @@ ide_diagnostic_compare (const IdeDiagnostic *a,
* the diagnostic is within. It is equivalent to getting the source
* location and looking at the file.
*
- * Returns: (nullable) (transfer none): A #GFile or %NULL.
+ * Returns: (nullable) (transfer none): a #GFile or %NULL.
*/
GFile *
ide_diagnostic_get_file (IdeDiagnostic *self)
diff --git a/src/libide/diagnostics/ide-diagnostics-manager.c
b/src/libide/diagnostics/ide-diagnostics-manager.c
index 9c5d269..3fbccee 100644
--- a/src/libide/diagnostics/ide-diagnostics-manager.c
+++ b/src/libide/diagnostics/ide-diagnostics-manager.c
@@ -1198,7 +1198,7 @@ ide_diagnostics_manager_get_busy (IdeDiagnosticsManager *self)
/**
* ide_diagnostics_manager_get_diagnostics_for_file:
* @self: An #IdeDiagnosticsManager
- * @file: A #GFile to retrieve diagnostics for
+ * @file: a #GFile to retrieve diagnostics for
*
* This function collects all of the diagnostics that have been collected
* for @file and returns them as a new #IdeDiagnostics to the caller.
diff --git a/src/libide/diagnostics/ide-source-location.c b/src/libide/diagnostics/ide-source-location.c
index 5dc4bbf..4d022b1 100644
--- a/src/libide/diagnostics/ide-source-location.c
+++ b/src/libide/diagnostics/ide-source-location.c
@@ -80,7 +80,7 @@ ide_source_location_unref (IdeSourceLocation *self)
*
* Retrieves the character offset within the file.
*
- * Returns: A #guint containing the character offset within the file.
+ * Returns: a #guint containing the character offset within the file.
*/
guint
ide_source_location_get_offset (IdeSourceLocation *self)
@@ -95,7 +95,7 @@ ide_source_location_get_offset (IdeSourceLocation *self)
*
* Retrieves the target line number starting from 0.
*
- * Returns: A #guint containing the target line.
+ * Returns: a #guint containing the target line.
*/
guint
ide_source_location_get_line (IdeSourceLocation *self)
@@ -110,7 +110,7 @@ ide_source_location_get_line (IdeSourceLocation *self)
*
* Retrieves the character offset within the line.
*
- * Returns: A #guint containing the offset within the line.
+ * Returns: a #guint containing the offset within the line.
*/
guint
ide_source_location_get_line_offset (IdeSourceLocation *self)
diff --git a/src/libide/doap/ide-doap.c b/src/libide/doap/ide-doap.c
index d3d1ed6..d84835d 100644
--- a/src/libide/doap/ide-doap.c
+++ b/src/libide/doap/ide-doap.c
@@ -127,7 +127,7 @@ ide_doap_get_category (IdeDoap *self)
/**
* ide_doap_get_languages:
*
- * Returns: (transfer none): A #GStrv.
+ * Returns: (transfer none): a #GStrv.
*/
gchar **
ide_doap_get_languages (IdeDoap *self)
@@ -243,7 +243,7 @@ ide_doap_set_shortdesc (IdeDoap *self,
*
*
*
- * Returns: (transfer none) (element-type IdeDoapPerson*): A #GList of #IdeDoapPerson.
+ * Returns: (transfer none) (element-type IdeDoapPerson*): a #GList of #IdeDoapPerson.
*/
GList *
ide_doap_get_maintainers (IdeDoap *self)
diff --git a/src/libide/editor/ide-editor-perspective.c b/src/libide/editor/ide-editor-perspective.c
index ec584c7..4d9e2d6 100644
--- a/src/libide/editor/ide-editor-perspective.c
+++ b/src/libide/editor/ide-editor-perspective.c
@@ -840,7 +840,7 @@ _ide_editor_perspective_show_properties (IdeEditorPerspective *self,
* Gets the overlay widget which can be used to layer things above all
* items in the layout grid.
*
- * Returns: (transfer none) (type Gtk.Overlay): A #GtkWidget
+ * Returns: (transfer none) (type Gtk.Overlay): a #GtkWidget
*/
GtkWidget *
ide_editor_perspective_get_overlay (IdeEditorPerspective *self)
diff --git a/src/libide/editor/ide-editor-sidebar.c b/src/libide/editor/ide-editor-sidebar.c
index 0a27997..2e4ecce 100644
--- a/src/libide/editor/ide-editor-sidebar.c
+++ b/src/libide/editor/ide-editor-sidebar.c
@@ -432,7 +432,7 @@ ide_editor_sidebar_open_pages_items_changed (IdeEditorSidebar *self,
/**
* _ide_editor_sidebar_set_open_pages:
* @self: a #IdeEditorSidebar
- * @open_pages: A #GListModel describing the open pages
+ * @open_pages: a #GListModel describing the open pages
*
* This private function is used to set the GListModel to use for the list
* of open pages in the sidebar. It should contain a list of IdeLayoutView
diff --git a/src/libide/editor/ide-editor-view.c b/src/libide/editor/ide-editor-view.c
index 29a9920..5f3764a 100644
--- a/src/libide/editor/ide-editor-view.c
+++ b/src/libide/editor/ide-editor-view.c
@@ -1241,7 +1241,7 @@ ide_editor_view_set_language (IdeEditorView *self,
*
* Gets the #GtkSourceLanguage that is used by the underlying buffer.
*
- * Returns: (transfer none) (nullable): A #GtkSourceLanguage or %NULL.
+ * Returns: (transfer none) (nullable): a #GtkSourceLanguage or %NULL.
*
* Since: 3.26
*/
diff --git a/src/libide/files/ide-file.c b/src/libide/files/ide-file.c
index e2c70fb..e90ef07 100644
--- a/src/libide/files/ide-file.c
+++ b/src/libide/files/ide-file.c
@@ -137,7 +137,7 @@ ide_file_create_language (IdeFile *self)
*
* Retrieves the #GtkSourceLanguage that was discovered for the file.
*
- * Returns: (nullable) (transfer none): A #GtkSourceLanguage or %NULL.
+ * Returns: (nullable) (transfer none): a #GtkSourceLanguage or %NULL.
*/
GtkSourceLanguage *
ide_file_get_language (IdeFile *self)
@@ -160,7 +160,7 @@ ide_file_get_language (IdeFile *self)
*
* Retrieves the underlying #GFile represented by @self.
*
- * Returns: (transfer none): A #GFile.
+ * Returns: (transfer none): a #GFile.
*/
GFile *
ide_file_get_file (IdeFile *self)
@@ -190,7 +190,7 @@ ide_file_set_file (IdeFile *self,
*
* Gets the GtkSourceFile for the #IdeFile.
*
- * Returns: (transfer none): A #GtkSourceFile.
+ * Returns: (transfer none): a #GtkSourceFile.
*/
GtkSourceFile *
_ide_file_get_source_file (IdeFile *self)
diff --git a/src/libide/genesis/ide-genesis-addin.c b/src/libide/genesis/ide-genesis-addin.c
index a7b5a68..c7370e9 100644
--- a/src/libide/genesis/ide-genesis-addin.c
+++ b/src/libide/genesis/ide-genesis-addin.c
@@ -50,7 +50,7 @@ ide_genesis_addin_get_icon_name (IdeGenesisAddin *self)
/**
* ide_genesis_addin_get_widget:
*
- * Returns: (transfer none): A #GtkWidget.
+ * Returns: (transfer none): a #GtkWidget.
*/
GtkWidget *
ide_genesis_addin_get_widget (IdeGenesisAddin *self)
diff --git a/src/libide/highlighting/ide-highlight-engine.c b/src/libide/highlighting/ide-highlight-engine.c
index 18ddbc0..f465747 100644
--- a/src/libide/highlighting/ide-highlight-engine.c
+++ b/src/libide/highlighting/ide-highlight-engine.c
@@ -1067,7 +1067,7 @@ ide_highlight_engine_invalidate (IdeHighlightEngine *self,
*
* A #GtkTextTag for @style_name.
*
- * Returns: (transfer none): A #GtkTextTag.
+ * Returns: (transfer none): a #GtkTextTag.
*/
GtkTextTag *
ide_highlight_engine_get_style (IdeHighlightEngine *self,
diff --git a/src/libide/ide-context.c b/src/libide/ide-context.c
index cae7fb4..4ca8c6f 100644
--- a/src/libide/ide-context.c
+++ b/src/libide/ide-context.c
@@ -171,7 +171,7 @@ static guint signals [LAST_SIGNAL];
* Gets the IdeContext:recent-manager property. The recent manager is a GtkRecentManager instance
* that should be used for the workbench.
*
- * Returns: (transfer none): A #GtkRecentManager.
+ * Returns: (transfer none): a #GtkRecentManager.
*/
GtkRecentManager *
ide_context_get_recent_manager (IdeContext *self)
@@ -439,7 +439,7 @@ ide_context_get_project (IdeContext *self)
* Retrieves a #GFile containing the project file that was used to load
* the context.
*
- * Returns: (transfer none): A #GFile.
+ * Returns: (transfer none): a #GFile.
*/
GFile *
ide_context_get_project_file (IdeContext *self)
@@ -476,7 +476,7 @@ ide_context_get_search_engine (IdeContext *self)
/**
* ide_context_get_service_typed:
- * @service_type: A #GType of the service desired.
+ * @service_type: a #GType of the service desired.
*
* Retrieves a service matching @service_type. If no match was found, a type
* implementing the requested service type will be returned. If no matching
@@ -2237,7 +2237,7 @@ ide_context_hold (IdeContext *self)
/**
* ide_context_hold_for_object:
* @self: An #IdeContext
- * @instance: (type GObject.Object): A #GObject instance
+ * @instance: (type GObject.Object): a #GObject instance
*
* Adds a hold on @self for the lifetime of @instance.
*/
diff --git a/src/libide/ide-object.c b/src/libide/ide-object.c
index bfd5b98..d81299a 100644
--- a/src/libide/ide-object.c
+++ b/src/libide/ide-object.c
@@ -466,10 +466,10 @@ ide_object_new_for_extension_async_try_next (GTask *task)
/**
* ide_object_new_for_extension_async:
* @interface_gtype: the #GType of the extension interface
- * @sort_priority_func: (scope call) (allow-none): A #GCompareDataFunc or %NULL
+ * @sort_priority_func: (scope call) (allow-none): a #GCompareDataFunc or %NULL
* @sort_priority_data: (nullable): data for @sort_priority_func
* @io_priority: An io priority or %G_PRIORITY_DEFAULT
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: (nullable): A callback to complete the request
* @user_data: (nullable): user data for @callback
* @first_property: (nullable): The first property to set, or %NULL
@@ -542,8 +542,8 @@ ide_object_new_for_extension_async (GType interface_gtype,
* ide_object_new_async:
* @extension_point: The identifier of the extension point
* @io_priority: An io priority or %G_PRIORITY_DEFAULT
- * @cancellable: (nullable): A #GCancellable or %NULL
- * @callback: (nullable): A #GAsyncReadyCallback
+ * @cancellable: (nullable): a #GCancellable or %NULL
+ * @callback: (nullable): a #GAsyncReadyCallback
* @user_data: user data for @callback
* @first_property: the first property to set, or %NULL
* @...: the value for the first property
@@ -626,7 +626,7 @@ ide_object_new_async (const gchar *extension_point,
/**
* ide_object_new_finish:
- * @result: A #GAsyncResult provided to callback
+ * @result: a #GAsyncResult provided to callback
* @error: A location for a #GError, or %NULL
*
* Completes an asynchronous request to create a new #IdeObject subclass.
@@ -731,7 +731,7 @@ ide_object_notify_in_main_cb (gpointer data)
/**
* ide_object_notify_in_main:
* @instance: (type GObject.Object): a #GObject
- * @pspec: A #GParamSpec
+ * @pspec: a #GParamSpec
*
* This helper will perform a g_object_notify_by_pspec() with the
* added requirement that it is run from the applications main thread.
diff --git a/src/libide/langserv/ide-langserv-client.c b/src/libide/langserv/ide-langserv-client.c
index 6e9b4c7..c37cec8 100644
--- a/src/libide/langserv/ide-langserv-client.c
+++ b/src/libide/langserv/ide-langserv-client.c
@@ -1238,7 +1238,7 @@ ide_langserv_client_get_diagnostics_async (IdeLangservClient *self,
/**
* ide_langserv_client_get_diagnostics_finish:
* @self: an #IdeLangservClient
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @diagnostics: (nullable) (out): A location for a #IdeDiagnostics or %NULL
* @error: A location for a #GError or %NULL
*
diff --git a/src/libide/layout/ide-layout-stack-header.c b/src/libide/layout/ide-layout-stack-header.c
index 6b1a107..72f79eb 100644
--- a/src/libide/layout/ide-layout-stack-header.c
+++ b/src/libide/layout/ide-layout-stack-header.c
@@ -691,7 +691,7 @@ ide_layout_stack_header_new (void)
/**
* ide_layout_stack_header_add_custom_title:
* @self: a #IdeLayoutStackHeader
- * @widget: A #GtkWidget
+ * @widget: a #GtkWidget
* @priority: the sort priority
*
* This will add @widget to the title area with @priority determining the
diff --git a/src/libide/layout/ide-layout-view.c b/src/libide/layout/ide-layout-view.c
index b571e98..9729954 100644
--- a/src/libide/layout/ide-layout-view.c
+++ b/src/libide/layout/ide-layout-view.c
@@ -568,7 +568,7 @@ ide_layout_view_create_split_view (IdeLayoutView *self)
* The primary-color-bg can be used to alter the color of the layout
* stack header to match the document contents.
*
- * Returns: (transfer none) (nullable): A #GdkRGBA or %NULL.
+ * Returns: (transfer none) (nullable): a #GdkRGBA or %NULL.
*
* Since: 3.26
*/
@@ -585,7 +585,7 @@ ide_layout_view_get_primary_color_bg (IdeLayoutView *self)
/**
* ide_layout_view_set_primary_color_bg:
* @self: a #IdeLayoutView
- * @primary_color_bg: (nullable): A #GdkRGBA or %NULL
+ * @primary_color_bg: (nullable): a #GdkRGBA or %NULL
*
* Sets the #IdeLayoutView:primary-color-bg property.
* If @primary_color_bg is %NULL, the property is unset.
@@ -630,7 +630,7 @@ ide_layout_view_set_primary_color_bg (IdeLayoutView *self,
* The primary-color-fg can be used to alter the foreground color of the layout
* stack header to match the document contents.
*
- * Returns: (transfer none) (nullable): A #GdkRGBA or %NULL.
+ * Returns: (transfer none) (nullable): a #GdkRGBA or %NULL.
*
* Since: 3.26
*/
@@ -647,7 +647,7 @@ ide_layout_view_get_primary_color_fg (IdeLayoutView *self)
/**
* ide_layout_view_set_primary_color_fg:
* @self: a #IdeLayoutView
- * @primary_color_fg: (nullable): A #GdkRGBA or %NULL
+ * @primary_color_fg: (nullable): a #GdkRGBA or %NULL
*
* Sets the #IdeLayoutView:primary-color-fg property.
* If @primary_color_fg is %NULL, the property is unset.
diff --git a/src/libide/logging/ide-log.c b/src/libide/logging/ide-log.c
index 2d56ba7..f7d6b6b 100644
--- a/src/libide/logging/ide-log.c
+++ b/src/libide/logging/ide-log.c
@@ -111,7 +111,7 @@ ide_log_get_thread (void)
/**
* ide_log_level_str:
- * @log_level: A #GLogLevelFlags.
+ * @log_level: a #GLogLevelFlags.
*
* Retrieves the log level as a string.
*
@@ -156,7 +156,7 @@ ide_log_level_str_with_color (GLogLevelFlags log_level)
/**
* ide_log_write_to_channel:
- * @channel: A #GIOChannel.
+ * @channel: a #GIOChannel.
* @message: A string log message.
*
* Writes @message to @channel and flushes the channel.
@@ -172,7 +172,7 @@ ide_log_write_to_channel (GIOChannel *channel,
/**
* ide_log_handler:
* @log_domain: A string containing the log section.
- * @log_level: A #GLogLevelFlags.
+ * @log_level: a #GLogLevelFlags.
* @message: The string message.
* @user_data: User data supplied to g_log_set_default_handler().
*
diff --git a/src/libide/plugins/ide-extension-adapter.c b/src/libide/plugins/ide-extension-adapter.c
index cd883ec..066d3e5 100644
--- a/src/libide/plugins/ide-extension-adapter.c
+++ b/src/libide/plugins/ide-extension-adapter.c
@@ -508,7 +508,7 @@ ide_extension_adapter_get_interface_type (IdeExtensionAdapter *self)
*
* Gets the #IdeExtensionAdapter:engine property.
*
- * Returns: (transfer none): A #PeasEngine.
+ * Returns: (transfer none): a #PeasEngine.
*/
PeasEngine *
ide_extension_adapter_get_engine (IdeExtensionAdapter *self)
@@ -523,7 +523,7 @@ ide_extension_adapter_get_engine (IdeExtensionAdapter *self)
*
* Gets the extension object managed by the adapter.
*
- * Returns: (transfer none) (type GObject.Object): A #GObject or %NULL.
+ * Returns: (transfer none) (type GObject.Object): a #GObject or %NULL.
*/
gpointer
ide_extension_adapter_get_extension (IdeExtensionAdapter *self)
@@ -536,7 +536,7 @@ ide_extension_adapter_get_extension (IdeExtensionAdapter *self)
/**
* ide_extension_adapter_new:
* @context: An #IdeContext.
- * @engine: (allow-none): A #PeasEngine or %NULL.
+ * @engine: (allow-none): a #PeasEngine or %NULL.
* @interface_type: The #GType of the interface to be implemented.
* @key: The key for matching extensions from plugin info external data.
* @value: (allow-none): The value to use when matching keys.
diff --git a/src/libide/plugins/ide-extension-set-adapter.c b/src/libide/plugins/ide-extension-set-adapter.c
index fc2ee78..cf422d3 100644
--- a/src/libide/plugins/ide-extension-set-adapter.c
+++ b/src/libide/plugins/ide-extension-set-adapter.c
@@ -467,7 +467,7 @@ ide_extension_set_adapter_init (IdeExtensionSetAdapter *self)
*
* Gets the #IdeExtensionSetAdapter:engine property.
*
- * Returns: (transfer none): A #PeasEngine.
+ * Returns: (transfer none): a #PeasEngine.
*/
PeasEngine *
ide_extension_set_adapter_get_engine (IdeExtensionSetAdapter *self)
@@ -601,7 +601,7 @@ ide_extension_set_adapter_new (IdeContext *context,
*
* Locates the extension owned by @plugin_info if such extension exists.
*
- * Returns: (transfer none) (nullable): A #PeasExtension or %NULL
+ * Returns: (transfer none) (nullable): a #PeasExtension or %NULL
*/
PeasExtension *
ide_extension_set_adapter_get_extension (IdeExtensionSetAdapter *self,
diff --git a/src/libide/plugins/ide-extension-util.c b/src/libide/plugins/ide-extension-util.c
index 6575398..8ce43c5 100644
--- a/src/libide/plugins/ide-extension-util.c
+++ b/src/libide/plugins/ide-extension-util.c
@@ -220,7 +220,7 @@ collect_parameters (GType type,
* It does this by duplicating some of the GParameter stuff that libpeas does
* but looking at base-classes in addition to interface properties.
*
- * Returns: (transfer full): A #PeasExtensionSet.
+ * Returns: (transfer full): a #PeasExtensionSet.
*/
PeasExtensionSet *
ide_extension_set_new (PeasEngine *engine,
diff --git a/src/libide/projects/ide-project-file.c b/src/libide/projects/ide-project-file.c
index ccd3e6f..fedb4b3 100644
--- a/src/libide/projects/ide-project-file.c
+++ b/src/libide/projects/ide-project-file.c
@@ -131,7 +131,7 @@ ide_project_file_set_file (IdeProjectFile *self,
* Retrieves a #GFileInfo containing the basic information about @file. This
* includes the name, display name, and file type.
*
- * Returns: (transfer none): A #GFileInfo
+ * Returns: (transfer none): a #GFileInfo
*/
GFileInfo *
ide_project_file_get_file_info (IdeProjectFile *file)
diff --git a/src/libide/projects/ide-project-files.c b/src/libide/projects/ide-project-files.c
index b18a751..31ffab8 100644
--- a/src/libide/projects/ide-project-files.c
+++ b/src/libide/projects/ide-project-files.c
@@ -99,7 +99,7 @@ ide_project_files_find_child (IdeProjectItem *item,
/**
* ide_project_files_find_file:
* @self: (in): an #IdeProjectFiles.
- * @file: A #GFile.
+ * @file: a #GFile.
*
* Tries to locate an #IdeProjectFile matching the given file.
* If @file is the working directory, @self is returned.
diff --git a/src/libide/projects/ide-project-info.c b/src/libide/projects/ide-project-info.c
index f908fcb..0d4d10a 100644
--- a/src/libide/projects/ide-project-info.c
+++ b/src/libide/projects/ide-project-info.c
@@ -151,7 +151,7 @@ ide_project_info_set_priority (IdeProjectInfo *self,
* Gets the #IdeProjectInfo:directory property.
* This is the directory containing the project (if known).
*
- * Returns: (nullable) (transfer none): A #GFile.
+ * Returns: (nullable) (transfer none): a #GFile.
*/
GFile *
ide_project_info_get_directory (IdeProjectInfo *self)
@@ -168,7 +168,7 @@ ide_project_info_get_directory (IdeProjectInfo *self)
* Gets the #IdeProjectInfo:file property.
* This is the project file (such as configure.ac) of the project.
*
- * Returns: (nullable) (transfer none): A #GFile.
+ * Returns: (nullable) (transfer none): a #GFile.
*/
GFile *
ide_project_info_get_file (IdeProjectInfo *self)
@@ -182,7 +182,7 @@ ide_project_info_get_file (IdeProjectInfo *self)
* ide_project_info_get_last_modified_at:
*
*
- * Returns: (transfer none) (nullable): A #GDateTime or %NULL.
+ * Returns: (transfer none) (nullable): a #GDateTime or %NULL.
*/
GDateTime *
ide_project_info_get_last_modified_at (IdeProjectInfo *self)
diff --git a/src/libide/projects/ide-project-item.c b/src/libide/projects/ide-project-item.c
index 89fcd45..ac64fae 100644
--- a/src/libide/projects/ide-project-item.c
+++ b/src/libide/projects/ide-project-item.c
@@ -93,7 +93,7 @@ ide_project_item_remove (IdeProjectItem *item,
*
* A scalable list containing the children of the item.
*
- * Returns: (transfer none): A #GSequence.
+ * Returns: (transfer none): a #GSequence.
*/
GSequence *
ide_project_item_get_children (IdeProjectItem *item)
diff --git a/src/libide/projects/ide-project.c b/src/libide/projects/ide-project.c
index b34d336..6d1a44b 100644
--- a/src/libide/projects/ide-project.c
+++ b/src/libide/projects/ide-project.c
@@ -285,7 +285,7 @@ ide_project_get_file_for_path (IdeProject *self,
/**
* ide_project_get_project_file:
* @self: an #IdeProject.
- * @gfile: A #GFile.
+ * @gfile: a #GFile.
*
* Gets a new #IdeFile representing @gfile.
*
diff --git a/src/libide/projects/ide-recent-projects.c b/src/libide/projects/ide-recent-projects.c
index aaa943f..dbb44ec 100644
--- a/src/libide/projects/ide-recent-projects.c
+++ b/src/libide/projects/ide-recent-projects.c
@@ -352,7 +352,7 @@ ide_recent_projects_init (IdeRecentProjects *self)
*
* Gets a #GPtrArray containing the #IdeProjectInfo that have been discovered.
*
- * Returns: (transfer container) (element-type IdeProjectInfo*): A #GPtrArray of #IdeProjectInfo.
+ * Returns: (transfer container) (element-type IdeProjectInfo*): a #GPtrArray of #IdeProjectInfo.
*/
GPtrArray *
ide_recent_projects_get_projects (IdeRecentProjects *self)
@@ -450,7 +450,7 @@ ide_recent_projects_discover_finish (IdeRecentProjects *self,
/**
* ide_recent_projects_remove:
* @self: An #IdeRecentProjects
- * @project_infos: (transfer none) (element-type IdeProjectInfo): A #GList of #IdeProjectInfo.
+ * @project_infos: (transfer none) (element-type IdeProjectInfo): a #GList of #IdeProjectInfo.
*
* Removes the provided projects from the recent projects file.
*/
diff --git a/src/libide/rename/ide-rename-provider.c b/src/libide/rename/ide-rename-provider.c
index 480dc10..d513a81 100644
--- a/src/libide/rename/ide-rename-provider.c
+++ b/src/libide/rename/ide-rename-provider.c
@@ -81,7 +81,7 @@ ide_rename_provider_default_init (IdeRenameProviderInterface *iface)
* @self: An #IdeRenameProvider
* @location: An #IdeSourceLocation
* @new_name: The replacement name for the symbol
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: a callback to complete the request
* @user_data: user data for @callback
*
@@ -113,7 +113,7 @@ ide_rename_provider_rename_async (IdeRenameProvider *self,
/**
* ide_rename_provider_rename_finish:
* @self: An #IdeRenameProvider
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @edits: (out) (transfer container) (element-type Ide.ProjectEdit) (nullable): A location
* for a #GPtrArray of #IdeProjectEdit instances.
* @error: a location for a #GError, or %NULL.
diff --git a/src/libide/runtimes/ide-runtime-manager.c b/src/libide/runtimes/ide-runtime-manager.c
index 0789fdc..fbd2cbf 100644
--- a/src/libide/runtimes/ide-runtime-manager.c
+++ b/src/libide/runtimes/ide-runtime-manager.c
@@ -329,7 +329,7 @@ ide_runtime_manager_install_cb (GObject *object,
* ide_runtime_manager_ensure_async:
* @self: An #IdeRuntimeManager
* @runtime_id: the id for an expected runtime
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: a callback to call after execution
* @user_data: user data for @callback
*
diff --git a/src/libide/runtimes/ide-runtime.c b/src/libide/runtimes/ide-runtime.c
index 8370dd6..d2f670d 100644
--- a/src/libide/runtimes/ide-runtime.c
+++ b/src/libide/runtimes/ide-runtime.c
@@ -459,12 +459,12 @@ ide_runtime_error_quark (void)
/**
* ide_runtime_translate_file:
* @self: An #IdeRuntime
- * @file: A #GFile
+ * @file: a #GFile
*
* Translates the file from a path within the runtime to a path that can
* be accessed from the host system.
*
- * Returns: (transfer full) (not nullable): A #GFile.
+ * Returns: (transfer full) (not nullable): a #GFile.
*/
GFile *
ide_runtime_translate_file (IdeRuntime *self,
diff --git a/src/libide/search/ide-search-engine.c b/src/libide/search/ide-search-engine.c
index 91dcfe5..aaeefa8 100644
--- a/src/libide/search/ide-search-engine.c
+++ b/src/libide/search/ide-search-engine.c
@@ -297,7 +297,7 @@ ide_search_engine_search_async (IdeSearchEngine *self,
*
* The result is a #GListModel of #IdeSearchResult when successful.
*
- * Returns: (transfer full): A #GListModel of #IdeSearchResult items.
+ * Returns: (transfer full): a #GListModel of #IdeSearchResult items.
*/
GListModel *
ide_search_engine_search_finish (IdeSearchEngine *self,
diff --git a/src/libide/search/ide-search-provider.c b/src/libide/search/ide-search-provider.c
index f065570..61b0ffb 100644
--- a/src/libide/search/ide-search-provider.c
+++ b/src/libide/search/ide-search-provider.c
@@ -83,7 +83,7 @@ ide_search_provider_search_async (IdeSearchProvider *self,
*
* Completes a request to a search provider.
*
- * Returns: (transfer container) (element-type Ide.SearchResult): A #GPtrArray
+ * Returns: (transfer container) (element-type Ide.SearchResult): a #GPtrArray
* of #IdeSearchResult elements.
*/
GPtrArray *
diff --git a/src/libide/sourceview/ide-indenter.c b/src/libide/sourceview/ide-indenter.c
index 3d47fe2..d43a7bd 100644
--- a/src/libide/sourceview/ide-indenter.c
+++ b/src/libide/sourceview/ide-indenter.c
@@ -99,9 +99,9 @@ ide_indenter_mimic_source_view (GtkTextView *text_view,
/**
* ide_indenter_format:
* @self: (nullable): An #IdeIndenter or %NULL for the fallback
- * @text_view: A #GtkTextView
- * @begin: A #GtkTextIter for the beginning region of text to replace.
- * @end: A #GtkTextIter for the end region of text to replace.
+ * @text_view: a #GtkTextView
+ * @begin: a #GtkTextIter for the beginning region of text to replace.
+ * @end: a #GtkTextIter for the end region of text to replace.
* @cursor_offset: (out): The offset in characters from @end to place the
* cursor. Negative values are okay.
* @event: The #GdkEventKey that triggered the event.
diff --git a/src/libide/sourceview/ide-source-view.c b/src/libide/sourceview/ide-source-view.c
index db3081b..7808c25 100644
--- a/src/libide/sourceview/ide-source-view.c
+++ b/src/libide/sourceview/ide-source-view.c
@@ -7323,7 +7323,7 @@ ide_source_view_set_scroll_offset (IdeSourceView *self,
/**
* ide_source_view_get_visible_rect:
* @self: An #IdeSourceView.
- * @visible_rect: (out): A #GdkRectangle.
+ * @visible_rect: (out): a #GdkRectangle.
*
* Gets the visible region in buffer coordinates that is the visible area of the buffer. This
* is similar to gtk_text_view_get_visible_area() except that it takes into account the
diff --git a/src/libide/sourceview/ide-text-iter.c b/src/libide/sourceview/ide-text-iter.c
index 0279e30..84f5cae 100644
--- a/src/libide/sourceview/ide-text-iter.c
+++ b/src/libide/sourceview/ide-text-iter.c
@@ -126,7 +126,7 @@ _ide_text_iter_line_is_empty (GtkTextIter *iter)
/**
* _ide_text_iter_backward_paragraph_start:
- * @iter: A #GtkTextIter
+ * @iter: a #GtkTextIter
*
* Searches backwards until we find the beginning of a paragraph.
*
@@ -153,7 +153,7 @@ _ide_text_iter_backward_paragraph_start (GtkTextIter *iter)
/**
* _ide_text_iter_forward_paragraph_end:
- * @iter: A #GtkTextIter
+ * @iter: a #GtkTextIter
*
* Searches forward until the end of a paragraph has been hit.
*
@@ -676,10 +676,10 @@ _ide_text_iter_backward_find_char (GtkTextIter *iter,
/**
* ide_text_iter_in_string:
- * @iter: A #GtkTextIter indicating the position to check for.
+ * @iter: a #GtkTextIter indicating the position to check for.
* @str: A C type string.
- * @str_start: (out): A #GtkTextIter returning the str start iter (if found).
- * @str_end: (out): A #GtkTextIter returning the str end iter (if found).
+ * @str_start: (out): a #GtkTextIter returning the str start iter (if found).
+ * @str_end: (out): a #GtkTextIter returning the str end iter (if found).
* @include_str_bounds: %TRUE if we take into account the str limits as possible @iter positions.
*
* Check if @iter position in the buffer is part of @str.
@@ -773,9 +773,9 @@ _ide_text_iter_in_string (GtkTextIter *iter,
/**
* _ide_text_iter_find_chars_backward:
- * @iter: A #GtkTextIter indicating the start position to check for.
- * @limit: (nullable): A #GtkTextIter indicating the limit of the search.
- * @end: (out) (nullable): A #GtkTextIter returning the str end iter (if found).
+ * @iter: a #GtkTextIter indicating the start position to check for.
+ * @limit: (nullable): a #GtkTextIter indicating the limit of the search.
+ * @end: (out) (nullable): a #GtkTextIter returning the str end iter (if found).
* @str: A C type string.
* @only_at_start: %TRUE if the searched @str string should be constrained to start @iter position.
*
@@ -844,9 +844,9 @@ _ide_text_iter_find_chars_backward (GtkTextIter *iter,
/**
* _ide_text_iter_find_chars_forward:
- * @iter: A #GtkTextIter indicating the start position to check for.
- * @limit: (nullable): A #GtkTextIter indicating the limit of the search.
- * @end: (out) (nullable): A #GtkTextIter returning the str end iter (if found).
+ * @iter: a #GtkTextIter indicating the start position to check for.
+ * @limit: (nullable): a #GtkTextIter indicating the limit of the search.
+ * @end: (out) (nullable): a #GtkTextIter returning the str end iter (if found).
* @str: A C type string.
* @only_at_start: %TRUE if the searched @str string should be constrained to start @iter position.
*
diff --git a/src/libide/subprocess/ide-subprocess.c b/src/libide/subprocess/ide-subprocess.c
index f9931d0..fc9a7d3 100644
--- a/src/libide/subprocess/ide-subprocess.c
+++ b/src/libide/subprocess/ide-subprocess.c
@@ -47,7 +47,7 @@ ide_subprocess_get_identifier (IdeSubprocess *self)
/**
* ide_subprocess_get_stdout_pipe:
*
- * Returns: (transfer none): A #GInputStream or %NULL.
+ * Returns: (transfer none): a #GInputStream or %NULL.
*/
GInputStream *
ide_subprocess_get_stdout_pipe (IdeSubprocess *self)
@@ -60,7 +60,7 @@ ide_subprocess_get_stdout_pipe (IdeSubprocess *self)
/**
* ide_subprocess_get_stderr_pipe:
*
- * Returns: (transfer none): A #GInputStream or %NULL.
+ * Returns: (transfer none): a #GInputStream or %NULL.
*/
GInputStream *
ide_subprocess_get_stderr_pipe (IdeSubprocess *self)
@@ -73,7 +73,7 @@ ide_subprocess_get_stderr_pipe (IdeSubprocess *self)
/**
* ide_subprocess_get_stdin_pipe:
*
- * Returns: (transfer none): A #GOutputStream or %NULL.
+ * Returns: (transfer none): a #GOutputStream or %NULL.
*/
GOutputStream *
ide_subprocess_get_stdin_pipe (IdeSubprocess *self)
@@ -315,8 +315,8 @@ ide_subprocess_communicate_utf8 (IdeSubprocess *self,
/**
* ide_subprocess_communicate_async:
* @self: An #IdeSubprocess
- * @stdin_buf: (nullable): A #GBytes to send to stdin or %NULL
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @stdin_buf: (nullable): a #GBytes to send to stdin or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: A callback to complete the request
* @user_data: user data for @callback
*
@@ -345,7 +345,7 @@ ide_subprocess_communicate_async (IdeSubprocess *self,
/**
* ide_subprocess_communicate_finish:
* @self: An #IdeSubprocess
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @stdout_buf: (out) (optional): A location for a #Bytes.
* @stderr_buf: (out) (optional): A location for a #Bytes.
* @error: a location for a #GError
@@ -388,7 +388,7 @@ ide_subprocess_communicate_utf8_async (IdeSubprocess *self,
/**
* ide_subprocess_communicate_utf8_finish:
* @self: An #IdeSubprocess
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @stdout_buf: (out) (optional): A location for the UTF-8 formatted output string or %NULL
* @stderr_buf: (out) (optional): A location for the UTF-8 formatted output string or %NULL
* @error: A location for a #GError, or %NULL
diff --git a/src/libide/symbols/ide-code-indexer.c b/src/libide/symbols/ide-code-indexer.c
index 81bc02d..a484577 100644
--- a/src/libide/symbols/ide-code-indexer.c
+++ b/src/libide/symbols/ide-code-indexer.c
@@ -77,8 +77,8 @@ ide_code_indexer_default_init (IdeCodeIndexerInterface *iface)
* @self: An #IdeCodeIndexer instance.
* @file: Source file to index.
* @build_flags: (nullable): array of build flags to parse @file.
- * @cancellable: (nullable): A #GCancellable.
- * @error: A #GError.
+ * @cancellable: (nullable): a #GCancellable.
+ * @error: a #GError.
*
* This function will take index source file and create an array
* of symbols in @file.
@@ -110,7 +110,7 @@ ide_code_indexer_index_file (IdeCodeIndexer *self,
* ide_code_indexer_generate_key_async:
* @self: An #IdeCodeIndexer instance.
* @location: Source location of refernece.
- * @cancellable: (nullable): A #GCancellable.
+ * @cancellable: (nullable): a #GCancellable.
* @callback: A callback to execute upon indexing.
* @user_data: User data to pass to @callback.
*
diff --git a/src/libide/symbols/ide-symbol-resolver.c b/src/libide/symbols/ide-symbol-resolver.c
index daa7379..62629cd 100644
--- a/src/libide/symbols/ide-symbol-resolver.c
+++ b/src/libide/symbols/ide-symbol-resolver.c
@@ -137,7 +137,7 @@ ide_symbol_resolver_default_init (IdeSymbolResolverInterface *iface)
* ide_symbol_resolver_lookup_symbol_async:
* @self: An #IdeSymbolResolver.
* @location: An #IdeSourceLocation.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @callback: A callback to execute upon completion.
* @user_data: user data for @callback.
*
@@ -162,7 +162,7 @@ ide_symbol_resolver_lookup_symbol_async (IdeSymbolResolver *self,
/**
* ide_symbol_resolver_lookup_symbol_finish:
* @self: An #IdeSymbolResolver.
- * @result: A #GAsyncResult provided to the callback.
+ * @result: a #GAsyncResult provided to the callback.
* @error: (out): A location for an @error or %NULL.
*
* Completes an asynchronous call to lookup a symbol using
@@ -184,7 +184,7 @@ ide_symbol_resolver_lookup_symbol_finish (IdeSymbolResolver *self,
/**
* ide_symbol_resolver_get_symbol_tree_async:
* @self: An #IdeSymbolResolver
- * @file: A #GFile
+ * @file: a #GFile
* @buffer: an #IdeBuffer or %NULL
* @cancellable: (allow-none): a #GCancellable or %NULL.
* @callback: (allow-none): a callback to execute upon completion
@@ -255,7 +255,7 @@ ide_symbol_resolver_find_references_async (IdeSymbolResolver *self,
*
* Completes an asynchronous request to ide_symbol_resolver_find_references_async().
*
- * Returns: (transfer container) (element-type Ide.SourceRange): A #GPtrArray
+ * Returns: (transfer container) (element-type Ide.SourceRange): a #GPtrArray
* of #IdeSourceRange if successful; otherwise %NULL and @error is set.
*/
GPtrArray *
@@ -273,7 +273,7 @@ ide_symbol_resolver_find_references_finish (IdeSymbolResolver *self,
* ide_symbol_resolver_find_nearest_scope_async:
* @self: a #IdeSymbolResolver
* @location: an #IdeSourceLocation
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: (scope async) (closure user_data): an async callback
* @user_data: user data for @callback
*
diff --git a/src/libide/template/ide-project-template.c b/src/libide/template/ide-project-template.c
index 5af6e0f..47a5f28 100644
--- a/src/libide/template/ide-project-template.c
+++ b/src/libide/template/ide-project-template.c
@@ -57,7 +57,7 @@ ide_project_template_get_description (IdeProjectTemplate *self)
*
* Get's the configuration widget for the template if there is one.
*
- * Returns: (transfer none): A #GtkWidget.
+ * Returns: (transfer none): a #GtkWidget.
*/
GtkWidget *
ide_project_template_get_widget (IdeProjectTemplate *self)
@@ -97,7 +97,7 @@ ide_project_template_get_icon_name (IdeProjectTemplate *self)
* ide_project_template_expand_async:
* @self: an #IdeProjectTemplate
* @params: (element-type utf8 GLib.Variant): A hashtable of template parameters.
- * @cancellable: (nullable): A #GCancellable or %NULL.
+ * @cancellable: (nullable): a #GCancellable or %NULL.
* @callback: the callback for the asynchronous operation.
* @user_data: user data for @callback.
*
diff --git a/src/libide/template/ide-template-base.c b/src/libide/template/ide-template-base.c
index 83efb78..c9cf780 100644
--- a/src/libide/template/ide-template-base.c
+++ b/src/libide/template/ide-template-base.c
@@ -130,7 +130,7 @@ ide_template_base_mkdirs_finish (IdeTemplateBase *self,
*
* Fetches the #TmplTemplateLocator used for resolving templates.
*
- * Returns: (transfer none) (nullable): A #TmplTemplateLocator or %NULL.
+ * Returns: (transfer none) (nullable): a #TmplTemplateLocator or %NULL.
*/
TmplTemplateLocator *
ide_template_base_get_locator (IdeTemplateBase *self)
diff --git a/src/libide/template/ide-template-provider.c b/src/libide/template/ide-template-provider.c
index 4882705..8346abc 100644
--- a/src/libide/template/ide-template-provider.c
+++ b/src/libide/template/ide-template-provider.c
@@ -41,7 +41,7 @@ ide_template_provider_default_init (IdeTemplateProviderInterface *iface)
* Plugins should implement this interface to feed #IdeProjectTemplate's into
* the project creation workflow.
*
- * Returns: (transfer full) (element-type Ide.ProjectTemplate): A #GList of
+ * Returns: (transfer full) (element-type Ide.ProjectTemplate): a #GList of
* #IdeProjectTemplate instances.
*/
GList *
diff --git a/src/libide/testing/ide-test-manager.c b/src/libide/testing/ide-test-manager.c
index cb54d5d..f153585 100644
--- a/src/libide/testing/ide-test-manager.c
+++ b/src/libide/testing/ide-test-manager.c
@@ -534,7 +534,7 @@ ide_test_manager_run_all_cb (GObject *object,
/**
* ide_test_manager_run_all_async:
* @self: An #IdeTestManager
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @callback: a callback to execute upon completion
* @user_data: user data for @callback
*
@@ -609,7 +609,7 @@ ide_test_manager_run_all_async (IdeTestManager *self,
/**
* ide_test_manager_run_all_finish:
* @self: An #IdeTestManager
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: a location for a #GError, or %NULL
*
* Completes an asynchronous request to execute all unit tests.
@@ -668,7 +668,7 @@ ide_test_manager_run_cb (GObject *object,
* ide_test_manager_run_async:
* @self: An #IdeTestManager
* @test: An #IdeTest
- * @cancellable: (nullable): A #GCancellable, or %NULL
+ * @cancellable: (nullable): a #GCancellable, or %NULL
* @callback: a callback to execute upon completion
* @user_data: user data for @callback
*
diff --git a/src/libide/threading/ide-thread-pool.c b/src/libide/threading/ide-thread-pool.c
index 09ae74b..f6a9cac 100644
--- a/src/libide/threading/ide-thread-pool.c
+++ b/src/libide/threading/ide-thread-pool.c
@@ -61,7 +61,7 @@ ide_thread_pool_get_pool (IdeThreadPoolKind kind)
/**
* ide_thread_pool_push_task:
* @kind: The task kind.
- * @task: A #GTask to execute.
+ * @task: a #GTask to execute.
* @func: (scope async): The thread worker to execute for @task.
*
* This pushes a task to be executed on a worker thread based on the task kind as denoted by
diff --git a/src/libide/transfers/ide-transfer-manager.c b/src/libide/transfers/ide-transfer-manager.c
index fd9b4b9..3b6467a 100644
--- a/src/libide/transfers/ide-transfer-manager.c
+++ b/src/libide/transfers/ide-transfer-manager.c
@@ -389,7 +389,7 @@ notify_properties:
/**
* ide_transfer_manager_execute_async:
* @self: An #IdeTransferManager
- * @cancellable: (nullable): A #GCancellable
+ * @cancellable: (nullable): a #GCancellable
* @callback: (nullable): A callback or %NULL
* @user_data: user data for @callback
*
diff --git a/src/libide/util/ide-glib.c b/src/libide/util/ide-glib.c
index b357549..bd46505 100644
--- a/src/libide/util/ide-glib.c
+++ b/src/libide/util/ide-glib.c
@@ -152,8 +152,8 @@ ide_g_task_return_pointer_from_main (GTask *task,
/**
* ide_g_task_return_error_from_main:
- * @task: A #GTask
- * @error: (transfer full): A #GError.
+ * @task: a #GTask
+ * @error: (transfer full): a #GError.
*
* Like g_task_return_error() but ensures we return to the main loop before
* dispatching the result.
diff --git a/src/libide/util/ide-gtk.c b/src/libide/util/ide-gtk.c
index 16e6333..c5fa49b 100644
--- a/src/libide/util/ide-gtk.c
+++ b/src/libide/util/ide-gtk.c
@@ -68,7 +68,7 @@ ide_widget_hierarchy_changed (GtkWidget *widget,
/**
* ide_widget_set_context_handler:
- * @widget: (type Gtk.Widget): A #GtkWidget
+ * @widget: (type Gtk.Widget): a #GtkWidget
* @handler: (scope async): A callback to handle the context
*
* Calls @handler when the #IdeContext has been set for @widget.
diff --git a/src/libide/util/ide-uri.c b/src/libide/util/ide-uri.c
index e09efdb..aa8c2dd 100644
--- a/src/libide/util/ide-uri.c
+++ b/src/libide/util/ide-uri.c
@@ -1526,7 +1526,7 @@ ide_uri_error_quark (void)
/**
* ide_uri_new_from_file:
- * @file: A #GFile.
+ * @file: a #GFile.
*
* Creates a new #IdeUri from the uri provided by @file.
*
@@ -1578,7 +1578,7 @@ ide_uri_is_file (IdeUri *uri,
*
* Creates a #GFile that represents the resource @uri.
*
- * Returns: (transfer full) (nullable): A #GFile or %NULL upon failure.
+ * Returns: (transfer full) (nullable): a #GFile or %NULL upon failure.
*/
GFile *
ide_uri_to_file (IdeUri *uri)
diff --git a/src/libide/vcs/ide-vcs.c b/src/libide/vcs/ide-vcs.c
index 3636a6e..1a010f7 100644
--- a/src/libide/vcs/ide-vcs.c
+++ b/src/libide/vcs/ide-vcs.c
@@ -88,7 +88,7 @@ ide_vcs_default_init (IdeVcsInterface *iface)
/**
* ide_vcs_is_ignored:
* @self: An #IdeVcs
- * @file: (nullable): A #GFile
+ * @file: (nullable): a #GFile
* @error: A location for a #GError, or %NULL
*
* This function will check if @file is considered an "ignored file" by
@@ -238,7 +238,7 @@ ide_vcs_get_priority (IdeVcs *self)
*
* This function is safe to call from threads holding a reference to @self.
*
- * Returns: (transfer none): A #GFile.
+ * Returns: (transfer none): a #GFile.
*
* Since: 3.18
*
diff --git a/src/libide/workbench/ide-perspective.c b/src/libide/workbench/ide-perspective.c
index 7f0c717..ba966e8 100644
--- a/src/libide/workbench/ide-perspective.c
+++ b/src/libide/workbench/ide-perspective.c
@@ -198,7 +198,7 @@ ide_perspective_get_title (IdePerspective *self)
* You may use #IdeHeaderBar for a base implementation to save you the trouble of
* creating a titlebar similar to other perspectives in Builder.
*
- * Returns: (transfer none) (nullable): A #GtkWidget or %NULL.
+ * Returns: (transfer none) (nullable): a #GtkWidget or %NULL.
*/
GtkWidget *
ide_perspective_get_titlebar (IdePerspective *self)
@@ -228,7 +228,7 @@ ide_perspective_set_fullscreen (IdePerspective *self,
/**
* ide_perspective_views_foreach:
* @self: An #IdePerspective.
- * @callback: (scope call): A #GtkCallback.
+ * @callback: (scope call): a #GtkCallback.
* @user_data: user data for @callback.
*
* This interface method is used to iterate all #IdeLayoutView's that are descendents of @self.
diff --git a/src/libide/workbench/ide-workbench-open.c b/src/libide/workbench/ide-workbench-open.c
index b46cb69..76dc4db 100644
--- a/src/libide/workbench/ide-workbench-open.c
+++ b/src/libide/workbench/ide-workbench-open.c
@@ -364,8 +364,8 @@ ide_workbench_open_files_cb (GObject *object,
* @hint: The id of an #IdeWorkbenchAddin that should be preferred as a loader.
* @flags: an #IdeWorkbenchOpenFlags (if WORKBENCH_OPEN_FLAGS_BG is set, the buffer is loaded
* but not made visible in the UI).
- * @cancellable: (nullable): A #GCancellable.
- * @callback: (scope async) (closure user_data): A #GAsyncReadyCallback or %NULL
+ * @cancellable: (nullable): a #GCancellable.
+ * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback or %NULL
* @user_data: User data for @callback
*
* Starts the process of loading the buffers for the given @files, possibly
diff --git a/src/libide/workers/ide-worker.c b/src/libide/workers/ide-worker.c
index db95bbf..d283892 100644
--- a/src/libide/workers/ide-worker.c
+++ b/src/libide/workers/ide-worker.c
@@ -40,13 +40,13 @@ ide_worker_register_service (IdeWorker *self,
/**
* ide_worker_create_proxy:
* @self: An #IdeWorker.
- * @connection: A #GDBusConnection connected to the worker process.
+ * @connection: a #GDBusConnection connected to the worker process.
* @error: (allow-none): a location for a #GError, or %NULL.
*
* Creates a new proxy to be connected to the subprocess peer on the other
* end of @connection.
*
- * Returns: (transfer full): A #GDBusProxy or %NULL.
+ * Returns: (transfer full): a #GDBusProxy or %NULL.
*/
GDBusProxy *
ide_worker_create_proxy (IdeWorker *self,
diff --git a/src/plugins/autotools/ide-autotools-project-miner.c
b/src/plugins/autotools/ide-autotools-project-miner.c
index 9013240..ec878e9 100644
--- a/src/plugins/autotools/ide-autotools-project-miner.c
+++ b/src/plugins/autotools/ide-autotools-project-miner.c
@@ -467,7 +467,7 @@ ide_autotools_project_miner_init (IdeAutotoolsProjectMiner *self)
* Gets the IdeAutotoolsProjectMiner:root-directory property.
* Scans will start from this directory.
*
- * Returns: (transfer none) (nullable): A #GFile or %NULL.
+ * Returns: (transfer none) (nullable): a #GFile or %NULL.
*/
GFile *
ide_autotools_project_miner_get_root_directory (IdeAutotoolsProjectMiner *self)
diff --git a/src/plugins/autotools/ide-makecache.c b/src/plugins/autotools/ide-makecache.c
index e359463..c1dff70 100644
--- a/src/plugins/autotools/ide-makecache.c
+++ b/src/plugins/autotools/ide-makecache.c
@@ -142,7 +142,7 @@ is_target_interesting (const gchar *target)
/**
* ide_makecache_get_file_targets_searched:
*
- * Returns: (transfer container): A #GPtrArray of #IdeMakecacheTarget.
+ * Returns: (transfer container): a #GPtrArray of #IdeMakecacheTarget.
*/
static GPtrArray *
ide_makecache_get_file_targets_searched (GMappedFile *mapped,
diff --git a/src/plugins/clang/ide-clang-symbol-tree.c b/src/plugins/clang/ide-clang-symbol-tree.c
index 8fe10b0..087711e 100644
--- a/src/plugins/clang/ide-clang-symbol-tree.c
+++ b/src/plugins/clang/ide-clang-symbol-tree.c
@@ -61,7 +61,7 @@ static GParamSpec *properties [LAST_PROP];
*
* Gets the #IdeClangSymbolTree:file property.
*
- * Returns: (transfer none): A #GFile.
+ * Returns: (transfer none): a #GFile.
*/
GFile *
ide_clang_symbol_tree_get_file (IdeClangSymbolTree *self)
diff --git a/src/plugins/clang/ide-clang-translation-unit.c b/src/plugins/clang/ide-clang-translation-unit.c
index fbcfac7..367d4a0 100644
--- a/src/plugins/clang/ide-clang-translation-unit.c
+++ b/src/plugins/clang/ide-clang-translation-unit.c
@@ -769,7 +769,7 @@ ide_clang_translation_unit_code_complete_async (IdeClangTranslationUnit *self,
/**
* ide_clang_translation_unit_code_complete_finish:
* @self: an #IdeClangTranslationUnit.
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: (out) (nullable): A location for a #GError, or %NULL.
*
* Completes a call to ide_clang_translation_unit_code_complete_async().
diff --git a/src/plugins/color-picker/gb-color-picker-editor-addin.c
b/src/plugins/color-picker/gb-color-picker-editor-addin.c
index 7f2f260..9e5138d 100644
--- a/src/plugins/color-picker/gb-color-picker-editor-addin.c
+++ b/src/plugins/color-picker/gb-color-picker-editor-addin.c
@@ -389,7 +389,7 @@ gb_color_picker_editor_addin_init (GbColorPickerEditorAddin *self)
*
* If no editor view is focused, %NULL is returned.
*
- * Returns: (transfer full): A #GstylePalette or %NULL.
+ * Returns: (transfer full): a #GstylePalette or %NULL.
*
* Since: 3.26
*/
diff --git a/src/plugins/command-bar/gb-command-bar.c b/src/plugins/command-bar/gb-command-bar.c
index 17b7376..2012d29 100644
--- a/src/plugins/command-bar/gb-command-bar.c
+++ b/src/plugins/command-bar/gb-command-bar.c
@@ -164,7 +164,7 @@ find_alternate_focus (GtkWidget *focus)
/**
* gb_command_bar_hide:
- * @bar: A #GbCommandBar
+ * @bar: a #GbCommandBar
*
* Hides the command bar in an animated fashion.
*/
@@ -203,7 +203,7 @@ gb_command_bar_set_last_focus (GbCommandBar *self,
/**
* gb_command_bar_show:
- * @bar: A #GbCommandBar
+ * @bar: a #GbCommandBar
*
* Shows the command bar in an animated fashion.
*/
diff --git a/src/plugins/command-bar/gb-command-provider.c b/src/plugins/command-bar/gb-command-provider.c
index e54c9b1..ea917fd 100644
--- a/src/plugins/command-bar/gb-command-provider.c
+++ b/src/plugins/command-bar/gb-command-provider.c
@@ -219,7 +219,7 @@ gb_command_provider_set_priority (GbCommandProvider *provider,
* @command_text: (in): Command text to be parsed
*
*
- * Returns: (transfer full): A #GbCommand if successful; otherwise %NULL.
+ * Returns: (transfer full): a #GbCommand if successful; otherwise %NULL.
*/
GbCommand *
gb_command_provider_lookup (GbCommandProvider *provider,
@@ -238,7 +238,7 @@ gb_command_provider_lookup (GbCommandProvider *provider,
/**
* gb_command_provider_complete:
* @provider: (in): The #GbCommandProvider
- * @completions: (in): A #GPtrArray where completed strings can be added
+ * @completions: (in): a #GPtrArray where completed strings can be added
* @command_text: (in): Initial command text to be completed
*
*/
@@ -384,7 +384,7 @@ gb_command_provider_class_init (GbCommandProviderClass *klass)
/**
* GbCommandProvider::complete:
- * @completions: (in): A #GPtrArray where completed strings can be added
+ * @completions: (in): a #GPtrArray where completed strings can be added
* @initial_command_text: (in): the command line text to be processed.
*
* This signal is emitted when a request to complete a command text is
diff --git a/src/plugins/flatpak/gbp-flatpak-application-addin.c
b/src/plugins/flatpak/gbp-flatpak-application-addin.c
index 54c27ff..43016d6 100644
--- a/src/plugins/flatpak/gbp-flatpak-application-addin.c
+++ b/src/plugins/flatpak/gbp-flatpak-application-addin.c
@@ -888,7 +888,7 @@ gbp_flatpak_application_addin_class_init (GbpFlatpakApplicationAddinClass *klass
/**
* GbpFlatpakApplicationAddin::runtime-added:
* @self: An #GbpFlatpakApplicationAddin
- * @runtime: A #FlatpakInstalledRef
+ * @runtime: a #FlatpakInstalledRef
*
* This signal is emitted when a new runtime is discovered. No deduplication
* is dealt with here, so consumers will need to ensure they have not seen
diff --git a/src/plugins/gdb/gbp-gdb-debugger.c b/src/plugins/gdb/gbp-gdb-debugger.c
index 0151c87..11f05ce 100644
--- a/src/plugins/gdb/gbp-gdb-debugger.c
+++ b/src/plugins/gdb/gbp-gdb-debugger.c
@@ -2700,7 +2700,7 @@ gbp_gdb_debugger_write_cb (GObject *object,
* @self: An #GbpGdbDebugger
* @thread: (nullable): An #IdeDebuggerThread or %NULL
* @command: the command to be executed
- * @cancellable: (nullable): A #GCancellable or %NULL
+ * @cancellable: (nullable): a #GCancellable or %NULL
* @user_data: user data for @cancellable
*
* Submits a command to the gdb process to be executed by the debugger.
@@ -2824,7 +2824,7 @@ gbp_gdb_debugger_exec_async (GbpGdbDebugger *self,
/**
* gbp_gdb_debugger_exec_finish:
- * @self: A #GbpGdbDebugger
+ * @self: a #GbpGdbDebugger
* @result: A result provided to the async callback
* @error: a location for a #GError, or %NULL
*
diff --git a/src/plugins/git/ide-git-vcs.c b/src/plugins/git/ide-git-vcs.c
index 114f152..addc73f 100644
--- a/src/plugins/git/ide-git-vcs.c
+++ b/src/plugins/git/ide-git-vcs.c
@@ -595,7 +595,7 @@ ide_git_vcs_class_init (IdeGitVcsClass *klass)
/**
* IdeGitVcs::reloaded:
* @self: An #IdeGitVfs
- * @repository: A #GgitRepository
+ * @repository: a #GgitRepository
*
* This signal is emitted when the git index has been reloaded. Various consumers may want to
* reload their git objects upon this notification. Such an example would be the line diffs
diff --git a/src/plugins/gnome-code-assistance/gca-diagnostics.c
b/src/plugins/gnome-code-assistance/gca-diagnostics.c
index e1219ef..c398b20 100644
--- a/src/plugins/gnome-code-assistance/gca-diagnostics.c
+++ b/src/plugins/gnome-code-assistance/gca-diagnostics.c
@@ -218,7 +218,7 @@ static const _ExtendedGDBusInterfaceInfo _gca_diagnostics_interface_info =
*
* Gets a machine-readable description of the <link
linkend="gdbus-interface-org-gnome-CodeAssist-v1-Diagnostics.top_of_page">org.gnome.CodeAssist.v1.Diagnostics</link>
D-Bus interface.
*
- * Returns: (transfer none): A #GDBusInterfaceInfo. Do not free.
+ * Returns: (transfer none): a #GDBusInterfaceInfo. Do not free.
*/
GDBusInterfaceInfo *
gca_diagnostics_interface_info (void)
@@ -267,8 +267,8 @@ gca_diagnostics_default_init (GcaDiagnosticsIface *iface)
/* GObject signals for incoming D-Bus method calls: */
/**
* GcaDiagnostics::handle-diagnostics:
- * @object: A #GcaDiagnostics.
- * @invocation: A #GDBusMethodInvocation.
+ * @object: a #GcaDiagnostics.
+ * @invocation: a #GDBusMethodInvocation.
*
* Signal emitted when a remote caller is invoking the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Diagnostics.Diagnostics">Diagnostics()</link> D-Bus method.
*
@@ -291,9 +291,9 @@ gca_diagnostics_default_init (GcaDiagnosticsIface *iface)
/**
* gca_diagnostics_call_diagnostics:
- * @proxy: A #GcaDiagnosticsProxy.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @proxy: a #GcaDiagnosticsProxy.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied or %NULL.
* @user_data: User data to pass to @callback.
*
* Asynchronously invokes the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Diagnostics.Diagnostics">Diagnostics()</link> D-Bus method on
@proxy.
@@ -321,7 +321,7 @@ gca_diagnostics_call_diagnostics (
/**
* gca_diagnostics_call_diagnostics_finish:
- * @proxy: A #GcaDiagnosticsProxy.
+ * @proxy: a #GcaDiagnosticsProxy.
* @out_unnamed_arg0: (out): Return location for return parameter or %NULL to ignore.
* @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
gca_diagnostics_call_diagnostics().
* @error: Return location for error or %NULL.
@@ -351,9 +351,9 @@ _out:
/**
* gca_diagnostics_call_diagnostics_sync:
- * @proxy: A #GcaDiagnosticsProxy.
+ * @proxy: a #GcaDiagnosticsProxy.
* @out_unnamed_arg0: (out): Return location for return parameter or %NULL to ignore.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @error: Return location for error or %NULL.
*
* Synchronously invokes the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Diagnostics.Diagnostics">Diagnostics()</link> D-Bus method on
@proxy. The calling thread is blocked until a reply is received.
@@ -389,8 +389,8 @@ _out:
/**
* gca_diagnostics_complete_diagnostics:
- * @object: A #GcaDiagnostics.
- * @invocation: (transfer full): A #GDBusMethodInvocation.
+ * @object: a #GcaDiagnostics.
+ * @invocation: (transfer full): a #GDBusMethodInvocation.
* @unnamed_arg0: Parameter to return.
*
* Helper function used in service implementations to finish handling invocations of the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Diagnostics.Diagnostics">Diagnostics()</link> D-Bus method. If
you instead want to finish handling an invocation by returning an error, use
g_dbus_method_invocation_return_error() or similar.
@@ -573,12 +573,12 @@ gca_diagnostics_proxy_iface_init (GcaDiagnosticsIface *iface)
/**
* gca_diagnostics_proxy_new:
- * @connection: A #GDBusConnection.
+ * @connection: a #GDBusConnection.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: (allow-none): A bus name (well-known or unique) or %NULL if @connection is not a message bus
connection.
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied.
* @user_data: User data to pass to @callback.
*
* Asynchronously creates a proxy for the D-Bus interface <link
linkend="gdbus-interface-org-gnome-CodeAssist-v1-Diagnostics.top_of_page">org.gnome.CodeAssist.v1.Diagnostics</link>.
See g_dbus_proxy_new() for more details.
@@ -628,11 +628,11 @@ gca_diagnostics_proxy_new_finish (
/**
* gca_diagnostics_proxy_new_sync:
- * @connection: A #GDBusConnection.
+ * @connection: a #GDBusConnection.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: (allow-none): A bus name (well-known or unique) or %NULL if @connection is not a message bus
connection.
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @error: Return location for error or %NULL
*
* Synchronously creates a proxy for the D-Bus interface <link
linkend="gdbus-interface-org-gnome-CodeAssist-v1-Diagnostics.top_of_page">org.gnome.CodeAssist.v1.Diagnostics</link>.
See g_dbus_proxy_new_sync() for more details.
@@ -663,12 +663,12 @@ gca_diagnostics_proxy_new_sync (
/**
* gca_diagnostics_proxy_new_for_bus:
- * @bus_type: A #GBusType.
+ * @bus_type: a #GBusType.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: A bus name (well-known or unique).
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied.
* @user_data: User data to pass to @callback.
*
* Like gca_diagnostics_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
@@ -718,11 +718,11 @@ gca_diagnostics_proxy_new_for_bus_finish (
/**
* gca_diagnostics_proxy_new_for_bus_sync:
- * @bus_type: A #GBusType.
+ * @bus_type: a #GBusType.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: A bus name (well-known or unique).
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @error: Return location for error or %NULL
*
* Like gca_diagnostics_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
diff --git a/src/plugins/gnome-code-assistance/gca-service.c b/src/plugins/gnome-code-assistance/gca-service.c
index 680ec9a..a3bbc66 100644
--- a/src/plugins/gnome-code-assistance/gca-service.c
+++ b/src/plugins/gnome-code-assistance/gca-service.c
@@ -302,7 +302,7 @@ static const _ExtendedGDBusInterfaceInfo _gca_service_interface_info =
*
* Gets a machine-readable description of the <link
linkend="gdbus-interface-org-gnome-CodeAssist-v1-Service.top_of_page">org.gnome.CodeAssist.v1.Service</link>
D-Bus interface.
*
- * Returns: (transfer none): A #GDBusInterfaceInfo. Do not free.
+ * Returns: (transfer none): a #GDBusInterfaceInfo. Do not free.
*/
GDBusInterfaceInfo *
gca_service_interface_info (void)
@@ -352,8 +352,8 @@ gca_service_default_init (GcaServiceIface *iface)
/* GObject signals for incoming D-Bus method calls: */
/**
* GcaService::handle-dispose:
- * @object: A #GcaService.
- * @invocation: A #GDBusMethodInvocation.
+ * @object: a #GcaService.
+ * @invocation: a #GDBusMethodInvocation.
* @arg_path: Argument passed by remote caller.
*
* Signal emitted when a remote caller is invoking the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Service.Dispose">Dispose()</link> D-Bus method.
@@ -375,8 +375,8 @@ gca_service_default_init (GcaServiceIface *iface)
/**
* GcaService::handle-parse:
- * @object: A #GcaService.
- * @invocation: A #GDBusMethodInvocation.
+ * @object: a #GcaService.
+ * @invocation: a #GDBusMethodInvocation.
* @arg_path: Argument passed by remote caller.
* @arg_data_path: Argument passed by remote caller.
* @arg_cursor: Argument passed by remote caller.
@@ -403,10 +403,10 @@ gca_service_default_init (GcaServiceIface *iface)
/**
* gca_service_call_dispose:
- * @proxy: A #GcaServiceProxy.
+ * @proxy: a #GcaServiceProxy.
* @arg_path: Argument to pass with the method invocation.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied or %NULL.
* @user_data: User data to pass to @callback.
*
* Asynchronously invokes the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Service.Dispose">Dispose()</link> D-Bus method on @proxy.
@@ -436,7 +436,7 @@ gca_service_call_dispose (
/**
* gca_service_call_dispose_finish:
- * @proxy: A #GcaServiceProxy.
+ * @proxy: a #GcaServiceProxy.
* @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gca_service_call_dispose().
* @error: Return location for error or %NULL.
*
@@ -463,9 +463,9 @@ _out:
/**
* gca_service_call_dispose_sync:
- * @proxy: A #GcaServiceProxy.
+ * @proxy: a #GcaServiceProxy.
* @arg_path: Argument to pass with the method invocation.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @error: Return location for error or %NULL.
*
* Synchronously invokes the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Service.Dispose">Dispose()</link> D-Bus method on @proxy. The
calling thread is blocked until a reply is received.
@@ -501,13 +501,13 @@ _out:
/**
* gca_service_call_parse:
- * @proxy: A #GcaServiceProxy.
+ * @proxy: a #GcaServiceProxy.
* @arg_path: Argument to pass with the method invocation.
* @arg_data_path: Argument to pass with the method invocation.
* @arg_cursor: Argument to pass with the method invocation.
* @arg_options: Argument to pass with the method invocation.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied or %NULL.
* @user_data: User data to pass to @callback.
*
* Asynchronously invokes the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Service.Parse">Parse()</link> D-Bus method on @proxy.
@@ -543,7 +543,7 @@ gca_service_call_parse (
/**
* gca_service_call_parse_finish:
- * @proxy: A #GcaServiceProxy.
+ * @proxy: a #GcaServiceProxy.
* @out_unnamed_arg4: (out): Return location for return parameter or %NULL to ignore.
* @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gca_service_call_parse().
* @error: Return location for error or %NULL.
@@ -573,13 +573,13 @@ _out:
/**
* gca_service_call_parse_sync:
- * @proxy: A #GcaServiceProxy.
+ * @proxy: a #GcaServiceProxy.
* @arg_path: Argument to pass with the method invocation.
* @arg_data_path: Argument to pass with the method invocation.
* @arg_cursor: Argument to pass with the method invocation.
* @arg_options: Argument to pass with the method invocation.
* @out_unnamed_arg4: (out): Return location for return parameter or %NULL to ignore.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @error: Return location for error or %NULL.
*
* Synchronously invokes the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Service.Parse">Parse()</link> D-Bus method on @proxy. The
calling thread is blocked until a reply is received.
@@ -623,8 +623,8 @@ _out:
/**
* gca_service_complete_dispose:
- * @object: A #GcaService.
- * @invocation: (transfer full): A #GDBusMethodInvocation.
+ * @object: a #GcaService.
+ * @invocation: (transfer full): a #GDBusMethodInvocation.
*
* Helper function used in service implementations to finish handling invocations of the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Service.Dispose">Dispose()</link> D-Bus method. If you instead
want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or
similar.
*
@@ -641,8 +641,8 @@ gca_service_complete_dispose (
/**
* gca_service_complete_parse:
- * @object: A #GcaService.
- * @invocation: (transfer full): A #GDBusMethodInvocation.
+ * @object: a #GcaService.
+ * @invocation: (transfer full): a #GDBusMethodInvocation.
* @unnamed_arg4: Parameter to return.
*
* Helper function used in service implementations to finish handling invocations of the <link
linkend="gdbus-method-org-gnome-CodeAssist-v1-Service.Parse">Parse()</link> D-Bus method. If you instead want
to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or
similar.
@@ -825,12 +825,12 @@ gca_service_proxy_iface_init (GcaServiceIface *iface)
/**
* gca_service_proxy_new:
- * @connection: A #GDBusConnection.
+ * @connection: a #GDBusConnection.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: (allow-none): A bus name (well-known or unique) or %NULL if @connection is not a message bus
connection.
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied.
* @user_data: User data to pass to @callback.
*
* Asynchronously creates a proxy for the D-Bus interface <link
linkend="gdbus-interface-org-gnome-CodeAssist-v1-Service.top_of_page">org.gnome.CodeAssist.v1.Service</link>.
See g_dbus_proxy_new() for more details.
@@ -880,11 +880,11 @@ gca_service_proxy_new_finish (
/**
* gca_service_proxy_new_sync:
- * @connection: A #GDBusConnection.
+ * @connection: a #GDBusConnection.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: (allow-none): A bus name (well-known or unique) or %NULL if @connection is not a message bus
connection.
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @error: Return location for error or %NULL
*
* Synchronously creates a proxy for the D-Bus interface <link
linkend="gdbus-interface-org-gnome-CodeAssist-v1-Service.top_of_page">org.gnome.CodeAssist.v1.Service</link>.
See g_dbus_proxy_new_sync() for more details.
@@ -915,12 +915,12 @@ gca_service_proxy_new_sync (
/**
* gca_service_proxy_new_for_bus:
- * @bus_type: A #GBusType.
+ * @bus_type: a #GBusType.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: A bus name (well-known or unique).
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied.
* @user_data: User data to pass to @callback.
*
* Like gca_service_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
@@ -970,11 +970,11 @@ gca_service_proxy_new_for_bus_finish (
/**
* gca_service_proxy_new_for_bus_sync:
- * @bus_type: A #GBusType.
+ * @bus_type: a #GBusType.
* @flags: Flags from the #GDBusProxyFlags enumeration.
* @name: A bus name (well-known or unique).
* @object_path: An object path.
- * @cancellable: (allow-none): A #GCancellable or %NULL.
+ * @cancellable: (allow-none): a #GCancellable or %NULL.
* @error: Return location for error or %NULL
*
* Like gca_service_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
diff --git a/src/plugins/gnome-code-assistance/ide-gca-service.c
b/src/plugins/gnome-code-assistance/ide-gca-service.c
index b6ce746..89d3fd0 100644
--- a/src/plugins/gnome-code-assistance/ide-gca-service.c
+++ b/src/plugins/gnome-code-assistance/ide-gca-service.c
@@ -215,7 +215,7 @@ ide_gca_service_get_proxy_async (IdeGcaService *self,
*
* Completes an asynchronous request to load a Gca proxy.
*
- * Returns: (transfer full): A #GcaService or %NULL upon failure.
+ * Returns: (transfer full): a #GcaService or %NULL upon failure.
*/
GcaService *
ide_gca_service_get_proxy_finish (IdeGcaService *self,
diff --git a/src/plugins/history/gbp-history-item.c b/src/plugins/history/gbp-history-item.c
index d291be3..4d36777 100644
--- a/src/plugins/history/gbp-history-item.c
+++ b/src/plugins/history/gbp-history-item.c
@@ -193,7 +193,7 @@ gbp_history_item_get_location (GbpHistoryItem *self)
/**
* gbp_history_item_get_file:
*
- * Returns: (transfer none): A #GFile.
+ * Returns: (transfer none): a #GFile.
*/
GFile *
gbp_history_item_get_file (GbpHistoryItem *self)
diff --git a/src/plugins/project-tree/gb-new-file-popover.c b/src/plugins/project-tree/gb-new-file-popover.c
index 2b90299..0635360 100644
--- a/src/plugins/project-tree/gb-new-file-popover.c
+++ b/src/plugins/project-tree/gb-new-file-popover.c
@@ -223,10 +223,10 @@ gb_new_file_popover_get_property (GObject *object,
/**
* gb_new_file_popover_set_property:
- * @object: (in): A #GObject.
+ * @object: (in): a #GObject.
* @prop_id: (in): The property identifier.
* @value: (in): The given property.
- * @pspec: (in): A #ParamSpec.
+ * @pspec: (in): a #ParamSpec.
*
* Set a given #GObject property.
*/
@@ -373,7 +373,7 @@ gb_new_file_popover_set_directory (GbNewFilePopover *self,
/**
* gb_new_file_popover_get_directory:
*
- * Returns: (transfer none) (nullable): A #GFile or %NULL.
+ * Returns: (transfer none) (nullable): a #GFile or %NULL.
*/
GFile *
gb_new_file_popover_get_directory (GbNewFilePopover *self)
diff --git a/src/plugins/spellcheck/gbp-spell-buffer-addin.c b/src/plugins/spellcheck/gbp-spell-buffer-addin.c
index dc0cc61..835df16 100644
--- a/src/plugins/spellcheck/gbp-spell-buffer-addin.c
+++ b/src/plugins/spellcheck/gbp-spell-buffer-addin.c
@@ -247,7 +247,7 @@ gbp_spell_buffer_addin_init (GbpSpellBufferAddin *self)
* Gets the #GspellChecker used by the underlying buffer, or %NULL if
* no spellchecker is active.
*
- * Returns: (transfer none): A #GspellChecker
+ * Returns: (transfer none): a #GspellChecker
*
* Since: 3.26
*/
@@ -326,7 +326,7 @@ gbp_spell_buffer_addin_end_checking (GbpSpellBufferAddin *self)
*
* Gets the tag to use for the current misspelled word.
*
- * Returns: (nullable) (transfer none): A #GtkTextTag or %NULL.
+ * Returns: (nullable) (transfer none): a #GtkTextTag or %NULL.
*/
GtkTextTag *
gbp_spell_buffer_addin_get_misspelled_tag (GbpSpellBufferAddin *self)
diff --git a/src/plugins/spellcheck/gbp-spell-editor-view-addin.c
b/src/plugins/spellcheck/gbp-spell-editor-view-addin.c
index 0aab67b..15d36d0 100644
--- a/src/plugins/spellcheck/gbp-spell-editor-view-addin.c
+++ b/src/plugins/spellcheck/gbp-spell-editor-view-addin.c
@@ -342,7 +342,7 @@ gbp_spell_editor_view_addin_end_checking (GbpSpellEditorViewAddin *self)
* This function may return %NULL before
* gbp_spell_editor_view_addin_begin_checking() has been called.
*
- * Returns: (nullable) (transfer none): A #GspellChecker or %NULL
+ * Returns: (nullable) (transfer none): a #GspellChecker or %NULL
*
* Since: 3.26
*/
@@ -367,7 +367,7 @@ gbp_spell_editor_view_addin_get_checker (GbpSpellEditorViewAddin *self)
* This function may return %NULL before
* gbp_spell_editor_view_addin_begin_checking() has been called.
*
- * Returns: (nullable) (transfer none): A #GspellNavigator or %NULL
+ * Returns: (nullable) (transfer none): a #GspellNavigator or %NULL
*
* Since: 3.26
*/
diff --git a/src/plugins/todo/gbp-todo-model.c b/src/plugins/todo/gbp-todo-model.c
index 005aac6..4ecf86e 100644
--- a/src/plugins/todo/gbp-todo-model.c
+++ b/src/plugins/todo/gbp-todo-model.c
@@ -508,8 +508,8 @@ gbp_todo_model_mine_worker (GTask *task,
/**
* gbp_todo_model_mine_async:
* @self: a #GbpTodoModel
- * @file: A #GFile to mine
- * @cancellable: (nullable): A #Gancellable or %NULL
+ * @file: a #GFile to mine
+ * @cancellable: (nullable): a #Gancellable or %NULL
* @callback: (scope async) (closure user_data): An async callback
* @user_data: user data for @callback
*
@@ -557,7 +557,7 @@ gbp_todo_model_mine_async (GbpTodoModel *self,
/**
* gbp_todo_model_mine_finish:
* @self: a #GbpTodoModel
- * @result: A #GAsyncResult
+ * @result: a #GAsyncResult
* @error: A location for a #GError or %NULL
*
* Completes an asynchronous request to gbp_todo_model_mine_async().
diff --git a/src/plugins/todo/gbp-todo-panel.c b/src/plugins/todo/gbp-todo-panel.c
index d1546a0..3c429df 100644
--- a/src/plugins/todo/gbp-todo-panel.c
+++ b/src/plugins/todo/gbp-todo-panel.c
@@ -322,7 +322,7 @@ gbp_todo_panel_init (GbpTodoPanel *self)
*
* Gets the model being displayed by the treeview.
*
- * Returns: (transfer none) (nullable): A #GbpTodoModel.
+ * Returns: (transfer none) (nullable): a #GbpTodoModel.
*/
GbpTodoModel *
gbp_todo_panel_get_model (GbpTodoPanel *self)
diff --git a/src/plugins/xml-pack/ide-xml-analysis.c b/src/plugins/xml-pack/ide-xml-analysis.c
index 33ca3f3..fb78903 100644
--- a/src/plugins/xml-pack/ide-xml-analysis.c
+++ b/src/plugins/xml-pack/ide-xml-analysis.c
@@ -59,7 +59,7 @@ ide_xml_analysis_get_root_node (IdeXmlAnalysis *self)
/**
* ide_xml_analysis_get_schemas:
- * @self: A #GPtrArray.
+ * @self: a #GPtrArray.
*
* Returns: (nullable) (transfer none): The schemas entries #GPtrArray contained by the analysis.
*
diff --git a/src/plugins/xml-pack/ide-xml-service.c b/src/plugins/xml-pack/ide-xml-service.c
index ab6659b..2811db4 100644
--- a/src/plugins/xml-pack/ide-xml-service.c
+++ b/src/plugins/xml-pack/ide-xml-service.c
@@ -1191,7 +1191,7 @@ ide_xml_service_get_cached_diagnostics (IdeXmlService *self,
*
* Gets the #DzlTaskCache for the xml schemas.
*
- * Returns: (transfer NULL): A #DzlTaskCache.
+ * Returns: (transfer NULL): a #DzlTaskCache.
*/
DzlTaskCache *
ide_xml_service_get_schemas_cache (IdeXmlService *self)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
