agent: Expand documentation for nice_interfaces_get_ip_for_interface()
authorPhilip Withnall <philip.withnall@collabora.co.uk>
Fri, 18 Jul 2014 07:44:41 +0000 (08:44 +0100)
committerOlivier CrĂȘte <olivier.crete@collabora.com>
Fri, 8 Aug 2014 19:52:45 +0000 (15:52 -0400)
agent/interfaces.h

index e5fea18..cb76626 100644 (file)
@@ -45,9 +45,11 @@ G_BEGIN_DECLS
  * nice_interfaces_get_ip_for_interface:
  * @interface_name: name of local interface
  *
- * Retreives the IPv4 address of an interface by its name
+ * Retrieves the IP address of an interface by its name. If this fails, %NULL
+ * is returned.
  *
- * Returns: a newly-allocated string with the IP address
+ * Returns: (nullable) (transfer full): a newly-allocated string with the IP
+ * address
  */
 gchar * nice_interfaces_get_ip_for_interface (gchar *interface_name);