From c903da9a67c4900c3113bd503c9fc3adaa85bb69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?P=C3=A9ter=20Dimitrov?= <peterdmv@erlang.org>
Date: Tue, 13 Feb 2018 15:48:09 +0100
Subject: stdlib: Update uri_string documentation (HTML 5.2)

- Original link to HTML 5.0 specification was broken as the
  document was moved when later revisions were released.
- Form-urlencoded query string handling conforms to the
  HTML 5.2 specification that references WHATWG URL
  (10 Jan 2018).
- HTML 5.2 does not specify handling of non-UTF-8
  form-urlencoded query strings, but it is still supported
  as described in HTML 5.0.

Change-Id: I44603bb501530b16651ecbb9a26ea64e119f83d9
---
 lib/stdlib/doc/src/uri_string.xml | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

(limited to 'lib/stdlib/doc')

diff --git a/lib/stdlib/doc/src/uri_string.xml b/lib/stdlib/doc/src/uri_string.xml
index 6b52ffdd4d..88d4600611 100644
--- a/lib/stdlib/doc/src/uri_string.xml
+++ b/lib/stdlib/doc/src/uri_string.xml
@@ -32,7 +32,11 @@
   <description>
     <p>This module contains functions for parsing and handling URIs
     (<url href="https://www.ietf.org/rfc/rfc3986.txt">RFC 3986</url>) and
-    form-urlencoded query strings (<url href="https://www.w3.org/TR/html5/forms.html">HTML5</url>).
+    form-urlencoded query strings (<url href="https://www.w3.org/TR/html52/">HTML 5.2</url>).
+    </p>
+    <p>
+    Parsing and serializing non-UTF-8 form-urlencoded query strings are also supported
+    (<url href="https://www.w3.org/TR/html50/">HTML 5.0</url>).
     </p>
     <p>A URI is an identifier consisting of a sequence of characters   matching the syntax
     rule named <em>URI</em> in <url href="https://www.ietf.org/rfc/rfc3986.txt">RFC 3986</url>.
@@ -152,8 +156,10 @@
         <p>Composes a form-urlencoded <c><anno>QueryString</anno></c> based on a
 	<c><anno>QueryList</anno></c>, a list of non-percent-encoded key-value pairs.
         Form-urlencoding is defined in section
-	4.10.22.6 of the <url href="https://www.w3.org/TR/html5/forms.html">HTML5</url>
-	specification.
+	4.10.21.6 of the <url href="https://www.w3.org/TR/html52/">HTML 5.2</url>
+	specification and in section 4.10.22.6 of the
+	<url href="https://www.w3.org/TR/html50/">HTML 5.0</url> specification for
+	non-UTF-8 encodings.
 	</p>
 	<p>See also the opposite operation <seealso marker="#dissect_query/1">
 	<c>dissect_query/1</c></seealso>.
@@ -210,12 +216,11 @@
         <p>Dissects an urlencoded <c><anno>QueryString</anno></c> and returns a
 	<c><anno>QueryList</anno></c>, a list of non-percent-encoded key-value pairs.
         Form-urlencoding is defined in section
-	4.10.22.6 of the <url href="https://www.w3.org/TR/html5/forms.html">HTML5</url>
-	specification.
+	4.10.21.6 of the <url href="https://www.w3.org/TR/html52/">HTML 5.2</url>
+	specification and in section 4.10.22.6 of the
+	<url href="https://www.w3.org/TR/html50/">HTML 5.0</url> specification for
+	non-UTF-8 encodings.
 	</p>
-	<p>It is not as strict for its input as the decoding algorithm defined by
-	<url href="https://www.w3.org/TR/html5/forms.html">HTML5</url>
-	and accepts all unicode characters.</p>
 	<p>See also the opposite operation <seealso marker="#compose_query/1">
 	<c>compose_query/1</c></seealso>.
 	</p>
-- 
cgit v1.2.3