[gnome-builder] doc: prefer "an" over "A" when #Ide is used

From: Christian Hergert <chergert src gnome org>
To: commits-list gnome org
Cc:
Subject: [gnome-builder] doc: prefer "an" over "A" when #Ide is used
Date: Tue, 7 Nov 2017 00:21:15 +0000 (UTC)
commit 3987d36e31f55a40f7a281a59a9e9e0324f03b1c
Author: Christian Hergert <chergert redhat com>
Date:   Mon Nov 6 16:21:01 2017 -0800

    doc: prefer "an" over "A" when #Ide is used

 src/libide/application/ide-application.c           |    6 +-
 src/libide/buffers/ide-buffer-manager.c            |    2 +-
 src/libide/buffers/ide-buffer.c                    |   50 ++++++++++----------
 src/libide/buffers/ide-unsaved-file.c              |    2 +-
 src/libide/buildsystem/ide-build-pipeline.c        |    6 +-
 src/libide/buildsystem/ide-build-stage.h           |    4 +-
 src/libide/buildsystem/ide-configuration.c         |    2 +-
 src/libide/diagnostics/ide-diagnostic.c            |    6 +-
 src/libide/diagnostics/ide-diagnostics-manager.c   |    2 +-
 src/libide/diagnostics/ide-fixit.c                 |    4 +-
 src/libide/diagnostics/ide-source-location.c       |    2 +-
 src/libide/editor/ide-editor-perspective.c         |    2 +-
 src/libide/editor/ide-editor-properties.c          |    2 +-
 src/libide/files/ide-file.c                        |    4 +-
 src/libide/highlighting/ide-highlight-engine.c     |    4 +-
 src/libide/highlighting/ide-highlighter.c          |    2 +-
 src/libide/ide-context.c                           |    2 +-
 src/libide/ide-object.c                            |    2 +-
 src/libide/langserv/ide-langserv-client.c          |    2 +-
 src/libide/langserv/ide-langserv-rename-provider.c |    2 +-
 src/libide/layout/ide-layout-grid.c                |    2 +-
 src/libide/layout/ide-layout-stack-addin.c         |    2 +-
 src/libide/layout/ide-layout-stack.c               |    2 +-
 src/libide/plugins/ide-extension-set-adapter.c     |    2 +-
 src/libide/projects/ide-project-files.c            |    2 +-
 src/libide/projects/ide-project-info.c             |    4 +-
 src/libide/projects/ide-project.c                  |    4 +-
 src/libide/sourceview/ide-source-view.c            |    4 +-
 src/libide/subprocess/ide-subprocess-launcher.c    |    4 +-
 src/libide/symbols/ide-code-indexer.c              |    2 +-
 src/libide/symbols/ide-symbol-resolver.c           |    2 +-
 src/libide/symbols/ide-symbol-tree.c               |    2 +-
 src/libide/workbench/ide-workbench-open.c          |    2 +-
 src/plugins/clang/ide-clang-completion-item.c      |    2 +-
 src/plugins/clang/ide-clang-service.c              |    2 +-
 src/plugins/clang/ide-clang-symbol-tree.c          |    2 +-
 src/plugins/clang/ide-clang-translation-unit.c     |    4 +-
 src/plugins/command-bar/gb-command-provider.c      |    2 +-
 src/plugins/ctags/ide-ctags-index.c                |    2 +-
 src/plugins/xml-pack/ide-xml-analysis.c            |    4 +-
 src/plugins/xml-pack/ide-xml-service.c             |    2 +-
 src/plugins/xml-pack/ide-xml-symbol-tree.c         |    2 +-
 42 files changed, 82 insertions(+), 82 deletions(-)
---
diff --git a/src/libide/application/ide-application.c b/src/libide/application/ide-application.c
index ec1798c..fbf8730 100644
--- a/src/libide/application/ide-application.c
+++ b/src/libide/application/ide-application.c
@@ -627,7 +627,7 @@ ide_application_get_worker_cb (GObject      *object,
 
 /**
  * ide_application_get_worker_async:
- * @self: A #IdeApplication
+ * @self: an #IdeApplication
  * @plugin_name: The name of the plugin.
  * @cancellable: (allow-none): A #GCancellable or %NULL.
  * @callback: A #GAsyncReadyCallback or %NULL.
@@ -673,7 +673,7 @@ ide_application_get_worker_async (IdeApplication      *self,
 
 /**
  * ide_application_get_worker_finish:
- * @self: A #IdeApplication.
+ * @self: an #IdeApplication.
  * @result: A #GAsyncResult
  * @error: a location for a #GError, or %NULL.
  *
@@ -782,7 +782,7 @@ ide_application_get_keybindings_mode (IdeApplication *self)
 
 /**
  * ide_application_get_started_at:
- * @self: A #IdeApplication.
+ * @self: an #IdeApplication.
  *
  * Gets the startup time of the application.
  *
diff --git a/src/libide/buffers/ide-buffer-manager.c b/src/libide/buffers/ide-buffer-manager.c
index ff3a1e9..39c55cb 100644
--- a/src/libide/buffers/ide-buffer-manager.c
+++ b/src/libide/buffers/ide-buffer-manager.c
@@ -1759,7 +1759,7 @@ ide_buffer_manager_get_buffers (IdeBufferManager *self)
 
 /**
  * ide_buffer_manager_get_word_completion:
- * @self: A #IdeBufferManager.
+ * @self: an #IdeBufferManager.
  *
  * Gets the #GtkSourceCompletionWords completion provider that will complete
  * words using the loaded documents.
diff --git a/src/libide/buffers/ide-buffer.c b/src/libide/buffers/ide-buffer.c
index cf66e1d..2f8e049 100644
--- a/src/libide/buffers/ide-buffer.c
+++ b/src/libide/buffers/ide-buffer.c
@@ -204,7 +204,7 @@ ide_buffer_delay_settling (IdeBuffer *self)
 
 /**
  * ide_buffer_get_has_diagnostics:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the #IdeBuffer:has-diagnostics property.
  * Return whether the buffer contains diagnostic messages or not.
@@ -224,7 +224,7 @@ ide_buffer_get_has_diagnostics (IdeBuffer *self)
 
 /**
  * ide_buffer_get_busy:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the #IdeBuffer:busy property.
  * Return whether the buffer is performing background work or not.
@@ -1820,7 +1820,7 @@ ide_buffer_update_title (IdeBuffer *self)
 
 /**
  * ide_buffer_get_file:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the underlying file behind the buffer.
  *
@@ -1838,7 +1838,7 @@ ide_buffer_get_file (IdeBuffer *self)
 
 /**
  * ide_buffer_set_file:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @file: An #IdeFile.
  *
  * Sets the underlying file to use when saving and loading @self to and from storage.
@@ -1874,7 +1874,7 @@ ide_buffer_set_file (IdeBuffer *self,
 
 /**
  * ide_buffer_get_context:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the #IdeBuffer:context property. This is the #IdeContext that owns the buffer.
  *
@@ -1892,7 +1892,7 @@ ide_buffer_get_context (IdeBuffer *self)
 
 /**
  * ide_buffer_get_line_flags:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @line: a buffer line number.
  *
  * Return the flags set for the #IdeBuffer @line number.
@@ -1965,7 +1965,7 @@ ide_buffer_get_line_flags (IdeBuffer *self,
 
 /**
  * ide_buffer_get_highlight_diagnostics:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the #IdeBuffer:highlight-diagnostics property.
  * Return whether the diagnostic warnings and errors should be highlighted.
@@ -1984,7 +1984,7 @@ ide_buffer_get_highlight_diagnostics (IdeBuffer *self)
 
 /**
  * ide_buffer_set_highlight_diagnostics:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @highlight_diagnostics: Whether to highlight the diagnostics or not.
  *
  * Sets the #IdeBuffer:highlight-diagnostics property.
@@ -2010,7 +2010,7 @@ ide_buffer_set_highlight_diagnostics (IdeBuffer *self,
 
 /**
  * ide_buffer_get_diagnostic_at_iter:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @iter: a #GtkTextIter.
  *
  * Gets the first diagnostic that overlaps the position
@@ -2111,7 +2111,7 @@ ide_buffer_can_do_newline_hack (IdeBuffer *self,
 
 /**
  * ide_buffer_get_content:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the contents of the buffer as GBytes.
  *
@@ -2187,7 +2187,7 @@ ide_buffer_get_content (IdeBuffer *self)
 
 /**
  * ide_buffer_trim_trailing_whitespace:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Trim trailing whitespaces from the buffer.
  *
@@ -2263,7 +2263,7 @@ ide_buffer_trim_trailing_whitespace (IdeBuffer *self)
 
 /**
  * ide_buffer_get_title:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the #IdeBuffer:title property. This property contains a title for the buffer suitable
  * for display.
@@ -2282,7 +2282,7 @@ ide_buffer_get_title (IdeBuffer *self)
 
 /**
  * ide_buffer_get_style_scheme_name:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the #IdeBuffer:style-scheme-name property.
  * This property contains the current style scheme used by the buffer.
@@ -2305,7 +2305,7 @@ ide_buffer_get_style_scheme_name (IdeBuffer *self)
 
 /**
  * ide_buffer_set_style_scheme_name:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @style_scheme_name: A string containing the name of the style scheme to use.
  *
  * Sets the #IdeBuffer:style-scheme-name property.
@@ -2362,7 +2362,7 @@ _ide_buffer_set_loading (IdeBuffer *self,
 
 /**
  * ide_buffer_get_read_only:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the #IdeBuffer:read-only property. This property indicate if the underlying file is read only or not.
  *
@@ -2397,7 +2397,7 @@ _ide_buffer_set_read_only (IdeBuffer *self,
 
 /**
  * ide_buffer_get_changed_on_volume:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets if the file backing the buffer has changed on the underlying storage.
  *
@@ -2476,7 +2476,7 @@ ide_buffer__check_for_volume_cb (GObject      *object,
 
 /**
  * ide_buffer_check_for_volume_change:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Update the #IdeBuffer:read-only property and the corresponding
  * modification time (mtime).
@@ -2534,7 +2534,7 @@ _ide_buffer_set_mtime (IdeBuffer      *self,
 
 /**
  * ide_buffer_get_iter_at_source_location:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @iter: (out): a #GtkTextIter.
  * @location: a #IdeSourceLocation.
  *
@@ -2561,7 +2561,7 @@ ide_buffer_get_iter_at_source_location (IdeBuffer         *self,
 
 /**
  * ide_buffer_rehighlight:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Force the #IdeBuffer to rebuild the highlight.
  *
@@ -2655,7 +2655,7 @@ ide_buffer_get_symbol_at_location_cb (GObject      *object,
 
 /**
  * ide_buffer_get_symbol_at_location_async:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @location: a #GtkTextIter indicating a position to search for a symbol.
  * @cancellable: A #GCancellable.
  * @callback: A #GAsyncReadyCallback.
@@ -2728,7 +2728,7 @@ ide_buffer_get_symbol_at_location_async (IdeBuffer           *self,
 
 /**
  * ide_buffer_get_symbol_at_location_finish:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @result: A #GAsyncResult.
  * @error: (out): A #GError.
  *
@@ -2749,7 +2749,7 @@ ide_buffer_get_symbol_at_location_finish (IdeBuffer     *self,
 
 /**
  * ide_buffer_get_symbols_finish:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Returns: (transfer container) (element-type IdeSymbol*): A #GPtrArray if successful;
  *   otherwise %NULL.
@@ -2841,7 +2841,7 @@ ide_buffer_release (IdeBuffer *self)
 
 /**
  * ide_buffer_get_selection_bounds:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @insert: (out): A #GtkTextIter to get the insert position.
  * @selection: (out): A #GtkTextIter to get the selection position.
  *
@@ -2897,7 +2897,7 @@ ide_buffer_get_rename_provider (IdeBuffer *self)
 
 /**
  * ide_buffer_get_symbol_resolvers:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  *
  * Gets the symbol resolvers for the buffer based on the current language.
  *
@@ -2915,7 +2915,7 @@ ide_buffer_get_symbol_resolvers (IdeBuffer *self)
 
 /**
  * ide_buffer_get_word_at_iter:
- * @self: A #IdeBuffer.
+ * @self: an #IdeBuffer.
  * @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 e8e502a..ba80f9e 100644
--- a/src/libide/buffers/ide-unsaved-file.c
+++ b/src/libide/buffers/ide-unsaved-file.c
@@ -128,7 +128,7 @@ ide_unsaved_file_unref (IdeUnsavedFile *self)
 
 /**
  * ide_unsaved_file_get_content:
- * @self: A #IdeUnsavedFile.
+ * @self: an #IdeUnsavedFile.
  *
  * Gets the contents of the unsaved file.
  *
diff --git a/src/libide/buildsystem/ide-build-pipeline.c b/src/libide/buildsystem/ide-build-pipeline.c
index 05da86b..854d39b 100644
--- a/src/libide/buildsystem/ide-build-pipeline.c
+++ b/src/libide/buildsystem/ide-build-pipeline.c
@@ -1808,7 +1808,7 @@ ide_build_pipeline_execute_finish (IdeBuildPipeline  *self,
 
 /**
  * ide_build_pipeline_connect:
- * @self: A #IdeBuildPipeline
+ * @self: an #IdeBuildPipeline
  * @phase: An #IdeBuildPhase
  * @priority: an optional priority for sorting within the phase
  * @stage: An #IdeBuildStage
@@ -1880,7 +1880,7 @@ cleanup:
 
 /**
  * ide_build_pipeline_connect_launcher:
- * @self: A #IdeBuildPipeline
+ * @self: an #IdeBuildPipeline
  * @phase: An #IdeBuildPhase
  * @priority: an optional priority for sorting within the phase
  * @launcher: An #IdeSubprocessLauncher
@@ -2297,7 +2297,7 @@ ide_build_pipeline_emit_diagnostic (IdeBuildPipeline *self,
 
 /**
  * ide_build_pipeline_add_error_format:
- * @self: A #IdeBuildPipeline
+ * @self: an #IdeBuildPipeline
  * @regex: A regex to be compiled
  *
  * This can be used to add a regex that will extract errors from
diff --git a/src/libide/buildsystem/ide-build-stage.h b/src/libide/buildsystem/ide-build-stage.h
index 3fa7a8d..aeafd66 100644
--- a/src/libide/buildsystem/ide-build-stage.h
+++ b/src/libide/buildsystem/ide-build-stage.h
@@ -76,7 +76,7 @@ struct _IdeBuildStageClass
 
   /**
    * IdeBuildStage::clean_async:
-   * @self: A #IdeBuildStage
+   * @self: an #IdeBuildStage
    * @pipeline: An #IdeBuildPipeline
    * @cancellable: (nullable): A #GCancellable or %NULL
    * @callback: An async callback
@@ -92,7 +92,7 @@ struct _IdeBuildStageClass
 
   /**
    * IdeBuildStage::clean_finish:
-   * @self: A #IdeBuildStage
+   * @self: an #IdeBuildStage
    * @result: A #GErrorResult
    * @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 a5916ea..f870f42 100644
--- a/src/libide/buildsystem/ide-configuration.c
+++ b/src/libide/buildsystem/ide-configuration.c
@@ -1543,7 +1543,7 @@ ide_configuration_get_internal_object (IdeConfiguration *self,
 
 /**
  * ide_configuration_set_internal_object:
- * @self: A #IdeConfiguration
+ * @self: an #IdeConfiguration
  * @key: the key to set
  * @instance: (type GObject.Object) (nullable): A #GObject or %NULL
  *
diff --git a/src/libide/diagnostics/ide-diagnostic.c b/src/libide/diagnostics/ide-diagnostic.c
index 0388cb0..71afe5d 100644
--- a/src/libide/diagnostics/ide-diagnostic.c
+++ b/src/libide/diagnostics/ide-diagnostic.c
@@ -226,7 +226,7 @@ ide_diagnostic_new (IdeDiagnosticSeverity  severity,
 
 /**
  * ide_diagnostic_take_fixit:
- * @self: A #IdeDiagnostic.
+ * @self: an #IdeDiagnostic.
  * @fixit: (transfer full): An #IdeFixit.
  *
  * Adds the suggested fixit to the diagnostic while transfering ownership
@@ -247,7 +247,7 @@ ide_diagnostic_take_fixit (IdeDiagnostic *self,
 
 /**
  * ide_diagnostic_take_range:
- * @self: A #IdeDiagnostic.
+ * @self: an #IdeDiagnostic.
  * @range: (transfer full): An #IdeSourceRange.
  *
  * Steals the ownership of @range and adds to the diagnostic.
@@ -327,7 +327,7 @@ ide_diagnostic_get_num_fixits (IdeDiagnostic *self)
 
 /**
  * ide_diagnostic_get_fixit:
- * @self: A #IdeDiagnostic.
+ * @self: an #IdeDiagnostic.
  * @index: The index of the fixit.
  *
  * Gets the fixit denoted by @index. This value should be less than the value
diff --git a/src/libide/diagnostics/ide-diagnostics-manager.c 
b/src/libide/diagnostics/ide-diagnostics-manager.c
index 82ba882..9c5d269 100644
--- a/src/libide/diagnostics/ide-diagnostics-manager.c
+++ b/src/libide/diagnostics/ide-diagnostics-manager.c
@@ -581,7 +581,7 @@ ide_diagnostics_manager_class_init (IdeDiagnosticsManagerClass *klass)
 
   /**
    * IdeDiagnosticsManager::changed:
-   * @self: A #IdeDiagnosticsManager
+   * @self: an #IdeDiagnosticsManager
    *
    * This signal is emitted when the diagnostics have changed for any
    * file managed by the IdeDiagnosticsManager.
diff --git a/src/libide/diagnostics/ide-fixit.c b/src/libide/diagnostics/ide-fixit.c
index b29f0f0..1a8ceee 100644
--- a/src/libide/diagnostics/ide-fixit.c
+++ b/src/libide/diagnostics/ide-fixit.c
@@ -89,7 +89,7 @@ ide_fixit_apply (IdeFixit *self)
 
 /**
  * ide_fixit_get_text:
- * @self: A #IdeFixit.
+ * @self: an #IdeFixit.
  *
  * Gets the text to replace the source range with.
  *
@@ -105,7 +105,7 @@ ide_fixit_get_text (IdeFixit *self)
 
 /**
  * ide_fixit_get_range:
- * @self: A #IdeFixit.
+ * @self: an #IdeFixit.
  *
  * Gets the range for the replacement text. The range is non inclusive of the
  * end location. [a,b)
diff --git a/src/libide/diagnostics/ide-source-location.c b/src/libide/diagnostics/ide-source-location.c
index ace72dd..5dc4bbf 100644
--- a/src/libide/diagnostics/ide-source-location.c
+++ b/src/libide/diagnostics/ide-source-location.c
@@ -171,7 +171,7 @@ ide_source_location_new (IdeFile *file,
 
 /**
  * ide_source_location_get_uri:
- * @self: (in): A #IdeSourceLocation.
+ * @self: (in): an #IdeSourceLocation.
  *
  * Returns: (transfer full): A newly allocated #IdeUri.
  */
diff --git a/src/libide/editor/ide-editor-perspective.c b/src/libide/editor/ide-editor-perspective.c
index c850aaf..ec584c7 100644
--- a/src/libide/editor/ide-editor-perspective.c
+++ b/src/libide/editor/ide-editor-perspective.c
@@ -586,7 +586,7 @@ ide_editor_perspective_get_active_view (IdeEditorPerspective *self)
  *
  * Gets the #IdeEditorSidebar for the editor perspective.
  *
- * Returns: (transfer none): A #IdeEditorSidebar
+ * Returns: (transfer none): an #IdeEditorSidebar
  *
  * Since: 3.26
  */
diff --git a/src/libide/editor/ide-editor-properties.c b/src/libide/editor/ide-editor-properties.c
index 67b9b95..e304c28 100644
--- a/src/libide/editor/ide-editor-properties.c
+++ b/src/libide/editor/ide-editor-properties.c
@@ -399,7 +399,7 @@ ide_editor_properties_init (IdeEditorProperties *self)
  *
  * Creates a new #IdeEditorProperties.
  *
- * Returns: (transfer full): A #IdeEditorProperties
+ * Returns: (transfer full): an #IdeEditorProperties
  *
  * Since: 3.26
  */
diff --git a/src/libide/files/ide-file.c b/src/libide/files/ide-file.c
index 226f314..e2c70fb 100644
--- a/src/libide/files/ide-file.c
+++ b/src/libide/files/ide-file.c
@@ -186,7 +186,7 @@ ide_file_set_file (IdeFile *self,
 
 /**
  * _ide_file_get_source_file:
- * @self: (in): A #IdeFile.
+ * @self: (in): an #IdeFile.
  *
  * Gets the GtkSourceFile for the #IdeFile.
  *
@@ -337,7 +337,7 @@ ide_file_load_settings_finish (IdeFile              *self,
 
 /**
  * ide_file_get_temporary_id:
- * @self: (in): A #IdeFile.
+ * @self: (in): an #IdeFile.
  *
  * Gets the #IdeFile:temporary-id property for the file.
  *
diff --git a/src/libide/highlighting/ide-highlight-engine.c b/src/libide/highlighting/ide-highlight-engine.c
index eb8d676..18ddbc0 100644
--- a/src/libide/highlighting/ide-highlight-engine.c
+++ b/src/libide/highlighting/ide-highlight-engine.c
@@ -952,7 +952,7 @@ ide_highlight_engine_new (IdeBuffer *buffer)
 
 /**
  * ide_highlight_engine_get_highlighter:
- * @self: A #IdeHighlightEngine.
+ * @self: an #IdeHighlightEngine.
  *
  * Gets the IdeHighlightEngine:highlighter property.
  *
@@ -968,7 +968,7 @@ ide_highlight_engine_get_highlighter (IdeHighlightEngine *self)
 
 /**
  * ide_highlight_engine_get_buffer:
- * @self: A #IdeHighlightEngine.
+ * @self: an #IdeHighlightEngine.
  *
  * Gets the IdeHighlightEngine:buffer property.
  *
diff --git a/src/libide/highlighting/ide-highlighter.c b/src/libide/highlighting/ide-highlighter.c
index fbb768a..6540971 100644
--- a/src/libide/highlighting/ide-highlighter.c
+++ b/src/libide/highlighting/ide-highlighter.c
@@ -54,7 +54,7 @@ ide_highlighter_default_init (IdeHighlighterInterface *iface)
 
 /**
  * ide_highlighter_update:
- * @self: A #IdeHighlighter.
+ * @self: an #IdeHighlighter.
  * @callback: (scope call): A callback to apply a given style.
  * @range_begin: The beginning of the range to update.
  * @range_end: The end of the range to update.
diff --git a/src/libide/ide-context.c b/src/libide/ide-context.c
index 1c46115..cae7fb4 100644
--- a/src/libide/ide-context.c
+++ b/src/libide/ide-context.c
@@ -249,7 +249,7 @@ ide_context_get_device_manager (IdeContext *self)
  *
  * Returns the #IdeDocumentation for the source view if there is one.
  *
- * Returns: (transfer none) (nullable): A #IdeDocumentation or %NULL.
+ * Returns: (transfer none) (nullable): an #IdeDocumentation or %NULL.
  */
 IdeDocumentation *
 ide_context_get_documentation (IdeContext *self)
diff --git a/src/libide/ide-object.c b/src/libide/ide-object.c
index 29890f7..bfd5b98 100644
--- a/src/libide/ide-object.c
+++ b/src/libide/ide-object.c
@@ -28,7 +28,7 @@
 /**
  * SECTION:ide-object
  * @title: IdeObject
- * @short_description: Base object for #IdeContext-related objects
+ * @short_description: Base object for #IdeContext related objects
  *
  * The #IdeObject abstract class provides a base class for ojects that are
  * related to #IdeContext. It provides easy access to the #IdeContext using
diff --git a/src/libide/langserv/ide-langserv-client.c b/src/libide/langserv/ide-langserv-client.c
index 3f4edb9..6e9b4c7 100644
--- a/src/libide/langserv/ide-langserv-client.c
+++ b/src/libide/langserv/ide-langserv-client.c
@@ -1237,7 +1237,7 @@ ide_langserv_client_get_diagnostics_async (IdeLangservClient   *self,
 
 /**
  * ide_langserv_client_get_diagnostics_finish:
- * @self: A #IdeLangservClient
+ * @self: an #IdeLangservClient
  * @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/langserv/ide-langserv-rename-provider.c 
b/src/libide/langserv/ide-langserv-rename-provider.c
index 00e0878..cef8ba2 100644
--- a/src/libide/langserv/ide-langserv-rename-provider.c
+++ b/src/libide/langserv/ide-langserv-rename-provider.c
@@ -354,7 +354,7 @@ rename_provider_iface_init (IdeRenameProviderInterface *iface)
 /**
  * ide_langserv_rename_provider_get_client:
  *
- * Returns: (transfer none) (nullable): A #IdeLangservClient or %NULL.
+ * Returns: (transfer none) (nullable): an #IdeLangservClient or %NULL.
  */
 IdeLangservClient *
 ide_langserv_rename_provider_get_client (IdeLangservRenameProvider *self)
diff --git a/src/libide/layout/ide-layout-grid.c b/src/libide/layout/ide-layout-grid.c
index b7542f3..943afec 100644
--- a/src/libide/layout/ide-layout-grid.c
+++ b/src/libide/layout/ide-layout-grid.c
@@ -508,7 +508,7 @@ ide_layout_grid_new (void)
  * Gets the most recently focused stack. This is useful when you want to open
  * a document on the stack the user last focused.
  *
- * Returns: (transfer none) (nullable): A #IdeLayoutStack or %NULL.
+ * Returns: (transfer none) (nullable): an #IdeLayoutStack or %NULL.
  *
  * Since: 3.26
  */
diff --git a/src/libide/layout/ide-layout-stack-addin.c b/src/libide/layout/ide-layout-stack-addin.c
index 8bbd94f..40e1a3a 100644
--- a/src/libide/layout/ide-layout-stack-addin.c
+++ b/src/libide/layout/ide-layout-stack-addin.c
@@ -102,7 +102,7 @@ ide_layout_stack_addin_unload (IdeLayoutStackAddin *self,
 
 /**
  * ide_layout_stack_addin_set_view:
- * @self: A #IdeLayoutStackAddin
+ * @self: an #IdeLayoutStackAddin
  * @view: (nullable): An #IdeLayoutView or %NULL.
  *
  * This virtual method is called whenever the active view changes
diff --git a/src/libide/layout/ide-layout-stack.c b/src/libide/layout/ide-layout-stack.c
index f7fcd58..659d0a6 100644
--- a/src/libide/layout/ide-layout-stack.c
+++ b/src/libide/layout/ide-layout-stack.c
@@ -1005,7 +1005,7 @@ ide_layout_stack_get_titlebar (IdeLayoutStack *self)
 
 /**
  * ide_layout_stack_get_has_view:
- * @self: A #IdeLayoutStack
+ * @self: an #IdeLayoutStack
  *
  * Gets the "has-view" property.
  *
diff --git a/src/libide/plugins/ide-extension-set-adapter.c b/src/libide/plugins/ide-extension-set-adapter.c
index d986302..fc2ee78 100644
--- a/src/libide/plugins/ide-extension-set-adapter.c
+++ b/src/libide/plugins/ide-extension-set-adapter.c
@@ -533,7 +533,7 @@ ide_extension_set_adapter_set_value (IdeExtensionSetAdapter *self,
 
 /**
  * ide_extension_set_adapter_foreach:
- * @self: A #IdeExtensionSetAdapter
+ * @self: an #IdeExtensionSetAdapter
  * @foreach_func: (scope call): A callback
  * @user_data: user data for @foreach_func
  *
diff --git a/src/libide/projects/ide-project-files.c b/src/libide/projects/ide-project-files.c
index 43142be..b18a751 100644
--- a/src/libide/projects/ide-project-files.c
+++ b/src/libide/projects/ide-project-files.c
@@ -98,7 +98,7 @@ ide_project_files_find_child (IdeProjectItem *item,
 
 /**
  * ide_project_files_find_file:
- * @self: (in): A #IdeProjectFiles.
+ * @self: (in): an #IdeProjectFiles.
  * @file: A #GFile.
  *
  * Tries to locate an #IdeProjectFile matching the given file.
diff --git a/src/libide/projects/ide-project-info.c b/src/libide/projects/ide-project-info.c
index 5bf70c8..f908fcb 100644
--- a/src/libide/projects/ide-project-info.c
+++ b/src/libide/projects/ide-project-info.c
@@ -146,7 +146,7 @@ ide_project_info_set_priority (IdeProjectInfo *self,
 
 /**
  * ide_project_info_get_directory:
- * @self: (in): A #IdeProjectInfo.
+ * @self: (in): an #IdeProjectInfo.
  *
  * Gets the #IdeProjectInfo:directory property.
  * This is the directory containing the project (if known).
@@ -163,7 +163,7 @@ ide_project_info_get_directory (IdeProjectInfo *self)
 
 /**
  * ide_project_info_get_file:
- * @self: (in): A #IdeProjectInfo.
+ * @self: (in): an #IdeProjectInfo.
  *
  * Gets the #IdeProjectInfo:file property.
  * This is the project file (such as configure.ac) of the project.
diff --git a/src/libide/projects/ide-project.c b/src/libide/projects/ide-project.c
index cfaee91..b34d336 100644
--- a/src/libide/projects/ide-project.c
+++ b/src/libide/projects/ide-project.c
@@ -188,7 +188,7 @@ ide_project_set_root (IdeProject     *self,
 
 /**
  * ide_project_get_files:
- * @self: A #IdeProject.
+ * @self: an #IdeProject.
  *
  * Gets the #IdeProjectFiles instance within the project tree.
  * If it has not yet been loaded, %NULL is returned.
@@ -284,7 +284,7 @@ ide_project_get_file_for_path (IdeProject  *self,
 
 /**
  * ide_project_get_project_file:
- * @self: A #IdeProject.
+ * @self: an #IdeProject.
  * @gfile: A #GFile.
  *
  * Gets a new #IdeFile representing @gfile.
diff --git a/src/libide/sourceview/ide-source-view.c b/src/libide/sourceview/ide-source-view.c
index 60590d6..db3081b 100644
--- a/src/libide/sourceview/ide-source-view.c
+++ b/src/libide/sourceview/ide-source-view.c
@@ -6126,7 +6126,7 @@ ide_source_view_class_init (IdeSourceViewClass *klass)
 
   /**
    * IdeSourceView:documentation-requested:
-   * @self: A #IdeSourceView
+   * @self: an #IdeSourceView
    * @word: the word that was requested
    *
    * This is emitted by the default request-documentation handler to
@@ -7811,7 +7811,7 @@ ide_source_view_set_enable_word_completion (IdeSourceView *self,
 
 /**
  * ide_source_view_get_file_settings:
- * @self: A #IdeSourceView.
+ * @self: an #IdeSourceView.
  *
  * Gets the #IdeSourceView:file-settings property. This contains various
  * settings for how the file should be rendered in the view, and preferences
diff --git a/src/libide/subprocess/ide-subprocess-launcher.c b/src/libide/subprocess/ide-subprocess-launcher.c
index 564bdab..018a290 100644
--- a/src/libide/subprocess/ide-subprocess-launcher.c
+++ b/src/libide/subprocess/ide-subprocess-launcher.c
@@ -684,7 +684,7 @@ ide_subprocess_launcher_push_argv (IdeSubprocessLauncher *self,
  *
  * Synchronously spawn a process using the internal state.
  *
- * Returns: (transfer full): A #IdeSubprocess or %NULL upon error.
+ * Returns: (transfer full): an #IdeSubprocess or %NULL upon error.
  */
 IdeSubprocess *
 ide_subprocess_launcher_spawn (IdeSubprocessLauncher  *self,
@@ -755,7 +755,7 @@ ide_subprocess_launcher_overlay_environment (IdeSubprocessLauncher *self,
 
 /**
  * ide_subprocess_launcher_push_args:
- * @self: A #IdeSubprocessLauncher
+ * @self: an #IdeSubprocessLauncher
  * @args: (array zero-terminated=1) (element-type utf8) (nullable): the arguments
  *
  * This function is semantically identical to calling ide_subprocess_launcher_push_argv()
diff --git a/src/libide/symbols/ide-code-indexer.c b/src/libide/symbols/ide-code-indexer.c
index e09d16c..81bc02d 100644
--- a/src/libide/symbols/ide-code-indexer.c
+++ b/src/libide/symbols/ide-code-indexer.c
@@ -83,7 +83,7 @@ ide_code_indexer_default_init (IdeCodeIndexerInterface *iface)
  * This function will take index source file and create an array
  * of symbols in @file.
  *
- * Returns: (transfer full) : A #IdeCodeIndexEntries contains list
+ * Returns: (transfer full) : an #IdeCodeIndexEntries contains list
  *    of #IdeCodeIndexEntry.
  *
  * Since: 3.26
diff --git a/src/libide/symbols/ide-symbol-resolver.c b/src/libide/symbols/ide-symbol-resolver.c
index 10dabf2..daa7379 100644
--- a/src/libide/symbols/ide-symbol-resolver.c
+++ b/src/libide/symbols/ide-symbol-resolver.c
@@ -185,7 +185,7 @@ ide_symbol_resolver_lookup_symbol_finish (IdeSymbolResolver  *self,
  * ide_symbol_resolver_get_symbol_tree_async:
  * @self: An #IdeSymbolResolver
  * @file: A #GFile
- * @buffer: A #IdeBuffer or %NULL
+ * @buffer: an #IdeBuffer or %NULL
  * @cancellable: (allow-none): a #GCancellable or %NULL.
  * @callback: (allow-none): a callback to execute upon completion
  * @user_data: user data for @callback
diff --git a/src/libide/symbols/ide-symbol-tree.c b/src/libide/symbols/ide-symbol-tree.c
index 1f3be7d..794be19 100644
--- a/src/libide/symbols/ide-symbol-tree.c
+++ b/src/libide/symbols/ide-symbol-tree.c
@@ -53,7 +53,7 @@ ide_symbol_tree_get_n_children (IdeSymbolTree *self,
  *
  * Gets the @nth child node of @node.
  *
- * Returns: (transfer full) (nullable): A #IdeSymbolNode or %NULL.
+ * Returns: (transfer full) (nullable): an #IdeSymbolNode or %NULL.
  */
 IdeSymbolNode *
 ide_symbol_tree_get_nth_child (IdeSymbolTree *self,
diff --git a/src/libide/workbench/ide-workbench-open.c b/src/libide/workbench/ide-workbench-open.c
index 6908739..b46cb69 100644
--- a/src/libide/workbench/ide-workbench-open.c
+++ b/src/libide/workbench/ide-workbench-open.c
@@ -362,7 +362,7 @@ ide_workbench_open_files_cb (GObject      *object,
  * @files: (array length=n_files): An array of #GFile objects to be opened.
  * @n_files: The number of files given.
  * @hint: The id of an #IdeWorkbenchAddin that should be preferred as a loader.
- * @flags: A #IdeWorkbenchOpenFlags (if WORKBENCH_OPEN_FLAGS_BG is set, the buffer is loaded
+ * @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
diff --git a/src/plugins/clang/ide-clang-completion-item.c b/src/plugins/clang/ide-clang-completion-item.c
index 885bac9..f50446d 100644
--- a/src/plugins/clang/ide-clang-completion-item.c
+++ b/src/plugins/clang/ide-clang-completion-item.c
@@ -433,7 +433,7 @@ ide_clang_completion_item_init (IdeClangCompletionItem *self)
 
 /**
  * ide_clang_completion_item_get_snippet:
- * @self: A #IdeClangCompletionItem.
+ * @self: an #IdeClangCompletionItem.
  *
  * Gets the #IdeSourceSnippet to be inserted when expanding this completion item.
  *
diff --git a/src/plugins/clang/ide-clang-service.c b/src/plugins/clang/ide-clang-service.c
index b71528a..51c7fc5 100644
--- a/src/plugins/clang/ide-clang-service.c
+++ b/src/plugins/clang/ide-clang-service.c
@@ -718,7 +718,7 @@ ide_clang_service_init (IdeClangService *self)
 
 /**
  * ide_clang_service_get_cached_translation_unit:
- * @self: A #IdeClangService.
+ * @self: an #IdeClangService.
  *
  * Gets a cached translation unit if one exists for the file.
  *
diff --git a/src/plugins/clang/ide-clang-symbol-tree.c b/src/plugins/clang/ide-clang-symbol-tree.c
index 1b4c3a9..8fe10b0 100644
--- a/src/plugins/clang/ide-clang-symbol-tree.c
+++ b/src/plugins/clang/ide-clang-symbol-tree.c
@@ -57,7 +57,7 @@ static GParamSpec *properties [LAST_PROP];
 
 /**
  * ide_clang_symbol_tree_get_file:
- * @self: A #IdeClangSymbolTree.
+ * @self: an #IdeClangSymbolTree.
  *
  * Gets the #IdeClangSymbolTree:file property.
  *
diff --git a/src/plugins/clang/ide-clang-translation-unit.c b/src/plugins/clang/ide-clang-translation-unit.c
index 7bb6520..fbcfac7 100644
--- a/src/plugins/clang/ide-clang-translation-unit.c
+++ b/src/plugins/clang/ide-clang-translation-unit.c
@@ -103,7 +103,7 @@ get_file_for_location (IdeClangTranslationUnit *self,
 
 /**
  * ide_clang_translation_unit_get_index:
- * @self: A #IdeClangTranslationUnit.
+ * @self: an #IdeClangTranslationUnit.
  *
  * Gets the highlight index for the translation unit.
  *
@@ -768,7 +768,7 @@ ide_clang_translation_unit_code_complete_async (IdeClangTranslationUnit *self,
 
 /**
  * ide_clang_translation_unit_code_complete_finish:
- * @self: A #IdeClangTranslationUnit.
+ * @self: an #IdeClangTranslationUnit.
  * @result: A #GAsyncResult
  * @error: (out) (nullable): A location for a #GError, or %NULL.
  *
diff --git a/src/plugins/command-bar/gb-command-provider.c b/src/plugins/command-bar/gb-command-provider.c
index b0fb145..e54c9b1 100644
--- a/src/plugins/command-bar/gb-command-provider.c
+++ b/src/plugins/command-bar/gb-command-provider.c
@@ -60,7 +60,7 @@ gb_command_provider_new (IdeWorkbench *workbench)
  * Returns the "active-tab" property. The active-tab is the last tab that
  * was focused in the workbench.
  *
- * Returns: (transfer none): A #IdeLayoutView or %NULL.
+ * Returns: (transfer none): an #IdeLayoutView or %NULL.
  */
 IdeLayoutView *
 gb_command_provider_get_active_view (GbCommandProvider *provider)
diff --git a/src/plugins/ctags/ide-ctags-index.c b/src/plugins/ctags/ide-ctags-index.c
index 5761d15..07c3220 100644
--- a/src/plugins/ctags/ide-ctags-index.c
+++ b/src/plugins/ctags/ide-ctags-index.c
@@ -641,7 +641,7 @@ ide_ctags_index_get_mtime (IdeCtagsIndex *self)
 
 /**
  * ide_ctags_index_find_with_path:
- * @self: A #IdeCtagsIndex
+ * @self: an #IdeCtagsIndex
  * @relative_path: A path relative to the indexes base_path.
  *
  * This will return a GPtrArray of #IdeCtagsIndex pointers. These
diff --git a/src/plugins/xml-pack/ide-xml-analysis.c b/src/plugins/xml-pack/ide-xml-analysis.c
index bd01280..33ca3f3 100644
--- a/src/plugins/xml-pack/ide-xml-analysis.c
+++ b/src/plugins/xml-pack/ide-xml-analysis.c
@@ -29,7 +29,7 @@ ide_xml_analysis_get_sequence (IdeXmlAnalysis *self)
 
 /**
  * ide_xml_analysis_get_diagnostics:
- * @self: A #IdeXmlAnalysis.
+ * @self: an #IdeXmlAnalysis.
  *
  * Returns: (nullable) (transfer none): The #IdeDiagnostics contained by the analysis.
  *
@@ -44,7 +44,7 @@ ide_xml_analysis_get_diagnostics (IdeXmlAnalysis *self)
 
 /**
  * ide_xml_analysis_get_diagnostics:
- * @self: A #IdeXmlAnalysis.
+ * @self: an #IdeXmlAnalysis.
  *
  * Returns: (nullable) (transfer none): The #IdeXmlSymbolNode root node 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 f4910e6..ab6659b 100644
--- a/src/plugins/xml-pack/ide-xml-service.c
+++ b/src/plugins/xml-pack/ide-xml-service.c
@@ -1167,7 +1167,7 @@ ide_xml_service_get_cached_root_node (IdeXmlService *self,
  *
  * Gets the #IdeDiagnostics for the corresponding file.
  *
- * Returns: (transfer NULL): A #IdeDiagnostics.
+ * Returns: (transfer NULL): an #IdeDiagnostics.
  */
 IdeDiagnostics *
 ide_xml_service_get_cached_diagnostics (IdeXmlService *self,
diff --git a/src/plugins/xml-pack/ide-xml-symbol-tree.c b/src/plugins/xml-pack/ide-xml-symbol-tree.c
index 32bc16b..668c64c 100644
--- a/src/plugins/xml-pack/ide-xml-symbol-tree.c
+++ b/src/plugins/xml-pack/ide-xml-symbol-tree.c
@@ -80,7 +80,7 @@ symbol_tree_iface_init (IdeSymbolTreeInterface *iface)
 
 /**
  * ide_xml_symbol_tree_new:
- * @root_node: A #IdeXmlSymbolNode
+ * @root_node: an #IdeXmlSymbolNode
  *
  * Create a new #IdeXmlSymbolTree
  *
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]