diff --git a/libnm-core/nm-vpn-plugin-info.c b/libnm-core/nm-vpn-plugin-info.c
index 28f0f6927..6cd1eb8ca 100644
--- a/libnm-core/nm-vpn-plugin-info.c
+++ b/libnm-core/nm-vpn-plugin-info.c
@@ -302,8 +302,8 @@ _nm_vpn_plugin_info_list_load_dir (const char *dirname,
 /**
  * nm_vpn_plugin_info_list_load:
  *
- * Returns: (tranfer full): list of plugins loaded from the default
- * directories rejecting duplicates.
+ * Returns: (element-type NMVpnPluginInfo) (transfer full): list of plugins
+ * loaded from the default directories rejecting duplicates.
  *
  * Since: 1.2
  */
@@ -393,7 +393,7 @@ _check_no_conflict (NMVpnPluginInfo *i1, NMVpnPluginInfo *i2, GError **error)
 
 /**
  * nm_vpn_plugin_info_list_add:
- * @list: list of plugins
+ * @list: (element-type NMVpnPluginInfo): list of plugins
  * @plugin_info: instance to add
  * @error: failure reason
  *
@@ -437,7 +437,7 @@ nm_vpn_plugin_info_list_add (GSList **list, NMVpnPluginInfo *plugin_info, GError
 
 /**
  * nm_vpn_plugin_info_list_remove:
- * @list: list of plugins
+ * @list: (element-type NMVpnPluginInfo): list of plugins
  * @plugin_info: instance
  *
  * Remove @plugin_info from @list.
@@ -462,7 +462,7 @@ nm_vpn_plugin_info_list_remove (GSList **list, NMVpnPluginInfo *plugin_info)
 
 /**
  * nm_vpn_plugin_info_list_find_by_name:
- * @list: list of plugins
+ * @list: (element-type NMVpnPluginInfo): list of plugins
  * @name: name to search
  *
  * Returns: (transfer none): the first plugin with a matching @name (or %NULL).
@@ -486,7 +486,7 @@ nm_vpn_plugin_info_list_find_by_name (GSList *list, const char *name)
 
 /**
  * nm_vpn_plugin_info_list_find_by_filename:
- * @list: list of plugins
+ * @list: (element-type NMVpnPluginInfo): list of plugins
  * @filename: filename to search
  *
  * Returns: (transfer none): the first plugin with a matching @filename (or %NULL).
@@ -510,7 +510,7 @@ nm_vpn_plugin_info_list_find_by_filename (GSList *list, const char *filename)
 
 /**
  * nm_vpn_plugin_info_list_find_by_service:
- * @list: list of plugins
+ * @list: (element-type NMVpnPluginInfo): list of plugins
  * @service: service to search
  *
  * Returns: (transfer none): the first plugin with a matching @service (or %NULL).
diff --git a/libnm/nm-device.c b/libnm/nm-device.c
index bb4231ec5..18f669bf6 100644
--- a/libnm/nm-device.c
+++ b/libnm/nm-device.c
@@ -2565,7 +2565,7 @@ nm_lldp_neighbor_get_attr_string_value (NMLldpNeighbor *neighbor, char *name,
  * nm_lldp_neighbor_get_attr_uint_value:
  * @neighbor: the #NMLldpNeighbor
  * @name: the attribute name
- * @out_value: (out) (allow-none) on return, the attribute value
+ * @out_value: (out) (allow-none): on return, the attribute value
  *
  * Gets the uint value of attribute with name @name on @neighbor
  *
diff --git a/libnm/nm-vpn-service-plugin.c b/libnm/nm-vpn-service-plugin.c
index ed9141ea5..2945a4ea6 100644
--- a/libnm/nm-vpn-service-plugin.c
+++ b/libnm/nm-vpn-service-plugin.c
@@ -1184,9 +1184,9 @@ nm_vpn_service_plugin_class_init (NMVpnServicePluginClass *plugin_class)
 		                      G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * NMVpnServicePlugin:service-name:
+	 * NMVpnServicePlugin:watch-peer:
 	 *
-	 * The D-Bus service name of this plugin.
+	 * Whether to watch for D-Bus peer's changes.
 	 *
 	 * Since: 1.2
 	 */