From 3b3f108dfd77f859932385f11814b19bea65a893 Mon Sep 17 00:00:00 2001 From: Dan Williams Date: Wed, 20 Jan 2016 11:25:37 -0600 Subject: [PATCH] docs, trivial: fix some documentation issues --- libnm-core/nm-setting-olpc-mesh.c | 1 + libnm-core/nm-vpn-editor-plugin.c | 11 +++++++++-- libnm/nm-vpn-editor.c | 1 + 3 files changed, 11 insertions(+), 2 deletions(-) diff --git a/libnm-core/nm-setting-olpc-mesh.c b/libnm-core/nm-setting-olpc-mesh.c index 4b42c36563..e61e31684f 100644 --- a/libnm-core/nm-setting-olpc-mesh.c +++ b/libnm-core/nm-setting-olpc-mesh.c @@ -79,6 +79,7 @@ nm_setting_olpc_mesh_init (NMSettingOlpcMesh *setting) /** * nm_setting_olpc_mesh_get_ssid: + * @setting: the #NMSettingOlpcMesh * * Returns: (transfer none): */ diff --git a/libnm-core/nm-vpn-editor-plugin.c b/libnm-core/nm-vpn-editor-plugin.c index 2d4fdf9c98..e97c4beba1 100644 --- a/libnm-core/nm-vpn-editor-plugin.c +++ b/libnm-core/nm-vpn-editor-plugin.c @@ -209,8 +209,11 @@ nm_vpn_editor_plugin_load_from_file (const char *plugin_filename, /** * nm_vpn_editor_plugin_get_editor: + * @plugin: the #NMVpnEditorPlugin + * @connection: the #NMConnection to be edited + * @error: on return, an error or %NULL * - * Returns: (transfer full): + * Returns: (transfer full): a new #NMVpnEditor or %NULL on error */ NMVpnEditor * nm_vpn_editor_plugin_get_editor (NMVpnEditorPlugin *plugin, @@ -232,8 +235,12 @@ nm_vpn_editor_plugin_get_capabilities (NMVpnEditorPlugin *plugin) /** * nm_vpn_editor_plugin_import: + * @plugin: the #NMVpnEditorPlugin + * @path: full path to the file to attempt to read into a new #NMConnection + * @error: on return, an error or %NULL * - * Returns: (transfer full): + * Returns: (transfer full): a new #NMConnection imported from @path, or %NULL + * on error or if the file at @path was not recognized by this plugin */ NMConnection * nm_vpn_editor_plugin_import (NMVpnEditorPlugin *plugin, diff --git a/libnm/nm-vpn-editor.c b/libnm/nm-vpn-editor.c index ba6bd5e03c..da81d605ea 100644 --- a/libnm/nm-vpn-editor.c +++ b/libnm/nm-vpn-editor.c @@ -44,6 +44,7 @@ nm_vpn_editor_default_init (NMVpnEditorInterface *iface) /** * nm_vpn_editor_get_widget: + * @editor: the #NMVpnEditor * * Returns: (transfer none): */