luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-01-14 00:06:24 +01:00
Code Issues Packages Projects Releases Wiki Activity

uri: improve some documentation about absolute URIs

Browse Source 
As pointed out in the discussion
https://gitlab.gnome.org/GNOME/glib/-/issues/2169.

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
This commit is contained in:
Marc-André Lureau 2020-07-28 14:14:08 +04:00
parent 3521763532
commit 19c0db3185
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
glib/guri.c
View File

@ -965,7 +965,7 @@ g_uri_split_with_user (const gchar *uri_string,
/** /**
* g_uri_split_network: * g_uri_split_network:
* @uri_string: a string containing a relative or absolute URI * @uri_string: a string containing an absolute URI
* @flags: flags for parsing @uri_string * @flags: flags for parsing @uri_string
* @scheme: (out) (nullable) (optional) (transfer full): on return, contains * @scheme: (out) (nullable) (optional) (transfer full): on return, contains
* the scheme (converted to lowercase), or %NULL * the scheme (converted to lowercase), or %NULL
@ -1156,7 +1156,7 @@ g_uri_parse (const gchar *uri_string,
/** /**
* g_uri_parse_relative: * g_uri_parse_relative:
* @base_uri: (nullable): a base URI * @base_uri: (nullable): a base absolute URI
* @uri_string: a string representing a relative or absolute URI * @uri_string: a string representing a relative or absolute URI
* @flags: flags describing how to parse @uri_string * @flags: flags describing how to parse @uri_string
* @error: #GError for error reporting, or %NULL to ignore. * @error: #GError for error reporting, or %NULL to ignore.
@ -1446,13 +1446,13 @@ g_uri_join_internal (GUriFlags flags,
* @fragment: (nullable): the fragment, or %NULL * @fragment: (nullable): the fragment, or %NULL
* *
* Joins the given components together according to @flags to create * Joins the given components together according to @flags to create
* a complete URI string. At least @scheme must be specified, and * an absolute URI string. At least @scheme must be specified, and
* @path may not be %NULL (though it may be ""). * @path may not be %NULL (though it may be "").
* *
* See also g_uri_join_with_user(), which allows specifying the * See also g_uri_join_with_user(), which allows specifying the
* components of the "userinfo" separately. * components of the "userinfo" separately.
* *
* Return value: a URI string * Return value: an absolute URI string
* *
* Since: 2.66 * Since: 2.66
*/ */
@ -1496,13 +1496,13 @@ g_uri_join (GUriFlags flags,
* @fragment: (nullable): the fragment, or %NULL * @fragment: (nullable): the fragment, or %NULL
* *
* Joins the given components together according to @flags to create * Joins the given components together according to @flags to create
* a complete URI string. At least @scheme must be specified, and * an absolute URI string. At least @scheme must be specified, and
* @path may not be %NULL (though it may be ""). * @path may not be %NULL (though it may be "").
* *
* In constrast to g_uri_join(), this allows specifying the components * In constrast to g_uri_join(), this allows specifying the components
* of the "userinfo" separately. * of the "userinfo" separately.
* *
* Return value: a URI string * Return value: an absolute URI string
* *
* Since: 2.66 * Since: 2.66
*/ */