]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
URL-SYNTAX: update IDNA section for WHATWG spec changes
authorTimothy Gu <timothygu99@gmail.com>
Thu, 6 May 2021 18:22:57 +0000 (14:22 -0400)
committerDaniel Stenberg <daniel@haxx.se>
Thu, 6 May 2021 21:15:46 +0000 (23:15 +0200)
WHATWG URL has dictated the use of Nontransitional Processing (IDNA
2008) for several years now. Chrome (and derivatives) still use
Transitional Processing, but Firefox and Safari have both switched.

Also document the fact that winidn functions differently from libidn2
here.

Closes #7026

docs/URL-SYNTAX.md

index 348fbd9281c443cc84ffaf94644f81e08e1bbd52..ef4613383bb44ab7db9bda86377dcf649074fbc0 100644 (file)
@@ -173,10 +173,14 @@ brackets). For example:
 If curl was built with International Domain Name (IDN) support, it can also
 handle host names using non-ASCII characters.
 
-curl supports IDN host names using the IDNA 2008 standard. This differs from
-browsers that follow the WHATWG URL spec, which dictates IDNA 2003 to be used.
-The two standards have a huge overlap but differ slightly, perhaps most
-famously in how they deal with the German "double s" (`ß`).
+When built with libidn2, curl uses the IDNA 2008 standard. This is equivalent
+to the WHATWG URL spec, but differs from certain browsers that use IDNA 2003
+Transitional Processing. The two standards have a huge overlap but differ
+slightly, perhaps most famously in how they deal with the German "double s"
+(`ß`).
+
+When winidn is used, curl uses IDNA 2003 Transitional Processing, like the rest
+of Windows.
 
 ## Port number