[glib/wip/tingping/guri-normalize: 2/2] docs: Add note about uri normalization for equality
- From: Patrick Griffis <pgriffis src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib/wip/tingping/guri-normalize: 2/2] docs: Add note about uri normalization for equality
- Date: Mon, 26 Oct 2020 19:34:48 +0000 (UTC)
commit e01fb7c7ce393d7ad224379195d8757c52b5c116
Author: Patrick Griffis <pgriffis igalia com>
Date: Mon Oct 26 14:33:44 2020 -0500
docs: Add note about uri normalization for equality
glib/guri.c | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
---
diff --git a/glib/guri.c b/glib/guri.c
index 684e79dfc..981702a9b 100644
--- a/glib/guri.c
+++ b/glib/guri.c
@@ -132,11 +132,12 @@
*
* Note that there is no `g_uri_equal ()` function, because comparing
* URIs usefully requires scheme-specific knowledge that #GUri does
- * not have. For example, `http://example.com/` and
- * `http://EXAMPLE.COM:80` have exactly the same meaning according
- * to the HTTP specification, and `data:,foo` and
- * `data:;base64,Zm9v` resolve to the same thing according to the
- * `data:` URI specification.
+ * not have. #GUri can help with normalization if you use the various
+ * encoded #GUriFlags as well as %G_URI_FLAGS_SCHEME_NORMALIZE however
+ * it is not comprehensive.
+ * For example, `data:,foo` and `data:;base64,Zm9v` resolve to the same
+ * thing according to the `data:` URI specification which GLib does not
+ * handle.
*
* Since: 2.66
*/
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]