From: Alexander Larsson Date: Mon, 14 Jan 2008 14:39:28 +0000 (+0000) Subject: Clarify docs for g_uri_escape_string (#508773) X-Git-Tag: GLIB_2_15_2~6 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f879f67a81a28626188a03a6d6735ac629a07c1b;p=platform%2Fupstream%2Fglib.git Clarify docs for g_uri_escape_string (#508773) 2008-01-14 Alexander Larsson * glib/gurifuncs.c: Clarify docs for g_uri_escape_string (#508773) svn path=/trunk/; revision=6304 --- diff --git a/ChangeLog b/ChangeLog index f0204cb..7aede89 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2008-01-14 Alexander Larsson + + * glib/gurifuncs.c: + Clarify docs for g_uri_escape_string (#508773) + 2008-01-12 Andre Klapper * configure.in: ALL_LINGUAS: remove line breaks from previous diff --git a/glib/gurifuncs.c b/glib/gurifuncs.c index 8b728c0..0af480b 100644 --- a/glib/gurifuncs.c +++ b/glib/gurifuncs.c @@ -200,6 +200,13 @@ g_uri_get_scheme (const char *uri) * @allow_utf8: %TRUE if the result can include UTF-8 characters. * * Escapes a string for use in a URI. + * + * Normally all characters that are not "unreserved" (i.e. ASCII alphanumerical + * characters plus dash, dot, underscore and tilde) are escaped. + * But if you specify characters in @reserved_chars_allowed they are not + * escaped. This is useful for the "reserved" characters in the URI + * specification, since those are allowed unescaped in some portions of + * a URI. * * Returns: an escaped version of @unescaped. The returned string should be * freed when no longer needed.