Add annotations for g_filename_from_uri()
authorVincent Untz <vuntz@gnome.org>
Tue, 27 Mar 2012 14:52:24 +0000 (16:52 +0200)
committerColin Walters <walters@verbum.org>
Tue, 30 Oct 2012 13:27:20 +0000 (09:27 -0400)
https://bugzilla.gnome.org/show_bug.cgi?id=672924

glib/gconvert.c

index bbc15bb..ae25a32 100644 (file)
@@ -1834,7 +1834,7 @@ hostname_validate (const char *hostname)
 /**
  * g_filename_from_uri:
  * @uri: a uri describing a filename (escaped, encoded in ASCII).
- * @hostname: (allow-none): Location to store hostname for the URI, or %NULL.
+ * @hostname: (out) (allow-none): Location to store hostname for the URI, or %NULL.
  *            If there is no hostname in the URI, %NULL will be
  *            stored in this location.
  * @error: location to store the error occurring, or %NULL to ignore
@@ -1843,8 +1843,8 @@ hostname_validate (const char *hostname)
  * Converts an escaped ASCII-encoded URI to a local filename in the
  * encoding used for filenames. 
  * 
- * Return value: a newly-allocated string holding the resulting
- *               filename, or %NULL on an error.
+ * Return value: (type filename): a newly-allocated string holding
+ *               the resulting filename, or %NULL on an error.
  **/
 gchar *
 g_filename_from_uri (const gchar *uri,