From a2d88583221a7ff84ab07ebc613281bdc2fccd85 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Thu, 29 Nov 2007 01:24:33 +0000 Subject: [PATCH] Some doc cleanups svn path=/trunk/; revision=5985 --- ChangeLog | 13 +++++++++++++ glib/gurifuncs.c | 8 +++++--- 2 files changed, 18 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 4b38bec57..c615eff13 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,16 @@ +2007-11-28 Matthias Clasen + + * glib/gurifuncs.c: Some doc cleanups + +2007-11-28 Matthias Clasen + + * glib/gtestutils.c: Fix up some doc comments, avoid C99 comments + + * glib/gconvert.c: De-doc-commentify static functions to + shut up gtk-doc. + + * glib/gutils.c: Fix the glib_gettext doc comment. + 2007-11-28 Tor Lillqvist * config.h.win32.in: Update to match what configure produces. diff --git a/glib/gurifuncs.c b/glib/gurifuncs.c index 731dc6d90..8b728c001 100644 --- a/glib/gurifuncs.c +++ b/glib/gurifuncs.c @@ -34,7 +34,6 @@ * defined by RFC 3986. It is highly recommended that you have read and * understand RFC 3986 for understanding this API. A copy of RFC 3986 * can be found at . - * **/ static int @@ -145,7 +144,9 @@ g_uri_unescape_string (const char *escaped_string, * @uri: a valid URI. * * Gets the scheme portion of a URI. RFC 3986 decodes the scheme as: + * * URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] + * * Common schemes include "file", "http", "svn+ssh", etc. * * Returns: The "Scheme" component of the URI, or %NULL on error. @@ -194,8 +195,9 @@ g_uri_get_scheme (const char *uri) /** * g_uri_escape_string: * @unescaped: the unescaped input string. - * @reserved_chars_allowed: a string of reserve characters allowed to be used. - * @allow_utf8: a #gboolean. Set to %TRUE if string can include UTF8 characters. + * @reserved_chars_allowed: a string of reserved characters that are + * allowed to be used. + * @allow_utf8: %TRUE if the result can include UTF-8 characters. * * Escapes a string for use in a URI. * -- 2.34.1