[glib: 2/13] uri: improve some documentation about absolute URIs




commit 19c0db318539bad6310075eeee08f57476daa934
Author: Marc-André Lureau <marcandre lureau redhat com>
Date:   Tue Jul 28 14:14:08 2020 +0400

    uri: improve some documentation about absolute URIs
    
    As pointed out in the discussion
    https://gitlab.gnome.org/GNOME/glib/-/issues/2169.
    
    Signed-off-by: Marc-André Lureau <marcandre lureau redhat com>

 glib/guri.c | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)
---
diff --git a/glib/guri.c b/glib/guri.c
index 1b1c3ef66..06f930dc2 100644
--- a/glib/guri.c
+++ b/glib/guri.c
@@ -965,7 +965,7 @@ g_uri_split_with_user (const gchar  *uri_string,
 
 /**
  * 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
  * @scheme: (out) (nullable) (optional) (transfer full): on return, contains
  *    the scheme (converted to lowercase), or %NULL
@@ -1156,7 +1156,7 @@ g_uri_parse (const gchar  *uri_string,
 
 /**
  * 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
  * @flags: flags describing how to parse @uri_string
  * @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
  *
  * 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 "").
  *
  * See also g_uri_join_with_user(), which allows specifying the
  * components of the "userinfo" separately.
  *
- * Return value: a URI string
+ * Return value: an absolute URI string
  *
  * Since: 2.66
  */
@@ -1496,13 +1496,13 @@ g_uri_join (GUriFlags    flags,
  * @fragment: (nullable): the fragment, or %NULL
  *
  * 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 "").
  *
  * In constrast to g_uri_join(), this allows specifying the components
  * of the "userinfo" separately.
  *
- * Return value: a URI string
+ * Return value: an absolute URI string
  *
  * Since: 2.66
  */


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]