[glib/wip/tingping/guri-normalize: 2/2] docs: Add note about uri normalization for equality




commit aa5489fcd1e924ba42a937051632fa230cc7966a
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 d78503a6c..1262eac14 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]