From ef0dbc4f2a43d629d086c3e2b9a762bbc00d034b Mon Sep 17 00:00:00 2001
From: Hans Bolinder <hasse@erlang.org>
Date: Wed, 19 Apr 2017 16:10:15 +0200
Subject: stdlib: Add Unicode modifier t to control sequences w and W

As of the introduction of Unicode characters in atoms, the control
sequences 'w' and 'W' can return non-Latin-1 characters, unless some
measure is taken.

This commit makes sure that '~w' and '~W' always return Latin-1
characters, or bytes, which can be output to ports or written to raw
files.

The Unicode translation modifier 't' is needed to return non-Latin-1
characters.
---
 lib/stdlib/doc/src/io.xml     | 4 +++-
 lib/stdlib/doc/src/io_lib.xml | 3 ++-
 2 files changed, 5 insertions(+), 2 deletions(-)

(limited to 'lib/stdlib/doc/src')

diff --git a/lib/stdlib/doc/src/io.xml b/lib/stdlib/doc/src/io.xml
index 11a64c7f8a..74b57457ea 100644
--- a/lib/stdlib/doc/src/io.xml
+++ b/lib/stdlib/doc/src/io.xml
@@ -4,7 +4,7 @@
 <erlref>
   <header>
     <copyright>
-      <year>1996</year><year>2016</year>
+      <year>1996</year><year>2017</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -265,6 +265,8 @@ ok
             <p>Writes data with the standard syntax. This is used to
               output Erlang terms. Atoms are printed within quotes if
               they contain embedded non-printable characters.
+	      Atom characters &gt; 255 are escaped unless the
+	      Unicode translation modifier (<c>t</c>) is used.
               Floats are printed accurately as the shortest, correctly
               rounded string.</p>
           </item>
diff --git a/lib/stdlib/doc/src/io_lib.xml b/lib/stdlib/doc/src/io_lib.xml
index 5ae400da62..bc1d77ac83 100644
--- a/lib/stdlib/doc/src/io_lib.xml
+++ b/lib/stdlib/doc/src/io_lib.xml
@@ -356,7 +356,8 @@
 
     <func>
       <name name="write" arity="1"/>
-      <name name="write" arity="2"/>
+      <name name="write" arity="2" clause_i="1"/>
+      <name name="write" arity="2" clause_i="2"/>
       <fsummary>Write a term.</fsummary>
       <desc>
         <p>Returns a character list that represents <c><anno>Term</anno></c>.
-- 
cgit v1.2.3