diff --git a/girepository/giconstantinfo.c b/girepository/giconstantinfo.c
index c082303..98787f2 100644
--- a/girepository/giconstantinfo.c
+++ b/girepository/giconstantinfo.c
@@ -69,7 +69,7 @@ g_constant_info_get_type (GIConstantInfo *info)
         memcpy((dest_addr), (src_addr), sizeof(type))
 
 /**
- * g_constant_info_get_value: (skip)
+ * g_constant_info_get_value:
  * @info: a #GIConstantInfo
  * @value: (out): an argument
  *
diff --git a/girepository/girepository.c b/girepository/girepository.c
index f7f55e5..889821e 100644
--- a/girepository/girepository.c
+++ b/girepository/girepository.c
@@ -691,7 +691,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)
diff --git a/girepository/gitypes.h b/girepository/gitypes.h
index d15b121..57d9ef6 100644
--- a/girepository/gitypes.h
+++ b/girepository/gitypes.h
@@ -164,7 +164,12 @@ typedef GIBaseInfo GIErrorDomainInfo;
  */
 typedef struct _GIUnresolvedInfo GIUnresolvedInfo;
 
-union _GIArgument
+/**
+ * GIArgument:
+ *
+ * Stores an argument of varying type
+ */
+typedef union 
 {
   gboolean v_boolean;
   gint8    v_int8;
@@ -187,8 +192,9 @@ union _GIArgument
   gsize    v_size;
   gchar *  v_string;
   gpointer v_pointer;
-};
-typedef union _GIArgument GIArgument;
+} GIArgument;
+
+
 
 /**
  * GIInfoType:
