Fix malformed GTK-Doc comment blocks:

- add missing colons
- invalid annotations
- invalid parameters and tags
- correct parameter name
- preserve description indentation
- no description parts
- comment end marker
- invalid empty lines
- line numbers

AnnotationParser now emits warnings which are considered as
errors by "make check" so fix those warnings...

https://bugzilla.gnome.org/show_bug.cgi?id=672254

3 files changed, 5 insertions, 5 deletions

diff --git a/girepository/girepository.c b/girepository/girepository.c
index 1384c0e9..bcc4a1b4 100644
--- a/girepository/girepository.c
+++ b/girepository/girepository.c
@@ -809,7 +809,7 @@ collect_namespaces (gpointer key,
  *
  * Return the list of currently loaded namespaces.
  *
- * Returns: (utf8) (transfer full): List of namespaces
+ * Returns: (element-type utf8) (transfer full): List of namespaces
  */
 gchar **
 g_irepository_get_loaded_namespaces (GIRepository *repository)
@@ -902,7 +902,7 @@ g_irepository_get_shared_library (GIRepository *repository,
 }
 
 /**
- * g_irepository_get_c_prefix
+ * g_irepository_get_c_prefix:
  * @repository: (allow-none): A #GIRepository, may be %NULL for the default
  * @namespace_: Namespace to inspect
  *
@@ -938,7 +938,7 @@ g_irepository_get_c_prefix (GIRepository *repository,
 }
 
 /**
- * g_irepository_get_typelib_path
+ * g_irepository_get_typelib_path:
  * @repository: (allow-none): Repository, may be %NULL for the default
  * @namespace_: GI namespace to use, e.g. "Gtk"
  *
diff --git a/girepository/girepository.h b/girepository/girepository.h
index 02bd4a10..eb990a27 100644
--- a/girepository/girepository.h
+++ b/girepository/girepository.h
@@ -74,7 +74,7 @@ struct _GIRepositoryClass
 };
 
 /**
- * GIRepositoryLoadFlags
+ * GIRepositoryLoadFlags:
  * @G_IREPOSITORY_LOAD_FLAG_LAZY: Load the types lazily.
  *
  * Flags that controlls how a typelib is loaded by
diff --git a/girepository/gitypes.h b/girepository/gitypes.h
index 486f20aa..88181b28 100644
--- a/girepository/gitypes.h
+++ b/girepository/gitypes.h
@@ -117,7 +117,7 @@ typedef GIBaseInfo GIValueInfo;
 typedef GIBaseInfo GISignalInfo;
 
 /**
- * GIVFuncInfo
+ * GIVFuncInfo:
  *
  * Represents a virtual function.
  */